loginlib.html

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

</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the specified user or password is incorrect.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>

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

</blockquote><h1>loginUserVerify(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginUserVerify(&nbsp;)</strong> - verify a user name and password in the login table</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS loginUserVerify
    (
    char * name,              /* name of user */
    char * passwd             /* password of user */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine verifies a user entry in the login table.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the user name or password is not found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>

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

</blockquote><h1>loginUserShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginUserShow(&nbsp;)</strong> - display the user login table</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void loginUserShow (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays valid user names.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>    -&gt; loginUserShow ()

      User Name
      =========
      peter
      robin
    value = 0 = 0x0
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>

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

</blockquote><h1>loginPrompt(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginPrompt(&nbsp;)</strong> - display a login prompt and validate a user entry</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS loginPrompt
    (
    char * userName           /* user name, ask if NULL or not provided */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays a login prompt and validates a user entry.  If both
user name and password match with an entry in the login table, the user is
then given access to the VxWorks system.  Otherwise, it prompts the user
again.
<p>
All control characters are disabled during authentication except CTRL-D,
which will terminate the remote login session.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK if the name and password are valid, or ERROR if there is an
EOF or the routine times out.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>

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

</blockquote><h1>loginStringSet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginStringSet(&nbsp;)</strong> - change the login string</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void loginStringSet
    (
    char * newString          /* string to become new login prompt */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine changes the login prompt string to <i>newString</i>.
The maximum string length is 80 characters.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>

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

</blockquote><h1>loginEncryptInstall(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginEncryptInstall(&nbsp;)</strong> - install an encryption routine</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void loginEncryptInstall
    (
    FUNCPTR rtn,              /* function pointer to encryption routine */
    int     var               /* argument to the encryption routine (unused) */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine allows the user to install a custom encryption routine.
The custom routine <i>rtn</i> must be of the following form: 
<pre>STATUS encryptRoutine
       (
       char *password,               /* string to encrypt    */
       char *encryptedPassword       /* resulting encryption */
       )
</pre>
When a custom encryption routine is installed, a host version of
this routine must be written to replace the tool vxencrypt
in <b>host/<i>hostOs</i>/bin</b>.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
The custom example above could be installed as follows:
<pre>#ifdef INCLUDE_SECURITY
    loginInit ();                               /* initialize login table   */
    shellLoginInstall (loginPrompt, NULL);      /* install shell security   */
    loginEncryptInstall (encryptRoutine, NULL); /* install encrypt. routine */
#endif
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>, <b><a href="./loginLib.html#loginDefaultEncrypt">loginDefaultEncrypt</a>(&nbsp;)</b>, <b><a href="../../tornado/hutils/vxencrypt.html#top" >vxencrypt</a></b>

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

</blockquote><h1>loginDefaultEncrypt(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>loginDefaultEncrypt(&nbsp;)</strong> - default password encryption routine</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS loginDefaultEncrypt
    (
    char * in,                /* input string */
    char * out                /* encrypted string */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides default encryption for login passwords.  It employs
a simple encryption algorithm.  It takes as arguments a string <i>in</i> and a
pointer to a buffer <i>out</i>.  The encrypted string is then stored in the
buffer.
<p>
The input strings must be at least 8 characters and no more than 40
characters.
<p>
If a more sophisticated encryption algorithm is needed, this routine can
be replaced, as long as the new encryption routine retains the same
declarations as the default routine.  The routine vxencrypt
in <b>host/<i>hostOs</i>/bin</b>
should also be replaced by a host version of <i>encryptionRoutine</i>.  For more
information, see the manual entry for <b><a href="./loginLib.html#loginEncryptInstall">loginEncryptInstall</a>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the password is invalid.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./loginLib.html#top">loginLib</a></b>, <b><a href="./loginLib.html#loginEncryptInstall">loginEncryptInstall</a>(&nbsp;)</b>, <b><a href="../../tornado/hutils/vxencrypt.html#top" >vxencrypt</a></b>
<p>


</body>
</html>