bdconfig(1M)
NAME
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 ques-
tions 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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWdialh |
|_____________________________|_____________________________|
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 vali-
date records in the iu.ap file, so that bdconfig could
return to the appropriate record in iu.ap as the default
configuration.
Man(1) output converted with
man2html