bdconfig(1M)						  System Administration Commands					      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 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:

       +-----------------------------+-----------------------------+
       |      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 validate records in the iu.ap file, so that bdconfig could return to the  appropriate
       record in iu.ap as the default configuration.

SunOS 5.10							    18 May 1993 						      bdconfig(1M)