85 lines
2.1 KiB
Groff
85 lines
2.1 KiB
Groff
.\" $FreeBSD$
|
|
.Dd May 1, 2001
|
|
.Dt DIGICTL 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm digictl
|
|
.Nd control
|
|
.Tn Digiboard
|
|
devices
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl d Ar debug
|
|
.Op Fl ir
|
|
.Ar device ...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
program provides control of the
|
|
.Tn Digiboard
|
|
installed with the given control
|
|
.Ar device
|
|
name.
|
|
A digiboard control
|
|
.Ar device
|
|
is usually of the form
|
|
.Pa /dev/digi Ns Ar N Ns Pa .ctl
|
|
where
|
|
.Ar N
|
|
is the card number and starts at 0 for the first attached card.
|
|
.Pp
|
|
The following flags are recognized:
|
|
.Bl -tag -xwidth ".Fl d Ar debug"
|
|
.It Fl d Ar debug
|
|
If the driver has been compiled with
|
|
.Dv DEBUG
|
|
defined, the following bits from the
|
|
.Ar debug
|
|
variable are used to enable diagnostics in the digiboard driver:
|
|
.Bl -tag -xwidth ".No 1024 ( Em MODEM )"
|
|
.It 1 ( Em INIT )
|
|
Diagnostics during card attach, detach and initialization.
|
|
.It 2 ( Em OPEN )
|
|
Diagnostics when opening a port.
|
|
.It 4 ( Em CLOSE )
|
|
Diagnostics when closing a port.
|
|
.It 8 ( Em SET )
|
|
Diagnostics when setting tty device flags.
|
|
.It 16 ( Em INT )
|
|
Diagnostics when processing card events.
|
|
.It 32 ( Em READ )
|
|
Reports return values from port reads.
|
|
.It 64 ( Em WRITE )
|
|
Reports return values from port writes.
|
|
.It 128 ( Em RX )
|
|
Reports receive queue flow control.
|
|
.It 256 ( Em TX )
|
|
Reports transmit queue flow control.
|
|
.It 512 ( Em IRQ )
|
|
Diagnostics during interrupts (enable these with care).
|
|
.It 1024 ( Em MODEM )
|
|
Diagnostics when setting modem status flags.
|
|
.It 2048 ( Em RI )
|
|
Reports when a RING is received.
|
|
.El
|
|
.It Fl i
|
|
Display the card identification string and type ID.
|
|
.It Fl r
|
|
Reinitialize the card.
|
|
For boards with external port modules, it is possible to add or remove
|
|
modules and dynamically reprobe the number of ports using this switch.
|
|
All ports on the card must be closed in order to reinitialize the card.
|
|
.Pp
|
|
It is preferable to reinitialize the card rather than reload the entire
|
|
digi module as reinitialization only affects the specified board rather
|
|
than affecting all attached boards.
|
|
.El
|
|
.Sh BUGS
|
|
It should be possible to reinitialize a board without closing all of the
|
|
existing ports.
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
command first appeared in
|
|
.Fx 5.0 .
|