PPP(8) BSD System Manager's Manual PPP(8)NAMEppp - establish PPP connections
SYNOPSISppp [-bdix] [-s sysfile] [-X level] [system-name]
DESCRIPTION
The ppp command is used to establish network connections with Point-to-
Point Protocol (PPP) over dial-up asynchronous and dedicated synchronous
lines.
When used with asynchronous lines, the program can be used in both
originating and answering modes. The ppp command in originating mode di-
als the number, performs any required login sequence (see ppp_proxy(8)),
attaches the line to a network interface and waits until the session is
terminated. In answering mode ppp is called as login shell from login(8)
and attaches the line to a network interface for the duration of the ses-
sion. To operate in answering mode ppp should be called with no argu-
ments or with the -i flag.
When used with synchronous lines, PPP must always be used in
``originating'' mode. This is simply an artifact of the program's histo-
ry.
Ppp obtains the parameters of remote systems from a single configuration
file (which will further be called the system file). The name of the
system file is /etc/ppp.sys. See ppp.sys(5) for the detailed description
of the system file format.
The following operands are supported by ppp:
-bppp puts itself into the background after the link is estab-
lished.
-d Invokes originating ppp in daemon mode - if the connection is
dropped it will be redialed, possibly waiting for an outgoing da-
ta packet to be routed through the interface before doing so.
-i Mark this line as dialin even if system-name is provided. This
is mainly used for dialin sessions called directly from gettyd(8)
rather than from login(8). To invoke ppp directly from
gettyd(8), the /etc/ttys entry for the line should contain ppp-
only.
-s sysfile
If sysfile is the name of a file then use it instead of
/etc/ppp.sys as the system file. If sysfile is not the name of a
file then it must be a complete entry of the type found in
/etc/ppp.sys. It will be searched prior to searching
/etc/ppp.sys. This is typically used to create a dialout entry
"on the fly" and then dial from it. For example:
ppp-s site:dialout:device=ntwo0:immediate: site
-x Provides debugging information about the progress of dialing and
login sequences.
-X level
Enable protocol debugging for level. The following levels are
available:
debug-all Turn on all debugging.
debug-int Turn on internal debugging messages.
debug-packet Turn on one line control packet tracing.
debug-phase Turn on major phase change debugging.
debug-state Turn on state change debugging.
packet-dump Print hex dump of every control packet.
trace Print a detailed trace of control packets.
system-name
specifies the system to call. If not present, ppp uses the login
user name as the system name.
Ppp requires super-user privileges. Normally ppp will clear the environ-
ment and reset it (and the process's priorities) to the path defined for
the daemon class (see login.conf(5)). However, if the -s option is used
by a non-root account, the scripts will be run as the user in their cur-
rent environment with their current priorities.
Since ppp can configure the interface and PPP parameters there is no need
to use ifconfig.
Although ppp is intended to be used on dial-up links it can be used on
dedicated synchronous and asynchronous circuits as well.
FILES
/etc/ppp.sys The system file
/var/log/daemon.log Standard ppp warning and informational
messages (along with other daemons)
/var/log/ppp.debug Debugging and trace output from dialin
sessions
/etc/netscripts/Demand.login Default LOGIN script for dial on demand
/etc/netscripts/Demand.up Default UP script for dial on demand
/etc/netscripts/Demand.down Default DOWN script for dial on demand
/etc/netscripts/Dialin.login Default LOGIN script for dialin
/etc/netscripts/Dialin.up Default UP script for dialin
/etc/netscripts/Dialin.down Default DOWN script for dialin
/etc/netscripts/Dialout.login Default LOGIN script for dialout
/etc/netscripts/Dialout.up Default UP script for dialout
/etc/netscripts/Dialout.down Default DOWN script for dialout
DIAGNOSTICS
Diagnostics are, hopefully, self explanatory.
SEE ALSOppp.sys(5), chap_md5(8), gettyd(8), ifconfig(8), ppp_proxy(8),
pppstat(8), appp(4), ppp(4)HISTORY
The ppp command appeared in BSD/OS.
BSD/OS January 16, 1997 2
