1 '\" te
   2 .\" Copyright (c) 1989 Carnegie Mellon University. All rights reserved.
   3 .\" Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by Carnegie Mellon University.  The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
   4 .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
   5 .\" Portions Copyright (c) 2008, Sun Microsystems, Inc. All Right Reserved.
   6 .TH PPPD 1M "November 22, 2021"
   7 .SH NAME
   8 pppd \- point to point protocol daemon
   9 .SH SYNOPSIS
  10 .nf
  11 \fBpppd\fR [\fItty_name\fR] [\fIspeed\fR] [\fIoptions\fR]
  12 .fi
  13 
  14 .SH DESCRIPTION
  15 The point-to-point protocol (PPP) provides a method for transmitting datagrams
  16 over serial point-to-point links. PPP is composed of three components: a
  17 facility for encapsulating datagrams over serial links, an extensible link
  18 control protocol (LCP), and a family of network control protocols (NCP) for
  19 establishing and configuring different network-layer protocols.
  20 .sp
  21 .LP
  22 The encapsulation scheme is provided by driver code in the kernel. \fBpppd\fR
  23 provides the basic LCP authentication support and several NCPs for establishing
  24 and configuring the Internet Protocol (referred to as the IP Control Protocol
  25 or "IPCP") and IPv6 (IPV6CP).
  26 .SH OPTIONS

1284 .sp
1285 .ne 2
1286 .na
1287 \fB\fBnoproxyarp\fR \fR
1288 .ad
1289 .sp .6
1290 .RS 4n
1291 Disable the \fBproxyarp\fR option. If you want to prevent users from creating
1292 proxy ARP entries with \fBpppd\fR, place this option in the
1293 \fB/etc/ppp/options\fR file.
1294 .RE
1295 
1296 .sp
1297 .ne 2
1298 .na
1299 \fB\fBnotty\fR \fR
1300 .ad
1301 .sp .6
1302 .RS 4n
1303 Normally, \fBpppd\fR requires a terminal device. With this option, \fBpppd\fR
1304 allocates itself a pseudo-tty master/slave pair and uses the slave as its
1305 terminal device. \fBpppd\fR creates a child process to act as a character shunt
1306 to transfer characters between the pseudo-tty master and its standard input and
1307 output. Thus, \fBpppd\fR transmits characters on its standard output and
1308 receives characters on its standard input even if they are not terminal
1309 devices. This option increases the latency and CPU overhead of transferring
1310 data over the ppp interface as all of the characters sent and received must
1311 flow through the character shunt process. An explicit device name may not be
1312 given if this option is used.
1313 .RE
1314 
1315 .sp
1316 .ne 2
1317 .na
1318 \fB\fBnovj\fR \fR
1319 .ad
1320 .sp .6
1321 .RS 4n
1322 Disable Van Jacobson style TCP/IP header compression in both the transmit and
1323 the receive direction.
1324 .RE
1325 
1326 .sp
1327 .ne 2
1328 .na

