|-f <number>[,<further numbers>]|
Add <number> to the list of record header IDs that allow a record from a source
file to be written to the target file. A certain header ID marks code for a certain
target processor family; thus, this filter allows to distill code for a certain
processor out of a source file that contains code for different processor families.
Negation of this parameter removes certain header IDs from BINDs list. See
the user manual of AS for a list of all possible header ID values. If BINDs list
of header IDs is empty, no filtering will take place, i.e. all records from a source
file will make it into the target file.
Parameters need not neccessarily be given in the command line itself. Before processing of command line parameters starts, BIND will look if the BINDCMD environment variable is defined. If it exists, its contents will be treated as additional command line paramters whose syntax is absolutely equal to normal command line parameters. As exception is made if the variables contents start with a @ sign; in such a case, the string after the @ sign is treated as the name of a file that contains the options. Such a file (also called a key file) has the advantage that it allows the options to be written in different lines, and it does not have a size limit. Some operating systems (like MS-DOS) do have a length limit on command lines and environment variable contents, so the key file may be your only option if you have a lot of lengthy parameters for BIND.
pbind may return with the following codes:
0 no errors. 1 incorrect command line parameters. 2 I/O-error. 3 An input file had an incorrect format.
To combine all records of src1.p and src2.p into a single file dest.p, use:
pbind src1 src2 dest
To extract all records with MCS-51-code from a file mixed.p, use
pbind -f \$31 mixed only51,
and the record will be written to a file only51.p. Notice that the dollar sign in this example had to be protected with a backslash sign, as a UNIX shell uses the dollar character for expansion of variables. This would not have been necessary on an OS/2 or MS-DOS system (it would result in an error).
pbind supports national languages in the same way as AS. See the manual page for asl(1) for maore information about this.
Calling BIND without any arguments will print a short help listing all command line parameters.
BIND originally appeared as an AS tool in 1992, written in Borland-Pascal, and was ported to C and UNIX in 1997.
Command line interpreters of some operating systems reserve some characters for their own use, so it might be necessary to give command line parameters with certain tricks (e.g., with the help of escape characters).
BIND does not have so far an opportunity to filter records by target segment.
Alfred Arnold (email@example.com)