Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pbind(1)		    General Commands Manual		      pbind(1)

NAME
       pbind - recombine output	files generated	by AS

SYNTAX
       pbind [ option(s) ] <name(s)> [ further options/names ]

DESCRIPTION
       BIND  is	 a tool	to combine code	files generated	by the AS cross	assem-
       bler to a single	file or	to extract records out of a code file.	 pbind
       is  the	Unix/C	implementation of BIND.	 BIND is not a linker; AS does
       not generate linkable code!

       Arguments to BIND can be	either file  name  specifications  or  command
       line  parameters;  any  argument	 starting  with	a plus(+), minus(-) or
       slash(/)	is recognized as a parameter; anything else is regarded	 as  a
       file name.  BIND	always regards the last	name as	the target file's name
       specification; all other	files are regarded as source files.  A	target
       name  and  no  source  will yield an empty target file, whereas no file
       name at all will	result in an error message.  File names	 that  do  not
       have  an	 extension  will be expanded with '.p',	the standard extension
       for code	files.

       The way BIND operates is	to process source files	in the order they  are
       given  in  the  command	line,  reading	record by record, and to write
       records that fit	into the given filtering criteria to the target	 file.
       After  all source files have been processed, BIND will write a new cre-
       ator entry to the target	file.

COMMAND-LINE PARAMETERS
       If a command-line parameter starts with a slash(/) or minus sign(-), it
       turns  an  option  on;  if  a command-line parameter starts with	a plus
       sign(+),	it turns a specific option off.	 Numeric arguments to  parame-
       ters  can  be  either  written in decimal or hexadecimal	notation.  For
       hexadecimal notation, prefix the	number with a dollar($)	sign.

       pbind accepts the following command-line	parameters:

       -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 fam-
	      ily; thus, this filter allows to distill code for	a certain pro-
	      cessor out of a source file that	contains  code	for  different
	      processor	 families.  Negation of	this parameter removes certain
	      header IDs from BIND's list.  See	the user manual	of  AS	for  a
	      list of all possible header ID values.  If BIND's	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.

PRESETTING PARAMETERS
       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 con-
       tents will be treated as	additional command line	paramters whose	syntax
       is absolutely equal to normal command line parameters.  As exception is
       made if the variable's 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.

RETURN CODES
       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.

EXAMPLES
       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).

NATIONAL LANGUAGE SUPPORT
       pbind supports national languages in the	same way as AS.	 See the  man-
       ual page	for asl(1) for maore information about this.

TIPS
       Calling	BIND without any arguments will	print a	short help listing all
       command line parameters.

SEE ALSO
       asl(1), plist(1), p2hex(1), p2bin(1)

HISTORY
       BIND originally appeared	as an AS tool in 1992, written in Borland-Pas-
       cal, and	was ported to C	and UNIX in 1997.

BUGS
       Command	line interpreters of some operating systems reserve some char-
       acters for their	own use, so it might be	necessary to give command line
       parameters  with	 certain tricks	(e.g., with the	help of	escape charac-
       ters).

       BIND does not have so far an opportunity	to filter  records  by	target
       segment.

AUTHOR(S)
       Alfred Arnold (a.arnold@kfa-juelich.de)

								      pbind(1)

NAME | SYNTAX | DESCRIPTION | COMMAND-LINE PARAMETERS | PRESETTING PARAMETERS | RETURN CODES | EXAMPLES | NATIONAL LANGUAGE SUPPORT | TIPS | SEE ALSO | HISTORY | BUGS | AUTHOR(S)

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pbind&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help