ppphosts(SFF)                   19 June 1992                   ppphosts(SFF)


 Name

    ppphosts - Point-to-Point Protocol Host name database

 Syntax

    /etc/ppphosts

 Description

    The /etc/ppphosts file contains information about known PPP hosts.  This
    file contains a single-line entry for each PPP host with the following
    information:

    +  Remote host name or alias

    +  Inactivity timeout in minutes (optional, default = forever)

    +  tty name for direct connection (optional)

    +  uucp system name for this remote host

    +  timeout per PPP protocol request (optional, default = 10 seconds)

    +  Maximum number of retries per PPP protocol request (optional,default =
       3)

    These data items should be separated by ``white space.'' A ``#'' indi-
    cates the beginning of a comment; characters appearing after ``#'' are
    ignored.

    This file should be created and maintained by the Network Administrator.
    These guidelines should be followed in creating /etc/ppphosts:

    +  The host name should have a corresponding entry in /etc/hosts (see
       hosts(SFF))

    +  Optional parameters may be defaulted by using the ``-'' placeholder.

    +  The tty name (if other than ``-'') should have a corresponding entry
       in /usr/lib/uucp/Dialers

    +  The uucp system name should have a corresponding entry in
       /usr/lib/uucp/Systems

    The contents of this file will be used by the pppd daemon (see
    pppd(ADMN)).

 Examples


    Typical /etc/ppphosts File

    #
    #       Inactivity      tty name        UUCP    ACK
    #Host   timeout         (direct         system  timeout         ACK
    #name   (minutes)       connect)        name    (seconds)       retries
    #
    homer_ppp       5       -               homer
    bart_ppp        -       tty01           bart    -               5


    Using the guidelines shown in the ``Basic Network Utilities'' Section of
    the UNIX System V/386 Release 3.2 System Administrator's Guide, Examples
    2 and 3 show how typical data in the /etc/ppphosts,
    /usr/lib/uucp/Systems, and /usr/lib/uucp/Dialers files could be used for
    reaching a PPP host.

    A Direct Line between PPP Hosts

    ppphosts: bart_ppp        5       tty01   bart

    hosts:    128.2.129.2     bart_ppp

    Dialers:  Direct  tty01   -       9600    direct

    Systems:  bart    Any     Direct  9600    -       login:  nppp
              Password:  PPP_password

    The special user_name nppp will initiate the remote login session; also
    note that following four network-dependent data items in the above table
    entries must match:   bart_ppp, bart, tty01, and Direct.

    A Dial-up Line between PPP Hosts

    ppphosts: homer_ppp       5       -       homer

    hosts:    128.2.129.5     homer_ppp

    Systems:  homer   Any     ACU     2400    555-1234        login:  nppp
              Password: PPP_password


 Files


    /etc/hosts
    /etc/ppphosts
    /usr/lib/uucp/Systems
    /usr/lib/uucp/Dialers


 See also

    host(SFF), pppd(ADMN), uucp(TC), System Administrator's Guide

 User considerations

    The Network Administrator should ensure consistent entries in the
    /etc/ppphosts, /usr/lib/uucp/Systems, and /usr/lib/uucp/Dialers for the
    PPP hosts.