bdconfig

- configures the bd (buttons and dials) stream

Synopsis

bdconfig  [startup] [off] [on] [term] [status] [verbose]

Description

The bdconfig utility is responsible for configuring the autopush facility and defining to the system what serial device to use for the bd stream.

Options

If no options are given, then an interactive mode is assumed. In this mode the current status is presented along with this usage line, and a series of interactive questions asked to determine the user's desires.

Root privilege is required to change the configuration. The status option does not require root privilege. bdconfig can be installed as a setuid root program.

The non-interactive options below can be given in any order.

term

Specify to the system the serial device for bd use. This option implies the on option unless the off option is present.

iff

Reconfigure the configured term for tty use.

on

Reconfigure the configured term for bd use. If term has not been previously specified, interactive questions are asked to determine the user's desires.

startup

Configure as was last configured before the system went down. This option is used by the startup script, and precludes the use of the on, off, and term options. This option implies non-interactive mode.

status

Emit the current configuration in terms of the words used as options: off, on, /dev/term/a, /dev/term/b, and so forth. This option implies non interactive mode.

verbose

bdconfig describes what it finds and what it is doing.

Exit Status

The bdconfig utility returns 0 on success, 1 on general error, and 2 on argument error.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

autopush(1M), attributes(5), x_buttontest(6), x_dialtest(6), bd(7M), sad(7D), streamio(7I)

Notes

All bdconfig does is configure the AUTOPUSH facility. bdconfig does not actually manipulate the serial port or stream in any way. Only the first open of a dismantled stream will see the effects of a previously run bdconfig.

The bdconfig utility is silent except for error messages unless:

a)

invoked with no args: status / usage line emitted

b)

interactive modes are invoked as described above

c)

the verbose option is used

Bugs

The interface does not support more than one dialbox and one buttonbox, both of which must be on the same serial device.

There should be a library routine to read, parse, and validate records in the iu.ap file, so that bdconfig could return to the appropriate record in iu.ap as the default configuration.