fnbind allows you to bind a composite name to a reference.
There are two uses of this command.
The first usage allows the user to bind the reference of an existing name to a new name. (See below.)
The second usage allows the user to bind a reference constructed using arguments in the command line to a name. (See "Constructing a Reference on the Command Line".)
The syntax of fnbind for binding existing names to new names is:
fnbind [-s][-v][-L] oldname newname |
Option |
Description |
---|---|
oldname |
The existing composite name |
newname |
The new name to which you are binding the old name |
-s |
Supersedes any existing binding of the original composite name |
-v |
Prints out the reference used for the binding |
-L |
Creates an XFN link using name and binding it to new_name |
For example, to bind the name user/julio/service/printer to the reference of myorgunit/service/printer you would enter:
# fnbind myorgunit/service/printer user/julio/service/printer |
If the given newname is already bound, fnbind -s must be used or the operation will fail. In the above example, if user/julio/service/printer is already bound, the -s option must be used to overwrite the existing binding with that of myorgunit/service/printer as shown below:
# fnbind -s myorgunit/service/printer user/julio/service/printer |
The -v option prints out the reference used for the binding.
# fnbind -v myorgunit/service/printer user/julio/service/printer Reference type: onc_printers Address type: onc_fn_printer_nisplus |
The following command constructs an XFN link out of user/jjones and binds it to the name user/James.Jones:
# fnbind -L user/jjones user/James.Jones |
Similarly, to create a link from user/julio/service/printer to myorgunit/service/printer you would enter:
# fnbind -sL myorgunit/service/printer user/julio/service/printer |
The syntax of fnbind for building a reference on the command line is:
fnbind -r [-s] [-v] newname [-O | -U] reftype {[-O | -U] | addresstype [-c|-x] addresscontents}+ |
Option |
Description |
---|---|
newname |
The new name for which you are constructing a reference |
reftype |
The type of reference you are creating. Unless the -O or -U options are used, FN_ID_STRING is used as the indentifier for reftype. |
addresstype |
The type of address you are creating. Unless the -O or -U options are used, FN_ID_STRING is used as the indentifier for addresstype. |
addresscontents |
The address of the reference you are creating. Unless the -c or -x options are used, the address is stored as an XDR-encoded string. |
-s |
Supersedes any existing binding of the original composite name |
-v |
Prints out the reference used for the binding |
-c |
Stores address contents without XDR encoding |
-x |
Interprets address contents as a hexadecimal input string and store it as is |
-r |
Creates a reference with a specified type and binds the reference to a name specified on the command line |
-O |
Interprets and stores type string as ASN.1 dot-separated integer list |
-U |
Interprets and stores type string as a DCE UUID |
For example, to bind the name thisorgunit/service/calendar to the address contents of staff@cygnus with a reference type of onc_calendar and and an address type onc_cal_str you would enter:
# fnbind -r thisorgunit/service/calendar onc_calendar onc_cal_str staff@cygnus |
By default, the address contents supplied in the command line is XDR-encoded before being stored in the reference. If the -c option is given, the address contents are stored in normal, readable characters, not as an XDR-encoded string. If the -x option is given, the address contents supplied in the command line are interpreted as a hexadecimal string and stored (and not XDR-encoded).
By default, the reference and address types of the reference to be constructed uses the FN_ID_STRING
identifier format. If the -O option is given, the identifier format is FN_ID_ISO_OID_STRING
, an ASN.1 dot-separated integer list string. If the -U option is given, the identifier format is FN_ID_DCE_UUID
, a DCE UUID in string form.
For more information on ASN.1, see ISO 8824: 1990, Information Technology -- Open Systems Interconnection -- Specification of Abstract Syntax Notation One (ASN.1). For more information on DCE UUID see X/Open Preliminary Specification, October 1993, X/Open DCE: Remote Procedure Call (ISBN: 1-872630-95-2).
For example, to bind to the name thisorgunit/service/nx a reference with a hexadecimal string as the address contents and OIDs as reference and address types, you would enter:
# fnbind -r thisorgunit/service/nx -O 1.2.99.6.2.1 -O 1.2.99.6.2.3 -x ef12eab67290 |