SYNTAX

MakeStub file1 [file2]… [-arch fat | m68k | pwpc] [-c creator] [-d]
[-fragname name] [-mf | -nomf] [-o outputFile] [-p] [-t type]
[-vercur number] [-verdef number] [-verimp number] [-w[arn]]
[-weakstub on | off]

DESCRIPTION

MakeStub creates a PowerPC, CFM-68K or "fat" stub library. A stub library is an import library that exports symbols but does not contain any code. Stub libraries are used when linking PowerPC and CFM-68K runtime applications and shared libraries.

INPUT

One or more text files containing the names of symbols to be exported from the stub library. The file(s) should contain one symbol name per line. Lines beginning with '#' or '*' are treated as comment lines. Comment lines of the form "#{code}" and "#{data}" are used to indicate whether the symbol names that follow the comment line are code exports or data exports. By default, symbol names are treated as code exports.

Note
C++ users must specify the mangled symbol names in the file. •

OUTPUT

A PowerPC, CFM-68K or "fat" stub library. The default output file name is MakeStub.out. You can rename the output file by using the -o option.

STATUS

MakeStub can return the following status codes:

PARAMETERS

file1 [file2]…

Specifies one or more text files containing the names of symbols to be exported from the stub library.

OPTIONS

-arch fat | m68k | pwpc

Controls whether MakeStub generates a PowerPC, CFM-68K or "fat" stub library.

fat

Generates a "fat" stub library.

m68k

Generates a CFM-68K stub library.

pwpc

Generates a PowerPC stub library.

-c creator

Sets the output file creator to creator. The default creator is 'MPS '.

-d

Suppresses warning messages for duplicate symbols.

-fragname name

Sets the fragment name to the specified name. The default is to use the name of the output file minus any directory information. The fragment name is stored in the stub library's 'cfrg' resource.

-mf | -nomf

Enables or suppresses the use of Process Manager temporary memory.

WARNING
If MakeStub aborts abnormally, that is, there is a crash or a nonmaskable interrupt (NMI), much of the Process Manager temporary memory might be left permanently allocated, thus potentially crippling launches and Finder copy operations. The only way to recover from this situation is to restart the computer. •

-o outputFile

Specifies the name of the output file. The default output file name is MakeStub.out.

-p

Writes progress and summary information to diagnostic output.

-t type

Sets the output file type to type. The default type is 'stub'.

-vercur number

Sets the library's "current version" to the specified version number. The default version number is 0. The "current version" is stored in the stub library's PEF container as well as in the 'cfrg' resource.

-verdef number

Sets the library's "definition version" to the specified version number. The default version number is 0. The "definition version" is stored in the stub library's PEF container as well as in the 'cfrg' resource.

-verimp number

Sets the library's "implementation version" to the specified version number. The default version number is 0. The "implementation version" is stored in the stub library's PEF container.

-w[arn]

Suppresses the display of warning messages.

-weakstub on | off

Specifies whether the library's "usage" type should be set to kStubLibraryCFrag (0x03) or kWeakStubLibraryCFrag (0x04).

on

Sets the library's "usage" type to kWeakStubLibraryCFrag (0x04).

off

Sets the library's "usage" type to kStubLibraryCFrag (0x03).

SEE ALSO

shlb2stub