SYNTAX

ILinkToSYM stateFile [-c[sym] creator] [-mf | -nomf] [-o outputFile]
[-p] [-pg pageSize] [-sym on | 3.2 | 3.4 | 3.5]

DESCRIPTION

You use the ILinkToSYM tool to generate a symbolic information file. This tool uses both the ILink state file (filename.NJ) and the object files used in the link to generate a symbolic information file with the default name of filename.SYM. Use this tool if you are

• performing symbolic debugging using SADE (versions 1.3.3 and 1.4a3, or earlier)

• using SourceBug (version 1.0.1)

• using the Proff.o library and the PrintProff tool

• executing any other program that requires a symbolic information file

INPUT

A state file (filename.NJ) generated by the ILink tool. ILinkToSYM does not accept standard input.

OUTPUT

A symbolic information file (filename.SYM)

STATUS

ILinkToSYM can return the following status codes:

PARAMETERS

stateFile

Specifies a state file generated by the ILink tool

OPTIONS

-c[sym] creator

Sets the output file creator to creator. Normally, the creator is set to 'Alar'.

-mf | -nomf

Enables or suppresses the use of Process Manager temporary memory.

Note that the ILinkToSYM tool's use of Process Manager temporary memory excludes other applications from using it, including the Finder. If temporary memory is unavailable, this option has no effect.

WARNING
If ILinkToSYM 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

Places the symbolic information in the specified file. If you do not specify -o, the default output filename is the same as the state file name but with the extension of .SYM.

-p

Writes progress and summary information to diagnostic output.

-pg pageSize

Sets the page size of the symbolic information file to pagesize bytes. The default page size is 4096 bytes. The page size must be a multiple of 512 bytes and be no smaller than 1024 (1K) bytes.

-sym on | 3.2 | 3.4 | 3.5

Controls which SYM file format is generated.

on

Generates the latest (currently 3.5) SYM file format (the default).

3.2

Generates the 3.2 SYM file format.

3.4

Generates the 3.4 SYM file format.

3.5

Generates the 3.5 SYM file format.

EXAMPLES

Assume you have just linked an application named Gus with the ILink tool. You can enter the following command to create a symbolic information file named Gus.SYM.

ILinkToSYM Gus.NJ

SEE ALSO

ILink