mkpef(1) Tenon Development Tools mkpef(1)

NAME
mkpef - Make PowerPC Executable Format (PEF)

SYNOPSIS
mkpef input_file output_file
[-nostdl] [-stack stack size] [-fragname fragment
name] [-delete]
[-defver old default version] [-curver current
version] [-implver implementation version]
[-init init routine] [-term termination routine]
[-entry entry point routine]
[-textshare text share type] [-datashare data share
type] [-file_creat macintosh creator]
[-file_type macintosh type] [-sharedlibrary]
[-autoxoff] [-autoxon] [-plugin]
[-I libname:file=container]

DESCRIPTION
mkpef translates the XCOFF formated input file into Apple
standard PowerPC Executable Format (PEF). This applica-
tion is typically used automatically as the last step in
the execution of the ld application.

The PEF binary format is used by Power Macintosh computers
to define an application program, a shared library or plu-
gin module.

This application creates PEF formated files based on the
version 1.4 PEF standard January 25, 1993.

OPTIONS
The plethora of command-line options may seem intimidat-
ing, but in actual practice few of them are used in any
particular context. For instance, a frequent use of mkpef
is to translate an input file to an output file specifying
an entry point:

mkpef -entry __start intput output

This tells mkpef to produce a file called output from in-
put and set the entry point to a symbol named __start.

The command-line options to mkpef may be specified in any
order.

Option arguments must either follow the option letter
without intervening whitespace, or be given as separate
arguments immediately following the option that requires
them.

input_file output_file...
The input and output file names.

-nostdl
Directs mkpef to disable the standard set of lib-
name:file to container translations. See -autoxoff
for the list of automatic translations.

-stack stack size
Directs mkpef to set the stack size for the exe-
cutable image to stack size.

-fragname fragname
Directs mkpef to set the name of the fragment in
the PEF container to fragname.

-delete
Deletes the input file when processing completes.

-defver def version
Directs mkpef to set the PEF old default version
to def version.

-curver cur version
Directs mkpef to set the PEF current implementa-
tion version to cur version.

-implver impl version
Directs mkpef to set the PEF implmentation version
to impl version.

-init init routine
Directs mkpef to set the PEF initialization rou-
tine to init routine.

-term term routine
Directs mkpef to set the PEF termination routine
to term routine.

-entry entry routine
Directs mkpef to set the PEF entry point to entry
routine.

-text_share textsharetype
Directs mkpef to set the PEF sharing mode for the
text section to textsharetype.

-data_share datasharetype
Directs mkpef to set the PEF sharing mode for the
data section to datasharetype.

-file_creat macintosh creator
Directs mkpef to set the Macintosh file creator to
macintosh creator.

-file_type macintosh type
Directs mkpef to set the Macintosh file type to
macintosh type.

-sharedlibrary
Directs mkpef to make the output file a shared li-
brary for use by other applications.

-autoxoff
Directs mkpef to turn off the automatic translation
of a set of XCOFF library and filename combinations
to a common set of container names. The standard
set of automatic translations are:
libc.a:shr.o -> libc
libcurses.a:shr.o -> libcurses
libedit.a:shr.o -> libedit
libm.a:shr.o -> libm
libterm.a:shr.o -> libterm
libtermcap.a:shr.o -> libterm
libtermlib.a:shr.o -> libterm
libutil.a:shr.o -> libutil

The -I command can be used to specify other trans-
lations. the -autoxon can be used to turn automat-
ic translation on.

-autoxon
Directs mkpef to turn on automatic translation of
XCOFF library and filename combinations to a common
set of PEF container names. See -autoxoff also.

-plugin
Directs mkpef to create the output file as a PEF
plugin type file.

-I libname:file=container
Directs mkpef to automatically translate XCOFF
references to libname and file to the PEF container
name container .

SEE ALSO
PEF - PowerPC Executable Format Reference Specification
Apple Computer
20525 Mariani Ave
Cupertino, CA. 95014
Version 1.4

Tenon Intersystems 18 August 1995 3