HPUX ppl.remotes[4]
ppl.remotes(4) 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
Hewlett-Packard Company - 1 - HP-UX Release 9.0: August 1992
ppl.remotes(4) ppl.remotes(4)
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
Hewlett-Packard Company - 2 - HP-UX Release 9.0: August 1992
ppl.remotes(4) ppl.remotes(4)
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.
FILES
/usr/lib/ppl/ppl.remotes full path name of ppl.remotes
Hewlett-Packard Company - 3 - HP-UX Release 9.0: August 1992
ppl.remotes(4) ppl.remotes(4)
WARNINGS
LOGIN option in the OPTIONS field is not used.
AUTHOR
ppl.remotes was developed by HP.
SEE ALSO
pplstat(1), ppl(1), ppl.ipool(4), ppl.users(4), ppl.ptmp(4),
Using Serial Line IP Protocols,
UUCP tutorial in Remote Access Users Guide .
Hewlett-Packard Company - 4 - HP-UX Release 9.0: August 1992