Click on any of the 687 commands below to get a description and list of available options. All links in the command summaries point to the online version of the book on Safari Bookshelf.
System administration command. PPP stands for the Point-to-Point Protocol; it allows datagram transmission over a serial connection. pppd attempts to configure tty for PPP (searching in /dev) or, by default, the controlling terminal. You can also specify a baud rate of speed. pppd accepts many options. Only the most common options are listed here.
Options
[local_IP_address] :[remote_IP_address]
Specify the local and/or remote interface IP addresses, as hostnames or numeric addresses.
asyncmapmap
Specify which control characters cannot pass over the line. map should be a 32-bit hex number, where each bit represents a character to escape. For example, bit 00000001 represents the character 0x00; bit 80000000 represents the character 0x1f or _. You may specify multiple characters.
auth
Require self-authentication by peers before allowing packets to move.
callfile
Read options from file in /etc/ppp/peers/. Unlike the file option, callfile may contain privileged options, even when pppd is not run by root.
connectcommand
Connect as specified by command, which may be a binary or shell command.
crtscts
Use hardware flow control.
debug
Log contents of control packets to syslogd.
defaultroute
Add a new default route in which the peer is the gateway. When the connection shuts down, remove the route.
nodetach
Operate in the foreground. By default, pppd forks and operates in the background.
disconnectcommand
Close the connection as specified by command, which may be a binary or shell command.
escapecharacter-list
Escape all characters in character-list, which should be a comma-separated list of hex numbers. You cannot escape 0x20-0x3f or 0x5e.
filefile
Consult file for options.
initscript
Run specified command or shell script to initialize the serial line.
lock
Allow only pppd to access the device.
mrubytes
Refuse packets of more than bytes bytes.
mtubytes
Do not send packets of more than bytes bytes.
passive, -p
Do not exit if peer does not respond to attempts to initiate a connection. Instead, wait for a valid packet from the peer.
silent
Send no packets until after receiving one.
Files
/var/run/pppn.pid
pppd's process ID. The n in pppn.pid is the number of the PPP interface unit corresponding to this pppd process.
/etc/ppp/ip-up
Binary or script to be executed when the PPP link becomes active.
/etc/ppp/ip-down
Binary or script to be executed when the PPP link goes down.
/etc/ppp/pap-secrets
Contains usernames, passwords, and IP addresses for use in PAP authentication.
/etc/ppp/options
System defaults. Options in this file are set before the command-line options.
~/.ppprc
The user's default options. These are read before command-line options but after the system defaults.