📄 pppsecretlib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/pppSecretLib.html - generated by refgen from pppSecretLib.c --> <title> pppSecretLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>VxWorks Reference Manual : Libraries</i></a></p></blockquote><h1>pppSecretLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>pppSecretLib</strong> - PPP authentication secrets library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><i><a href="./pppSecretLib.html#pppSecretAdd">pppSecretAdd</a></i>( )</b> - add a secret to the PPP authentication secrets table<br><b><i><a href="./pppSecretLib.html#pppSecretDelete">pppSecretDelete</a></i>( )</b> - delete a secret from the PPP authentication secrets table<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library provides routines to create and manipulate a table of"secrets" for use with Point-to-Point Protocol (PPP) user authenticationprotocols. The secrets in the secrets table can be searched by peers ona PPP link so that one peer (client) can send a secret word to the otherpeer (server). If the client cannot find a suitable secret whenrequired to do so, or the secret received by the server is notvalid, the PPP link may be terminated.<p>This library is automatically linked into the VxWorks system image whenthe configuration macro <b>INCLUDE_PPP</b> is defined.<p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>pppLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./pppSecretLib.html#top">pppSecretLib</a></b>, <b><a href="./pppLib.html#top">pppLib</a></b>, <b><a href="./pppShow.html#top">pppShow</a></b>, <i>VxWorks Programmer's Guide: Network</i><hr><a name="pppSecretAdd"></a><p align=right><a href="rtnIndex.html"><i>Libraries : Routines</i></a></p></blockquote><h1><i>pppSecretAdd</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>pppSecretAdd</i>( )</strong> - add a secret to the PPP authentication secrets table</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS pppSecretAdd ( char * client, /* client being authenticated */ char * server, /* server performing authentication */ char * secret, /* secret used for authentication */ char * addrs /* acceptable client IP addresses */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine adds a secret to the Point-to-Point Protocol (PPP)authentication secrets table. This table may be used by thePassword Authentication Protocol (PAP) and Challenge-HandshakeAuthentication Protocol (CHAP) user authentication protocols.<p>When a PPP link is established, a "server" may require a "client" toauthenticate itself using a "secret". Clients and servers obtainauthentication secrets by searching secrets files, or by searchingthe secrets table constructed by this routine. Clients and serverssearch the secrets table by matching client and server names with tableentries, and retrieving the associated secret.<p>Client and server names in the table consisting of "*" are consideredwildcards; they serve as matches for any client and/or server name ifan exact match cannot be found.<p>If <i>secret</i> starts with "@", <i>secret</i> is assumed to be the name of a file,wherein the actual secret can be read.<p>If <i>addrs</i> is not NULL, it should contain a list of acceptable client IPaddresses. When a server is authenticating a client and the client'sIP address is not contained in the list of acceptable addresses,the link is terminated. Any IP address will be considered acceptableif <i>addrs</i> is NULL. If this parameter is "-", all IP addresses aredisallowed.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR if the secret cannot be added to the table.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./pppSecretLib.html#top">pppSecretLib</a></b>, <b><i><a href="./pppSecretLib.html#pppSecretDelete">pppSecretDelete</a></i>( )</b>, <b><i><a href="./pppShow.html#pppSecretShow">pppSecretShow</a></i>( )</b><hr><a name="pppSecretDelete"></a><p align=right><a href="rtnIndex.html"><i>Libraries : Routines</i></a></p></blockquote><h1><i>pppSecretDelete</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>pppSecretDelete</i>( )</strong> - delete a secret from the PPP authentication secrets table</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS pppSecretDelete ( char * client, /* client being authenticated */ char * server, /* server performing authentication */ char * secret /* secret used for authentication */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine deletes a secret from the Point-to-Point Protocol (PPP)authentication secrets table. When searching for a secret to deletefrom the table, the wildcard substitution (using "*") is not performed forclient and/or server names. The <i>client</i>, <i>server</i>, and <i>secret</i>strings must match the table entry exactly in order to be deleted.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK, or ERROR if the table entry being deleted is not found.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./pppSecretLib.html#top">pppSecretLib</a></b>, <b><i><a href="./pppSecretLib.html#pppSecretAdd">pppSecretAdd</a></i>( )</b>, <b><i><a href="./pppShow.html#pppSecretShow">pppSecretShow</a></i>( )</b></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -