ppplib.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

char *<b>pap_passwd</b>
<dd>
Set the password for PAP authentication with the peer to the specified string.
<dt>
char *<b>pap_restart</b>
<dd>
Set the timeout in seconds for PAP negotiation to the specified string.
<dt>
char *<b>pap_max_authreq</b>
<dd>
Set the maximum number of transmissions for PAP authentication
requests to the specified string.
<dt>
char *<b>chap_file</b>
<dd>
Get CHAP secrets from the specified file.  This option is necessary
if either peer requires CHAP authentication.
<dt>
char *<b>chap_restart</b>
<dd>
Set the timeout in seconds for CHAP negotiation to the specified string.
<dt>
char *<b>chap_interval</b>
<dd>
Set the interval in seconds for CHAP rechallenge to the specified string.
<dt>
char *<b>chap_max_challenge</b>
<dd>
Set the maximum number of transmissions for CHAP challenge to the
specified string.
</dl>

</blockquote><h4>CONFIGURATION OPTIONS FILE</h4><blockquote><p>
<p>
The optional parameter <i>fOptions</i> specifies configuration options for
the PPP link.  If NULL, this parameter is ignored, otherwise it
is assumed to be the name of a configuration options file.  The format
of the options file is one option per line; comment lines start with "#".
The following options are recognized:
<dl>
<dt>
<b>no_all</b>
<dd>
Do not request/allow any options.
<dt>
<b>passive_mode</b>
<dd>
Set passive mode.
<dt>
<b>silent_mode</b>
<dd>
Set silent mode.
<dt>
defaultroute
<dd>
Add default route.
<dt>
proxyarp
<dd>
Add proxy ARP entry.
<dt>
<b>ipcp_accept_local</b>
<dd>
Accept peer's idea of the local IP address.
<dt>
<b>ipcp_accept_remote</b>
<dd>
Accept peer's idea of the remote IP address.
<dt>
<b>no_ip</b>
<dd>
Disable IP address negotiation.
<dt>
<b>no_acc</b>
<dd>
Disable address/control compression.
<dt>
<b>no_pc</b>
<dd>
Disable protocol field compression.
<dt>
<b>no_vj</b>
<dd>
Disable VJ (Van Jacobson) compression.
<dt>
<b>no_vjccomp</b>
<dd>
Disable VJ (Van Jacobson) connnection ID compression.
<dt>
<b>no_asyncmap</b>
<dd>
Disable async map negotiation.
<dt>
<b>no_mn</b>
<dd>
Disable magic number negotiation.
<dt>
<b>no_mru</b>
<dd>
Disable MRU (Maximum Receive Unit) negotiation.
<dt>
<b>no_pap</b>
<dd>
Do not allow PAP authentication with peer.
<dt>
<b>no_chap</b>
<dd>
Do not allow CHAP authentication with peer.
<dt>
<b>require_pap</b>
<dd>
Require PAP authentication with peer.
<dt>
<b>require_chap</b>
<dd>
Require CHAP authentication with peer.
<dt>
login
<dd>
Use the login password database for PAP authentication of peer.
<dt>
debug
<dd>
Enable PPP daemon debug mode.
<dt>
<b>driver_debug</b>
<dd>
Enable PPP driver debug mode.
<dt>
asyncmap <i>value</i>
<dd>
Set the desired async map to the specified value.
<dt>
<b>escape_chars</b> <i>value</i>
<dd>
Set the chars to escape on transmission to the specified value.
<dt>
<b>vj_max_slots</b> <i>value</i>
<dd>
Set maximum number of VJ compression header slots to the specified value.
<dt>
netmask <i>value</i>
<dd>
Set netmask value for negotiation to the specified value.
<dt>
mru <i>value</i>
<dd>
Set MRU value for negotiation to the specified value.
<dt>
mtu <i>value</i>
<dd>
Set MTU value for negotiation to the specified value.
<dt>
<b>lcp_echo_failure</b> <i>value</i>
<dd>
Set the maximum consecutive LCP echo failures to the specified value.
<dt>
<b>lcp_echo_interval</b> <i>value</i>
<dd>
Set the interval in seconds between LCP echo requests to the specified value.
<dt>
<b>lcp_restart</b> <i>value</i>
<dd>
Set the timeout in seconds for the LCP negotiation to the specified value.
<dt>
<b>lcp_max_terminate</b> <i>value</i>
<dd>
Set the maximum number of transmissions for LCP termination requests
to the specified value.
<dt>
<b>lcp_max_configure</b> <i>value</i>
<dd>
Set the maximum number of transmissions for LCP configuration
requests to the specified value.
<dt>
<b>lcp_max_failure</b> <i>value</i>
<dd>
Set the maximum number of LCP configuration NAKs to the specified value.
<dt>
<b>ipcp_restart</b> <i>value</i>
<dd>
Set the timeout in seconds for IPCP negotiation to the specified value.
<dt>
<b>ipcp_max_terminate</b> <i>value</i>
<dd>
Set the maximum number of transmissions for IPCP termination requests
to the specified value.
<dt>
<b>ipcp_max_configure</b> <i>value</i>
<dd>
Set the maximum number of transmissions for IPCP configuration requests
to the specified value.
<dt>
<b>ipcp_max_failure</b> <i>value</i>
<dd>
Set the maximum number of IPCP configuration NAKs to the specified value.
<dt>
<b>local_auth_name</b> <i>name</i>
<dd>
Set the local name for authentication to the specified name.
<dt>
<b>remote_auth_name</b> <i>name</i>
<dd>
Set the remote name for authentication to the specified name.
<dt>
<b>pap_file</b> <i>file</i>
<dd>
Get PAP secrets from the specified file.  This option is necessary
if either peer requires PAP authentication.
<dt>
<b>pap_user_name</b> <i>name</i>
<dd>
Set the user name for PAP authentication with the peer to the specified name.
<dt>
-
<dd>
Set the password for PAP authentication with the peer to the specified
password.
<dt>
<b>pap_restart</b> <i>value</i>
<dd>
Set the timeout in seconds for PAP negotiation to the specified value.
<dt>
<b>pap_max_authreq</b> <i>value</i>
<dd>
Set the maximum number of transmissions for PAP authentication
requests to the specified value.
<dt>
<b>chap_file</b> <i>file</i>
<dd>
Get CHAP secrets from the specified file.  This option is necessary
if either peer requires CHAP authentication.
<dt>
<b>chap_restart</b> <i>value</i>
<dd>
Set the timeout in seconds for CHAP negotiation to the specified value.
<dt>
<b>chap_interval</b> <i>value</i>
<dd>
Set the interval in seconds for CHAP rechallenge to the specified value.
<dt>
<b>chap_max_challenge</b> <i>value</i>
<dd>
Set the maximum number of transmissions for CHAP challenge to the
specified value.
</dl>

