Options; Library Search Options; Option Flags - Texas Instruments TI-89 Software Manual

300
4.3.

Options

This section describes the various library search options and command line flags
available for applications developers.
Typically, the TI FLASH Studio™ will handle all invocations of the linker, using
the correct command line flags required to produce TI-89 / TI-92 Plus apps or
ASMs. The following discussion of command line format and flags is included for
developers who may wish to use link68 directly from the command line or create
their own makefile.
4.3.1.

Library Search Options

The linker provides the -l flag for loading standard library files. The linker
searches for the specified library in the directories specified by the environment
(e.g., sierra/lib) and the -L flag. The library name searched for is created by
prefixing the string that follows the -l flag with lib and suffixing it with .68. For
example, given -l xyz the library libxyz.68 will be searched for. The linker
examines each directory on its list of standard library directories and if it finds
the library in one of them, it stops searching and processes the library as
already described. Note that the -l flag is not required to specify a library file,
the full pathname of the library can also be specified.
The -L flag adds a directory to the linker's library search path (used with the -l
flag). The directories specified with the -L flag are searched in the order in
which they appear in the command input. The remaining directories in the library
search path are obtained from the program's environment as follows. If the
environment variable LIB68 is defined, each of the directories it specifies is
added to the search path. Otherwise, if the SIERRA environment variable is
defined, the directory it specifies (suffixed with /lib) is added to the search path.
The directories specified with the -L flag are searched before those specified by
the environment.
Texas Instruments provides only one library file, libams.68. Many functions
previously included in the Sierra C library files have been rewritten as part of the
calculator operating system and are accessed through the jump table instead. No
other library file is required to create apps or ASMs for use on the TI-89 or
TI-92 Plus.
4.3.2.

Option Flags

A sample invocation of the linker is included with the files supplied with the
TI-89 / TI-92 Plus SDK. It is strongly recommended that you use the linker only
as shown in those examples. The following option flags can also be included on
the command line if desired. Whitespace is optional between a flag and any
TI-89 / TI-92 Plus Sierra C Assembler Reference Manual Not for Distribution
Section 4: Linker
Beta Version February 2, 2001