usr.sbin/digictl/digictl.8

   1 .\" $FreeBSD$
   2 .Dd May 1, 2001
   3 .Dt DIGICTL 8
   4 .Os
   5 .Sh NAME
   6 .Nm digictl
   7 .Nd control
   8 .Tn Digiboard
   9 devices
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl d Ar debug
  13 .Op Fl ir
  14 .Ar device ...
  15 .Sh DESCRIPTION
  16 The
  17 .Nm
  18 program provides control of the
  19 .Tn Digiboard
  20 installed with the given control
  21 .Ar device
  22 name.
  23 A digiboard control
  24 .Ar device
  25 is usually of the form
  26 .Pa /dev/digi Ns Ar N Ns Pa .ctl
  27 where
  28 .Ar N
  29 is the card number and starts at 0 for the first attached card.
  30 .Pp
  31 The following flags are recognized:
  32 .Bl -tag -xwidth ".Fl d Ar debug"
  33 .It Fl d Ar debug
  34 If the driver has been compiled with
  35 .Dv DEBUG
  36 defined, the following bits from the
  37 .Ar debug
  38 variable are used to enable diagnostics in the digiboard driver:
  39 .Bl -tag -xwidth ".No 1024 ( Em MODEM )"
  40 .It 1 ( Em INIT )
  41 Diagnostics during card attach, detach and initialization.
  42 .It 2 ( Em OPEN )
  43 Diagnostics when opening a port.
  44 .It 4 ( Em CLOSE )
  45 Diagnostics when closing a port.
  46 .It 8 ( Em SET )
  47 Diagnostics when setting tty device flags.
  48 .It 16 ( Em INT )
  49 Diagnostics when processing card events.
  50 .It 32 ( Em READ )
  51 Reports return values from port reads.
  52 .It 64 ( Em WRITE )
  53 Reports return values from port writes.
  54 .It 128 ( Em RX )
  55 Reports receive queue flow control.
  56 .It 256 ( Em TX )
  57 Reports transmit queue flow control.
  58 .It 512 ( Em IRQ )
  59 Diagnostics during interrupts (enable these with care).
  60 .It 1024 ( Em MODEM )
  61 Diagnostics when setting modem status flags.
  62 .It 2048 ( Em RI )
  63 Reports when a RING is received.
  64 .El
  65 .It Fl i
  66 Display the card identification string and type ID.
  67 .It Fl r
  68 Reinitialize the card.
  69 For boards with external port modules, it is possible to add or remove
  70 modules and dynamically reprobe the number of ports using this switch.
  71 All ports on the card must be closed in order to reinitialize the card.
  72 .Pp
  73 It is preferable to reinitialize the card rather than reload the entire
  74 digi module as reinitialization only affects the specified board rather
  75 than affecting all attached boards.
  76 .El
  77 .Sh BUGS
  78 It should be possible to reinitialize a board without closing all of the
  79 existing ports.
  80 .Sh HISTORY
  81 The
  82 .Nm
  83 command first appeared in
  84 .Fx 5.0 .