Used to create or retrieve binary opaque objects. Currently, only uniform binary objects (arrays of values) are supported. One of -i or -o must be specified. The -i is for "input," or creating a binary object, and the -o option is used for "output," or retrieving a binary object. The u type argument must be supplied when -i is used, to indicate the type of uniform binary object to be created. On input, the dest is the name of the object to be created, and the source is the path to a file containing the values in the local host format. On output, dest is the path to a file to receive the contents of the binary object whose name appears in source. The type may be one of:
|f -> float|
|d -> double|
|c -> char (8 bit)|
|s -> short (16 bit)|
|i -> int (32 bit)|
|l -> long (64 bit)|
|C -> unsigned char (8 bit)|
|S -> unsigned short (16 bit)|
|I -> unsigned int (32 bit)|
|L -> unsigned long (64 bit)|
Note: this command was previously named "dbbinary".
The examples show the use of the bo command to both create (-i option) and to retrieve a binary object (-o option).
Example 1. Create an opaque uniform binary object of characters with a specified name containing the contents of a particular file.
bo -i u c cmds /usr/brlcad/html/manuals/mged/mged_cmds.html
Creates an opaque uniform binary object of characters with the name cmds that contains the contents of the file /usr/brlcad/html/manuals/mged/mged_cmds.html.
Example 2. Copy the contents of a particular binary object into a specified file.
bo -o /home/jim/cmds.html cmds
Copies the contents of the binary object named cmds into the file named /home/jim/cmds.html.