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 |