</blockquote><h4>AUTHENTICATION</h4><blockquote><p>
<p>
The VxWorks PPP implementation supports two separate user authentication
protocols: the Password Authentication Protocol (PAP) and the
Challenge-Handshake Authentication Protocol (CHAP).  If authentication is
required by either peer, it must be satisfactorily completed before the
PPP link becomes fully operational.  If authentication fails, the link
will be automatically terminated.
<p>
</blockquote><h4>EXAMPLES</h4><blockquote><p>
<p>
The following routine initializes a PPP interface that uses the
target's second serial port (<b>/tyCo/1</b>).  The local IP address is
90.0.0.1; the IP address of the remote peer is 90.0.0.10.  The baud
rate is the default rate for the <i>tty</i> device.  VJ compression
and authentication have been disabled, and LCP echo requests have been
enabled.
<p>
<pre>PPP_OPTIONS pppOpt;   /* PPP configuration options */

void routine ()
    {
    pppOpt.flags = OPT_PASSIVE_MODE | OPT_NO_PAP | OPT_NO_CHAP | OPT_NO_VJ;
    pppOpt.lcp_echo_interval = "30";
    pppOpt.lcp_echo_failure = "10";

    pppInit (0, "/tyCo/1", "90.0.0.1", "90.0.0.10", 0, &amp;pppOpt, NULL);
    }
</pre>

The following routine generates the same results as the previous example.
The difference is that the configuration options are obtained from
a file rather than a structure.
<p>
<pre>pppFile = "phobos:/tmp/ppp_options";  /* PPP configuration options file */

void routine ()
    {
    pppInit (0, "/tyCo/1", "90.0.0.1", "90.0.0.10", 0, NULL, pppFile);
    }
</pre>
where phobos:/tmp/<b>ppp_options</b> contains:
<p>
<pre>    passive
    no_pap
    no_chap
    no_vj
    lcp_echo_interval 30
    lcp_echo_failure 10
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
OK, or ERROR if the PPP interface cannot be initialized because the
daemon task cannot be spawned or memory is insufficient.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./pppLib.html#top">pppLib</a></b>, <b><a href="./pppShow.html#top">pppShow</a></b>, <b><a href="./pppLib.html#pppDelete">pppDelete</a>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Network</i>

<hr>
<a name="pppDelete"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>pppDelete(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>pppDelete(&nbsp;)</strong> - delete a PPP network interface</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void pppDelete
    (
    int unit                  /* PPP interface unit number to delete */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine deletes the Point-to-Point Protocol (PPP) network interface
specified by the unit number <i>unit</i>.
<p>
A Link Control Protocol (LCP) terminate request packet is sent to notify
the peer of the impending PPP link shut-down.  The associated serial
interface (<i>tty</i>) is then detached from the PPP driver, and the PPP interface
is deleted from the list of network interfaces.  Finally, all resources
associated with the PPP link are returned to the VxWorks system.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./pppLib.html#top">pppLib</a></b>

</body>
</html>