GATEWAYS(5)              Series 300 Only              GATEWAYS(5)

     NAME
          gateways - routing data base

     HP-UX COMPATIBILITY
          Level:    HP-UX/NON-STANDARD

          Origin:   UCB

          Remarks:  Implemented on the Series 300 only.

     DESCRIPTION
          The  gateways  file  contains  information  regarding  known
          routes  to  hosts and networks.  This information is read by
          the npowerup(1) command when the network is powered up.  The
          information is stored in a kernel routing table for use when
          attempting to reach a remote host that is not on a  directly
          connected network.

          There may be only one valid route to a  particular  host  or
          network  at any given time.  The kernel routing table may be
          displayed by  using  the  netstat(1)  command  with  the  -r
          option.

          If subnetworking is in use  and  a  route  to  a  subnet  is
          desired,  it  should  be  entered  as a route to a host.  If
          subnetworking  is  in  use,  host  routes  are  treated   as
          potential routes to subnets.

          The file, /etc/gateways, is comprised of a series of  lines,
          each in the following format:

               < net | host | default > name1 gateway name2 [ metric value ]

          The net, host, or default keyword indicates if the route  is
          to a network, a specific host, or the default gateway to use
          if no other route is found.

          Name1 is the name of the destination network or host.   This
          may   be   a  symbolic  name  located  in  /etc/networks  or
          /etc/hosts, or an  Internet  address  specified  in  ``dot''
          notation;  see  inet(3N).   If  the default keyword is used,
          name1 is ignored.

          Name2 is the name or address of the gateway to use to  reach
          the host or network.

          Value  is  a  metric  indicating  the  hop  count   to   the
          destination host or network.

          There may be only one default gateway in the  table  at  any
          time.   If  more  than  one  is entered in the /etc/gateways
          file, the last one will be the one  entered  in  the  kernel

     Hewlett-Packard               - 1 -             (printed 7/16/86)

     GATEWAYS(5)              Series 300 Only              GATEWAYS(5)

          routing table.

          Note: The kernel routing table may be updated dynamically by
          messages  over the network.  These changes are not reflected
          in the /etc/gateways file.  Changes  made  in  /etc/gateways
          will  not be reflected in the kernel tables until the system

          is rebooted and the network is powered up.

          Since only one route to a host or network  is  allowed,  the
          hop count metric is ignored if included.

     SEE ALSO
          npowerup(1), netstat(1), route(1m), routing(4).

     Hewlett-Packard               - 2 -             (printed 7/16/86)