ppl.remotes(4)

NAME

ppl.remotes − ppl configuration information for remote hosts

DESCRIPTION

The ppl.remotes file contains one entry for each remote host that ppl can communicate with (see ppl(1)). Lines that are blank or begin with a # in column 1 are ignored. Each entry is a multi-line form. Each line of this form contains space for variable data and a fixed text string describing what data goes on the line. All lines in the form must be present and undamaged or they cannot be parsed correctly.

The system administrator configures ppl operation by replicating the form and filling it in for each remote host. Depending on the desired configuration, some lines of the form do not apply and are left blank. Other non-critical fields can be left blank, leaving the ppl program free to choose an appropriate value. Entry syntax is specified in comments in the file. Here is a sample form for one remote host:

# sample dial in/out to a remote system
hewlett          # remote host name or Internet address
packard          # local host name or Internet address
                 # Internet mask
SLIP             # protocol [SLIP] [ASLIPC] [ASLIPS] [PPP]
DIALIN & DIALOUT # type [DIRECT] [DIALIN] [DIALOUT] [DIALIN & DIALOUT]
piper            # UUCP system name
                 # line parity [EVEN] [ODD] [NONE]
9600             # line speed
                 # serial line
9=2495574        # phone number
                 # modem control available [YES] [NO]
ogin-@-ogin guest ssword: 1JayBird %    # log in info
""ppl\shewlett running                 # command name

In this example, users on system hewlett can either dial in to packard or users on packard can dial in to hewlett. When ppl is run, only the needed fields are used. For example, the phone number is only used when dialing out. When dialing out, UUCP system piper is used to select a compatible line.

Fields

# remote host name or Internet address
Must be supplied. Can be in dotted decimal notation, or machine name. If a name is given, it is translated to a numeric form using gethostent() (see gethostent(3N)).

# local host name or Internet address
Optional. If supplied, it can be in dotted decimal notation or machine name. If a name is given, it is translated to a numeric form via gethostbyname() (see gethostbyname(3N)). If this field is left blank, ppl dynamically assigns a unique name from the pool of available addresses specified in the ppl.ipool file (see ppl.ipool(4)).

# Internet mask
Specifies the Internet network mask. If no mask is specified, a default netmask is derived from the local Internet address.

# protocol [SLIP] [ASLIPC] [ASLIPS] [PPP]
Specifies which encapsulation protocol ppl should use. As of this writing, SLIP, ASLIPC and ASLIPS are supported. Use ASLIPC to specify ASLIP client mode operation, and ASLIPS to specify ASLIP server mode operation.

# type [DIRECT] [DIALIN] [DIALOUT] [DIALIN & DIALOUT]
specifies what types of connections are permitted by ppl. If DIRECT is specified, neither DIALIN nor DIALOUT can be specified. A direct connection implies that modem control signals are not used. If the serial line is disconnected, the program cannot detect it. This is discussed further under the modem control field below. If DIALIN is specified, a dial-in user is permitted to run ppl over the line used to dial in on. In this case, ppl is invoked with the -i (default) option, and the user’s tty is used for the ppl encapsulation protocol. If DIALOUT is specified,

ppl -o remote_host

causes the local machine to dial up the remote machine and initiate a connection. If DIALIN & DIALOUT is specified, either DIALIN or DIALOUT connections are permitted. Note that some non-standard connection arrangements such as security dial-back systems may require alternate type specifications. See Using Serial Line IP Protocols manual for more details.

# UUCP system name
If the name of the remote computer is specified differently for the Internet remote host and the UUCP system, the UUCP name can be supplied. If this is left blank, the name given in the #remote host name/inet_addr field is used to locate a UUCP system name for dialing information if a dial out is required.

# line parity [EVEN] [ODD] [NONE]
If this field is supplied, it is used for setting the terminal options only when ppl enters the encapsulation protocol phase. It is not used to establish a connection. These parameters are set by UUCP, getty, or other means.

# line speed
is optional and only applies to outgoing (-o) connections. If supplied, this is used to set the rate on the tty line. If a UUCP line is used, this line provides the selection criteria when ppl selects a UUCP line. Most UUCP installations require that a speed be specified here in order to properly select a line. Line speed must be specified if a phone number or serial line is specified. Any baud rate supported by the system hardware can be used.

# serial line
Specifies which tty device is to be used for outgoing connections. If not supplied, the UUCP Systems file is used to select one based on the the UUCP system name or remote host name given in the ppl.remotes file entry. The path is ignored. For example, the names /dev/tty0p4 and tty0p4 are equivalent.

# phone number
Supplied for use on DIALOUT. When the phone number is supplied, it is used. If the phone number is not supplied here, the phone number listed in the UUCP Systems file is used. The syntax of the phone number is the same as the UUCP Systems file. Location names may be used as prefixes as in UUCP These are translated via the UUCP Dialcodes file.

# modem control available
Properly controls the use of modem signals during and after the dialing phase of ppl. During the dialing phase, this field is used to control dialing activity. The protocol phase uses this field and the type field described above. If the type field is DIRECT, and this field is NO (or blank), modem signals are ignored. For all other combinations of these two fields, the modem signal are monitored; i.e., hang up signal causes ppl to exit gracefully. Typical installations on direct lines will use: DIRECT type and NO (or blank) for modem control. For modem ports, typical installations will use: no DIRECT type, and YES for modem control.

# log in info
Supplies the dialogue needed to log in on the remote machine. The syntax is identical to the UUCP Systems file. This includes a series of send/expect strings separated by spaces. If this field is blank, it is assumed that no login is needed.

# command name
Supplies an optional dialogue needed to run a complementary protocol command on the remote machine. For remote HP-UX machines, this command is typically to invoke the ppl program on the remote machine. The syntax is identical to the UUCP Systems file.

Museum

Related Articles

ppl.remotes(4)

NAME

DESCRIPTION

Fields

FILES

WARNINGS

AUTHOR

SEE ALSO