3.02;bind (bind), revision 3.02, 83/10/10
BIND -- Combine object modules into an executable file.
usage: BIND [pathname [pathname ...]] [-ALLMARK] [-ALLUNMARK] [-B pathname]
[-END] [-EXACTCASE] [-GLO] [-H] [-LOOKS name] [-LOOKS -ALL] [-MAP]
[-MARK global_name] [-MARK -ALL] [-MARKS name] [-MARKS -ALL]
[-MOD name] [-NOEXACTCASE] [-NOLOOKS name] [-NOLOOKS -ALL] [-Q]
[-READONLY name] [-SEC] [-SORTL] [-SORTN] [-SYS] [-UND]
[-UNMARK global_name] [-UNMARK -ALL] [-UNMARKS name] [-UNMARKS -ALL]
[-] {CL}
FORMAT
BIND [[pathname] [option] ...] [-]
The binder combines two or more object modules into one executable object
module. It resolves all references to global symbols and combines sections
that have the same name. THe binder produces one object module file and a
map file.
COMMAND LINE SUMMARY (Complete descriptions follow.)
pathname [pathname ...] One or more input object files to be bound.
-ALLMARK Begin marking all defined globals.
-ALLUNMARK (D) Revert to not marking defined globals.
-B[INARY] pathname Specify path name of the binary output file.
-END End of commands (same as blank line).
-EXACTCASE Set binder to be case sensitive on all names.
-GLO[BALS] Print currently defined globals.
-H[ELP] Print this list of commands.
-LOOKS[ECTION] name Set "look at installed sections" attribute on
named data section.
-LOOKS[ECTION] -ALL Set "look at installed sections" attribute on all
subsequent data sections.
-MAP Send complete map to std output.
-MARK <global> Mark named global.
-MARK -ALL Same as "-ALLMARK".
-MARKS[ECTION] name Mark named data section for installing.
-MARKS[ECTION] -ALL Mark all subsequent data sections for installing.
-MOD[ULE] name Name the output module.
-NOEXACTCASE (D) Set binder to ignore case differences on names.
-NOLOOKS[ECTION] name Remove "look at installed sections" attribute from
named data section.
-NOLOOKS[ECTION] -ALL (D) Stop setting "look at installed sections" attribute
on all data sections (default).
-Q[UIT] Exit from Binder without finishing.
-READONLY[SECTION] name Changes named section from read/write to read-only
-SEC[TIONS] Print current section definitions.
-SORTL[OCATION] Sort globals by location.
-SORTN[AMES] (D) Sort globals by name (default).
-SYS[TEM] Make system globals visible.
-UND[EFINED] Print currently undefined globals.
-UNMARK global Remove mark from named global.
-UNMARK -ALL Same as "-ALLUNMARK".
-UNMARKS[ECTION] name Remove installing mark from named data section.
-UNMARKS[ECTION] -ALL (D) Stop marking all data sections for installing.
- (hyphen) Prompt for further arguments.
FULL DESCRIPTIONS
ARGUMENTS
BIND specified without arguments will cause prompting for required information.
pathname ...
(optional) Specify one or more input files to be bound into the object
module. Multiple pathnames and wildcarding are permitted.
Default if omitted: BIND prompts for pathname.
OPTIONS
Default options are indicated by "(D)".
-B[INARY] pathname
Write the output object module to the named file.
-END End of commands (same as blank line).
-EXACTCASE Set binder to be case sensitive on all names. This is most
useful when binding C object modules, which can output case
sensitive names.
-GLO[BALS] Write currently defined global symbols to error output.
-H[ELP] Print this list of commands.
-MAP Write complete map to standard output.
-MOD[ULE] name Name the output object module. The default name is the first
input module name.
-NOEXACTCASE (D) Set binder to ignore case differences on names.
-Q[UIT] Exit from binder without finishing.
-READONLY[SECTION] name
Change named section from read/write to read-only.
-SEC[TIONS] Write current section definitions to error output.
-SORTL[OCATION] List defined globals, sorted by global location (section
number and offset).
-SORTN[AMES] (D) List defined globals sorted by global name.
-SYS[TEM] Make system global symbols visible.
-UND[EFINED] Write currently undefined global symbols to error output.
- (hyphen alone)
Request binder prompting for further arguments. Use only
on the line containing the BIND command. The hyphen must
be the last item on the line.
The following options are for use with user-installed libraries.
-ALLMARK Begin marking all defined global symbols.
-ALLUNMARK (D) Stop marking defined global symbols.
-LOOKS[ECTION] name
Set "look at installed sections" attribute on named data
section.
-LOOKS[ECTION] -ALL
Set "look at installed sections" attribute on all subsequent
data sections.
-NOLOOKS[ECTION] name
Remove "look at installed sections" attribute from named
data section.
-NOLOOKS[ECTION] -ALL
(D) Stop setting "look at installed sections" attribute on all
data sections.
-MARK global_name
Mark the named global symbol.
-MARK -ALL Same as -ALLMARK.
-MARKS[ECTION] name
Mark named data section for installing.
-MARKS[ECTION] -ALL
Mark all subsequent data sections for installing.
-UNMARK global_name
Remove mark from the named global symbol.
-UNMARK -ALL Same as -ALLUNMARK.
-UNMARKS[ECTION] name
Remove installing mark from named data section.
-UNMARKS[ECTION] -ALL
(D) Stop marking all data sections for installing.
BIND uses the command line parser, and so also accepts the standard command
options listed in HELP CL.
TURNING OPTIONS ON AND OFF
The binder processes arguments and options sequentially. Most options apply
to files specified later in the command string, but have no effect on the
files previously specified. In this manner, some options can be turned on
and off from one file to the next.
EXAMPLES
1. $BIND <RETURN> BIND specified alone on
*paul.bin -ALLMARK -B name.bin <RETURN> command line; enter
*time.bin -UNMARK date -UNMARK year <RETURN> arguments in response to
*john.bin -map <RETURN> asterisk. Press <RETURN>
*<RETURN> > to end prompting.
2. $BIND To include comments among
*london.bin arguments, enclose the
*{a map of Paris might be useful} comments in braces.
*paris.bin -map
*-END