1489 .na
1490 \fB\fBproxyarp\fR \fR
1491 .ad
1492 .sp .6
1493 .RS 4n
1494 Add an entry to the system's Address Resolution Protocol (ARP) table with the
1495 IP address of the peer and the Ethernet address of this system. When you use
1496 this option, the peer appears to other systems to be on the local Ethernet. The
1497 remote address on the PPP link must be in the same subnet as assigned to an
1498 Ethernet interface.
1499 .RE
1500 
1501 .sp
1502 .ne 2
1503 .na
1504 \fB\fBpty\fR \fB \fIscript\fR\fR \fR
1505 .ad
1506 .sp .6
1507 .RS 4n
1508 Specifies that the command \fIscript\fR, and not a specific terminal device is
1509 used for serial communication. \fBpppd\fR allocates itself a pseudo-tty
1510 master/slave pair and uses the slave as its terminal device. \fIscript\fR runs
1511 in a child process with the pseudo-tty master as its standard input and output.
1512 An explicit device name may not be given if this option is used. (Note: if the
1513 \fBrecord\fR option is used in conjunction with the \fBpty\fR option, the child
1514 process will have pipes on its standard input and output.)
1515 .RE
1516 
1517 .sp
1518 .ne 2
1519 .na
1520 \fB\fBreceive-all\fR \fR
1521 .ad
1522 .sp .6
1523 .RS 4n
1524 With this option, \fBpppd\fR accepts all control characters from the peer,
1525 including those marked in the receive \fBasyncmap\fR. Without this option,
1526 \fBpppd\fR discards those characters as specified in \fIRFC 1662\fR. This
1527 option should be used only if the peer has bugs, as is often found with
1528 dial-back implementations.
1529 .RE
1530 
1531 .sp
1532 .ne 2
1533 .na
1534 \fB\fBrecord\fR \fB\fIfilename\fR\fR \fR
1535 .ad
1536 .sp .6
1537 .RS 4n
1538 Directs \fBpppd\fR to record all characters sent and received to a file named
1539 \fIfilename\fR. \fIfilename\fR is opened in append mode, using the user's
1540 user-ID and permissions. Because this option uses a pseudo-tty and a process to
1541 transfer characters between the pseudo-tty and the real serial device, it
1542 increases the latency and CPU overhead of transferring data over the PPP
1543 interface. Characters are stored in a tagged format with timestamps that can be
1544 displayed in readable form using the \fBpppdump\fR(1M) program. This option is
1545 generally used when debugging the kernel portion of \fBpppd\fR (especially CCP
1546 compression algorithms) and not for debugging link configuration problems. See
1547 the \fBdebug\fR option.
1548 .RE
1549 
1550 .sp
1551 .ne 2
1552 .na
1553 \fB\fBremotename\fR \fB\fIname\fR\fR \fR
1554 .ad
1555 .sp .6
1556 .RS 4n
1557 Set the assumed name of the remote system for authentication purposes to
1558 \fIname\fR. Microsoft WindowsNT does not provide a system name in its CHAP
1559 Challenge messages, and this option is often used to work around this problem.
1560 .RE
1561 
1562 .sp
1563 .ne 2
1564 .na
1565 \fB\fBrefuse-chap\fR \fR
1566 .ad
1567 .sp .6

   1 '\" te
   2 .\" Copyright (c) 1989 Carnegie Mellon University. All rights reserved.
   3 .\" Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by Carnegie Mellon University.  The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
   4 .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
   5 .\" Portions Copyright (c) 2008, Sun Microsystems, Inc. All Right Reserved.
   6 .TH PPPD 1M "February 5, 2022"
   7 .SH NAME
   8 pppd \- point to point protocol daemon
   9 .SH SYNOPSIS
  10 .nf
  11 \fBpppd\fR [\fItty_name\fR] [\fIspeed\fR] [\fIoptions\fR]
  12 .fi
  13 
  14 .SH DESCRIPTION
  15 The point-to-point protocol (PPP) provides a method for transmitting datagrams
  16 over serial point-to-point links. PPP is composed of three components: a
  17 facility for encapsulating datagrams over serial links, an extensible link
  18 control protocol (LCP), and a family of network control protocols (NCP) for
  19 establishing and configuring different network-layer protocols.
  20 .sp
  21 .LP
  22 The encapsulation scheme is provided by driver code in the kernel. \fBpppd\fR
  23 provides the basic LCP authentication support and several NCPs for establishing
  24 and configuring the Internet Protocol (referred to as the IP Control Protocol
  25 or "IPCP") and IPv6 (IPV6CP).
  26 .SH OPTIONS

