Last-modified: 1993/01/18 Version: 1.0 Filename: PPP-commands Modified-by: Richard Akerman (akerman@qucis.queensu.ca) ppp ... These commands are used to configure Point to Point Protocol interfaces. This implementation of PPP is designed to be as complete as pos- sible. Because of this, the number of options can be rather daunting. However, a typical PPP configuration might include the following commands: attach asy 0x3f8 4 ppp pp0 4096 1500 9600 dial pp0 30 3 dialer.pp0 # ppp pp0 lcp local accm 0 ppp pp0 lcp local compress address on ppp pp0 lcp local compress protocol on ppp pp0 lcp local magic on ppp pp0 lcp open active # ppp pp0 ipcp local compress tcp 16 1 ppp pp0 ipcp open active # route add default pp0 ppp Display the status of the PPP interface. ppp lcp ... These commands are used for the LCP [Link Control Protocol] con- figuration. ppp lcp close Shutdown the PPP interface. ppp lcp local ... These commands control the configuration of the local side of the link. If an option is specified, the parameters will be used as the initial values in configuration requests. If not specified, that option will not be requested. For each of these options, the allow parameter will permit the remote to include that option in its response, even when the option is not included in the request. By default, all options are allowed. ppp lcp local accm [ | allow [on | off] ] Display or set the Async Control Character Map. The default is 0xffffffff. ppp lcp local authenticate [ pap | none | allow [on | off] ] Display or set the authentication protocol. The default is none. ppp lcp local compress address/control [ on | off | allow [on | off] ] Display or set the option to compress the address and control fields of the PPP HLDC-like header. This is generally desirable for slow asynchronous links, and undesirable for fast or synchro- nous links. The default is off. ppp lcp local compress protocol [ on | off | allow [on | off] ] Display or set the option to compress the protocol field of the PPP HLDC-like header. This is generally desirable for slow asyn- chronous links, and undesirable for fast or synchronous links. The default is off. ppp lcp local magic [ on | off | | allow [on | off] ] Display or set the initial Magic Number. The default is off (zero). ppp lcp local mru [ | allow [on | off] ] Display or set the Maximum Receive Unit. The default is 1500. ppp lcp local default Reset the options to their default values. ppp lcp open active | passive Wait for the physical layer to come up. If active, initiate con- figuration negotiation. If passive, wait for configuration nego- tiation from the remote. ppp lcp remote ... These commands control the configuration of the remote side of the link. The options are identical to those of the local side. If an option is specified, the parameters will be used in responses to the remote's configuration requests. If not speci- fied, that option will be accepted if it is allowed. For each of these options, the allow parameter will permit the remote to specify that option in its request. By default, all options are allowed. ppp lcp timeout [] Display or set the interval to wait between configuration or ter- mination attempts. The default is 3 seconds. ppp lcp try ... These commands are used for the various counters. ppp lcp try configure [] Display or set the number of configuration requests sent. The default is 10. ppp lcp try failure [] Display or set the number of bad configuration requests allowed from the remote. The default is 5. ppp lcp try terminate [] Display or set the number of termination requests sent before shutdown. The default is 2. ppp ipcp ... These commands are used for the IPCP [Internet Protocol Control Protocol] configuration. The close, open, timeout and try sub-commands are identical to the LCP (described above). ppp ipcp local ... These commands control the configuration of the local side of the link. If an option is specified, the parameters will be used as the initial values in configuration requests. If not specified, that option will not be requested. For each of these options, the allow parameter will permit the remote to include that option in its response, even when the option is not included in the request. By default, all options are allowed. ppp ipcp local address [ | allow [on | off] ] Display or set the local address for negotiation purposes. If an address of 0 is specified, the other side of the link will supply the address. By default, no addresses are negotiated. ppp ipcp local compress [ tcp [] | none | allow [on | off] ] Display or set the compression protocol. The default is none. The tcp specifies the number of "conversation" slots, which must be 1 to 255. (This may be limited at compilation time to a smaller number.) A good choice is in the range 4 to 16. The tcp is 0 (don't compress the slot number) or 1 (OK to compress the slot number). KA9Q can handle compressed slot numbers, so the default is 1. ppp ipcp remote ... These commands control the configuration of the remote side of the link. The options are identical to those of the local side. If an option is specified, the parameters will be used in responses to the remote's configuration requests. If not speci- fied, that option will be accepted if it is allowed. For each of these options, the allow parameter will permit the remote to specify that option in its request. By default, all options are allowed. ppp pap ... These commands are used for the PAP [Password Authentication Pro- tocol] configuration. The timeout and try sub-commands are identical to the LCP (described above). However, the terminate counter is unused. ppp pap user [ [] ] Display or set the username (the password may be set, but not displayed). When the username is specified, but no password is supplied, the ftpusers file is searched for the password. When a username/password is unknown or rejected, a session will appear at the console to prompt for a new username/password. ppp trace [] Display or set the flags that control the logging of information during PPP link configuration. The flag value is 0 for none, 1 for basic, and 2 for general. Values greater than 2 are usually not compiled, and are described in the appropriate source files where they are defined.