Return to ppp CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/ppp, revision 1.1.1.1

1.1       root        1: .TH PPP 1
                      2: .SH NAME
                      3: pppclient, pppserver \- point to point protocol
                      4: .SH SYNOPSIS
                      5: .B pppclient
                      6: [
                      7: .B -d
                      8: ][
                      9: .B -b
                     10: .I baudrate
                     11: ][
                     12: .B -i
                     13: .I myipaddr
                     14: ][
                     15: .B -p
                     16: .I peeripaddr
                     17: ][
                     18: .I dialdevice
                     19: ]
                     20: .PP
                     21: .B pppserver
                     22: [
                     23: .B -d
                     24: ]
                     25: .I ndev
                     26: .I myipaddr
                     27: .I firstipaddr
                     28: .I firstdev
                     29: [
                     30: .I baud0 baud1 ...
                     31: ]
                     32: .SH DESCRIPTION
                     33: The Point to Point Protocol is used to encapsulate Internet Protocol packets
                     34: for transfer over serial lines or other protocol connections.
                     35: .PP
                     36: .I Pppclient
                     37: makes a connection to a PPP server and
                     38: passes IP packets over the connection.
                     39: If
                     40: .I dialdevice
                     41: is omitted, standard input and output are used as the connection.
                     42: If
                     43: .I dialdevice
                     44: begins with a 
                     45: slash,
                     46: .I pppclient
                     47: assumes it is a file name,
                     48: .IR open (2)'s
                     49: it, and uses the result as the connection.
                     50: Otherwise,
                     51: .I dialdevice
                     52: is passed as the
                     53: destination address to
                     54: .IR dial (2)
                     55: to set up the connection.
                     56: .PP
                     57: If the connection is successful,
                     58: .I pppclient
                     59: creates a pipe, pushes the IP line discipline onto it, and sets the
                     60: local and remote addresses of the IP interface to
                     61: .I myipaddr
                     62: and
                     63: .IR peeripaddr.
                     64: It then loops transferring packets between the pipe and the connection.
                     65: If either
                     66: .I myipaddr
                     67: or
                     68: .I peeripaddr
                     69: is omitted,
                     70: .I pppclient
                     71: requests them from the server.
                     72: .PP
                     73: The options are
                     74: .RS
                     75: .TP
                     76: .B d
                     77: print debugging information.
                     78: .TP
                     79: .B b
                     80: baud rate of the serial line.
                     81: .TP
                     82: .B p
                     83: peer ip address (in case the peer asks for its ip address over IPCP).
                     84: .TP
                     85: .B i
                     86: the local ip address to be established for this connection.
                     87: .RE
                     88: .PP
                     89: .I Pppserver
                     90: treats serial lines as PPP connections, switching packets between
                     91: them and the local machine.
                     92: It creates a pipe for a local IP interface (address
                     93: .IR myipaddr ),
                     94: opens a set of serial lines,
                     95: and switches packets between the local interface
                     96: and the serial lines.
                     97: .I Ndev
                     98: specifies the number of serial devices to serve.
                     99: The devices are named
                    100: .BI /dev/eia{ firstdev }
                    101: through 
                    102: .BI /dev/eia{ firstdev+ndev\-1 }\f1.
                    103: Their remote IP addresses are
                    104: .I firstipaddr
                    105: through 
                    106: .IR firstipaddr+ndev\-1 .
                    107: The default baud rate is 9600.
                    108: If any arguments follow
                    109: .I firstdev
                    110: .RI ( baud0 ,
                    111: .IR baud1 ,
                    112: \&...), they are used as baud rates for the serial lines.
                    113: The only option,
                    114: .BR -d ,
                    115: turns on debugging output.
                    116: .PP
                    117: Both
                    118: .I pppclient
                    119: and 
                    120: .I pppserver
                    121: accept all options defined in RFCs 1331 and 1332.
                    122: .SH EXAMPLES
                    123: .PP
                    124: Start up a server for serial lines
                    125: .BR /dev/eia[2-6] 
                    126: with remote IP addresses 131.107.1.100 through
                    127: 131.107.1.103 and baud rates of
                    128: 19200, 2400, 9600, 9600.
                    129: The local IP address is 131.107.1.1.
                    130: .IP
                    131: .EX
                    132: pppserver 4 131.107.1.1 131.107.1.100 2 19200 2400
                    133: .EE
                    134: .SH SOURCE
                    135: .B /sys/src/cmd/ppp

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.