4.06;bind (bind), revision 4.06, 84/04/09
BIND -- Combine object modules into an executable file.
usage: BIND [pathname [pathname ...]][-ALIGN section_name[WORD|LONG|QUAD|PAGE]]
[-ALLMARK] [-ALLUNMARK] [-B pathname]
[-END] [-EXACTCASE] [-GLO] [-H]
[-INCLUDE {module_name|-ALL}] [-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] [-XREF]
[-MESSAGES|-MSGS] [-NOMESSAGES|-NMSGS]
[-] {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.
-ALIGN section-name [WORD|LONG|QUAD|PAGE]
Align named section at load time.
-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 case sensitive on all names.
-GLO[BALS] Print currently defined globals.
-H[ELP] Print this list of commands.
-INCLUDE {module-name|-ALL}
Include a specific module from a library, or
all the modules from a library, in the bound
object module.
-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.
-MES[SAGES] | -MSGS (D) Produce informational messages.
-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).
-NOMES[SAGES] | -NMSGS Suppress informational messages.
-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.
-XREF Send a binary cross reference to standard
output. This will cross reference only
files following this option in the
command line.
- (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.
If a pathname refers to a library file, no modules from the
library are included in the bound object module unless:
-- they are implicitly referenced by some other module
which is included in the bound object module
-- or, they are explicitly included with the -INCLUDE
option (described below).
Default if omitted: BIND prompts for pathname.
OPTIONS
Default options are indicated by "(D)."
-ALIGN section-name [ LONG | QUAD | PAGE ]
Cause the named section to be aligned, at load time, on
either a 32-bit (LONG), a 64-bit (QUAD), or an 8192-bit
(PAGE) boundary. By default, all sections are aligned on a
LONG boundary.
-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. This
option changes sections such as FORTRAN COMMON blocks from
read/write to read-only to improve program invocation time.
Only those sections containing tables initialized to
certain values by FORTRAN DATA statements (or the like),
and that never change during program execution, are
eligible.
-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.
-INCLUDE {module-name | -ALL}
Include a specific module from a library, or all the
modules from a library, in the bound object module. This
option must follow a pathname which refers to a library
file or an error message is generated. Note that this
option is the only way to include a module from a library
in a bound object module, unless the library module is
explicitly referenced by a module which is already in the
bound object module.
-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 -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 -ALL (D)
Stop marking all data sections for installing.
-XREF Send a binary cross-reference to standard output. This
will cross-reference only files following this option in
the command line.
This command uses the command line parser, and so also accepts the standard
command options listed in HELP CL.
TURNING OPTIONS ON AND OFF
Because 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