## Name

bo — Used to create or retrieve binary opaque objects.

## Synopsis

`bo` {[-i u] | [-o]} {`type dest source`} {`type dest source`}

## DESCRIPTION

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".

## EXAMPLES

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.

`mged>` `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.

`mged>``bo -o /home/jim/cmds.html cmds`

Copies the contents of the binary object named cmds into the file named /home/jim/cmds.html.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.