1284 .sp
1285 .ne 2
1286 .na
1287 \fB\fBnoproxyarp\fR \fR
1288 .ad
1289 .sp .6
1290 .RS 4n
1291 Disable the \fBproxyarp\fR option. If you want to prevent users from creating
1292 proxy ARP entries with \fBpppd\fR, place this option in the
1293 \fB/etc/ppp/options\fR file.
1294 .RE
1295 
1296 .sp
1297 .ne 2
1298 .na
1299 \fB\fBnotty\fR \fR
1300 .ad
1301 .sp .6
1302 .RS 4n
1303 Normally, \fBpppd\fR requires a terminal device. With this option, \fBpppd\fR
1304 allocates itself a pseudo-terminal pair and uses the subsidiary as its
1305 terminal device. \fBpppd\fR creates a child process to act as a character shunt
1306 to transfer characters between the pseudo-terminal manager and its standard
1307 input and output. Thus, \fBpppd\fR transmits characters on its standard output
1308 and receives characters on its standard input even if they are not terminal
1309 devices. This option increases the latency and CPU overhead of transferring
1310 data over the ppp interface as all of the characters sent and received must
1311 flow through the character shunt process. An explicit device name may not be
1312 given if this option is used.
1313 .RE
1314 
1315 .sp
1316 .ne 2
1317 .na
1318 \fB\fBnovj\fR \fR
1319 .ad
1320 .sp .6
1321 .RS 4n
1322 Disable Van Jacobson style TCP/IP header compression in both the transmit and
1323 the receive direction.
1324 .RE
1325 
1326 .sp
1327 .ne 2
1328 .na

1489 .na
1490 \fB\fBproxyarp\fR \fR
1491 .ad
1492 .sp .6
1493 .RS 4n
1494 Add an entry to the system's Address Resolution Protocol (ARP) table with the
1495 IP address of the peer and the Ethernet address of this system. When you use
1496 this option, the peer appears to other systems to be on the local Ethernet. The
1497 remote address on the PPP link must be in the same subnet as assigned to an
1498 Ethernet interface.
1499 .RE
1500 
1501 .sp
1502 .ne 2
1503 .na
1504 \fB\fBpty\fR \fB \fIscript\fR\fR \fR
1505 .ad
1506 .sp .6
1507 .RS 4n
1508 Specifies that the command \fIscript\fR, and not a specific terminal device is
1509 used for serial communication. \fBpppd\fR allocates itself a pseudo-terminal
1510 pair and uses the subsidiary as its terminal device. \fIscript\fR runs
1511 in a child process with the pseudo-terminal manager as its standard input and
1512 output.  An explicit device name may not be given if this option is used.
1513 (Note: if the \fBrecord\fR option is used in conjunction with the \fBpty\fR
1514 option, the child process will have pipes on its standard input and output.)
1515 .RE
1516 
1517 .sp
1518 .ne 2
1519 .na
1520 \fB\fBreceive-all\fR \fR
1521 .ad
1522 .sp .6
1523 .RS 4n
1524 With this option, \fBpppd\fR accepts all control characters from the peer,
1525 including those marked in the receive \fBasyncmap\fR. Without this option,
1526 \fBpppd\fR discards those characters as specified in \fIRFC 1662\fR. This
1527 option should be used only if the peer has bugs, as is often found with
1528 dial-back implementations.
1529 .RE
1530 
1531 .sp
1532 .ne 2
1533 .na
1534 \fB\fBrecord\fR \fB\fIfilename\fR\fR \fR
1535 .ad
1536 .sp .6
1537 .RS 4n
1538 Directs \fBpppd\fR to record all characters sent and received to a file named
1539 \fIfilename\fR. \fIfilename\fR is opened in append mode, using the user's
1540 user-ID and permissions. Because this option uses a pseudo-terminal and a
1541 process to transfer characters between the pseudo-terminal and the real serial
1542 device, it increases the latency and CPU overhead of transferring data over the
1543 PPP interface. Characters are stored in a tagged format with timestamps that
1544 can be displayed in readable form using the \fBpppdump\fR(1M) program. This
1545 option is generally used when debugging the kernel portion of \fBpppd\fR
1546 (especially CCP compression algorithms) and not for debugging link
1547 configuration problems. See the \fBdebug\fR option.
1548 .RE
1549 
1550 .sp
1551 .ne 2
1552 .na
1553 \fB\fBremotename\fR \fB\fIname\fR\fR \fR
1554 .ad
1555 .sp .6
1556 .RS 4n
1557 Set the assumed name of the remote system for authentication purposes to
1558 \fIname\fR. Microsoft WindowsNT does not provide a system name in its CHAP
1559 Challenge messages, and this option is often used to work around this problem.
1560 .RE
1561 
1562 .sp
1563 .ne 2
1564 .na
1565 \fB\fBrefuse-chap\fR \fR
1566 .ad
1567 .sp .6