[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    bdconfig(1M) manual page Table of Contents

Name

bdconfig - configures the bd (buttons and dials) stream

Synopsis

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

Availability

SUNWdialh

Description

bdconfig 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.
off
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

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

See Also

autopush(1M) , 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.

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

Table of Contents