DEVICES(F)                                 UNIX System V



     Name
          devices - format of UUCP devices file


     Description
          The   Devices    file    (/usr/lib/uucp/Devices)    contains
          information  for  all  the  devices  that  can  be  used  to
          establish a  link  to  a  remote  computer.   These  devices
          include  automatic  call  units,  direct  links, and network
          connections.  This file  works  closely  with  the  Dialers,
          Systems, and Dialcodes files.

          Each entry in the Devices file has the following format:

                type ttyline dialerline speed dialer-token

          where:

               type      can contain one of two  keywords  (direct  or
                         ACU),  the  name  of  a  Local  Area  Network
                         switch, or a system name.

               ttyline   contains the device name of the  line  (port)
                         associated   with  the  Devices  entry.   For
                         example, if the Automatic Dial  Modem  for  a
                         particular   entry   is   attached   to   the
                         /dev/tty11 line, the  name  entered  in  this
                         field is tty11.

               dialerlineis useful only for 801 type dialers, which do
                         not   contain   a   modem  and  must  use  an
                         additional line.  If you do not have  an  801
                         dialer, enter a hyphen (-) as a placeholder.

               speed     is the speed or speed range  of  the  device.
                         It    may    contain    an    indicator   for
                         distinguishing different dialer classes.

               dialer-tokc
en Contains pairs of dialers and  tokens.   Each
                         represents  a  dialer  and  an argument to be
                         passed to it.  The dialer portion can be  the
                         name of an automatic dial modem, or it may be
                         a direct for a direct link device.

          For best results, dialer programs are preferred over Dialers
          entries.   The  following  entry  is  an example of an entry
          using a dialer binary:

               ACU  ttynn  -  300-2400  /usr/lib/uucp/dialHA24

          Note all lines must have at least 5 fields.  Use  ``-''  for
          unused  fields.   Types that appear in the 5th field must be
          either built-in functions (801, Sytek, TCP, Unetserver,  DK)
          or  standard functions whose name appears in the first field
          in the Dialers file.

          Two escape characters can be used in this file:

               \D   which means don't translate the phone /token

               \T   translate the phone  /token  using  the  Dialcodes
                    file

          Both refer to the phone number field  in  the  Systems  file
          (field  5).   \D  should  always be used with entries in the
          Dialers file, since the Dialers file  can  contain  a  T  to
          expand the number if necessary.  \T should only be used with
          built-in functions that require expansion.

          Note that if a phone number is expected and a \D  or  \T  is
          not  present a \T is used for a built-in, and \D is used for
          an entry referencing the Dialers file.


     Examples
          The following are examples of common Devices files.

        Standard modem line
          ACU tty00 - 1200 801
          ACU tty00 - 1200 penril
          or
          ACU tty00 - 1200 penril \D

        A direct line
          This example will allow  cu -ltty00  to  work.   This  entry
          could also be used for certain modems in manual mode.

          Direct tty00 - 4800 direct

        A ventel modem on a develcon switch
          ``vent'' is the token given to the  develcon  to  reach  the
          ventel modem.

          ACU tty00 - 1200 develcon vent ventel
          ACU tty00 - 1200 develcon vent ventel \D

        To reach a system on the local
        develcon switch
          Develcon tty00 - Any develcon \D

        A direct connection to a system
          systemx tty00 - Any direct

        STREAMS Network Examples
          A STREAMS  network  that  conforms  to  the  AT&T  Transport
          Interface  with  a direct connection to login service (i.e.,
          without explicitly using the Network Listener  Service  dial
          script):

               networkx,eg devicex - - TLIS \D

          The Systems file entry looks like:

               systemx Any networkx - addressx in:--in: nuucp word: nuucp

          You must replace systemx, networkx,  addressx,  and  devicex
          with  system name, network name, network address and network
          device, respectively.   For  example,  entries  for  machine
          ``sffo'' on a STARLAN NETWORK might look like:

               sffoo Any STARLAN - sffoo in:--in: nuucp word: nuucp

          and:

               STARLAN,eg starlan - - TLIS \D

          To use a STREAMS network that conforms to the AT&T Transport
          Interface  and  that  uses the Network Listener Service dial
          script to negotiate for a server:

               networkx,eg devicex - - TLIS \D nls

          To use a non-STREAMS  network  that  conforms  to  the  AT&T
          Transport  Interface  and  that  uses  the  Network Listener
          Service dial script to negotiate for a server:

               networkx,eg devicex - - TLI \D nls

     See Also
          uucico(ADM), uucp(C), uux(C), uuxqt(C), dialers(F)


     Notes
          Blank lines and lines that begin with a <space>,  <tab>,  or
          are ignored.  protocols can be specified as a comma-subfield
          of the device type either in the Devices file (where  device
          type  is  field 1) or in the Systems file (where it is field
          3).


     (printed 8/23/89)                                  DEVICES(F)