📄 rloglib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/rlogLib.html - generated by refgen from rlogLib.c --> <title> rlogLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>rlogLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>rlogLib</strong> - remote login library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b> - initialize the remote login facility<br><b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> - the VxWorks remote login daemon<br><b><a href="./rlogLib.html#rlogin">rlogin</a>( )</b> - log in to a remote host<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library provides a remote login facility for VxWorks based on the UNIX <b><a href="../../bspkit/valTest/rlogin.html#top" >rlogin</a></b> protocol (as implemented in UNIX BSD 4.3). On a VxWorks terminal, this command gives users the ability to log in to remote systems on the network. <p>Reciprocally, the remote login daemon, <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b>, allows remote users to log in to VxWorks. The daemon is started by calling <b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b>, which is called automatically when <b>INCLUDE_RLOGIN</b> is defined. The remote login daemon accepts remote login requests from another VxWorks or UNIX system, and causes the shell's input and output to be redirected to the remote user.<p>Internally, <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> provides a tty-like interface to the remoteuser through the use of the VxWorks pseudo-terminal driver <b><a href="./ptyDrv.html#top">ptyDrv</a></b>.<p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>rlogLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><p><b><a href="./ptyDrv.html#top">ptyDrv</a></b>, <b>telnetLib</b>, UNIX BSD 4.3 manual entries for <b><a href="../../bspkit/valTest/rlogin.html#top" >rlogin</a></b>, <b>rlogind</b>, and <b>pty</b><hr><a name="rlogInit"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>rlogInit( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>rlogInit( )</strong> - initialize the remote login facility</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS rlogInit (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine initializes the remote login facility. It creates a pty (pseudo tty) device and spawns <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b>. If <b>INCLUDE_RLOGIN</b> is included,<b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b> is called automatically at boot time.<p></blockquote><h4>VXWORKS AE PROTECTION DOMAINS</h4><blockquote><p>Under VxWorks AE, you can call this function from within the kernel protection domain only. This restriction does not apply under non-AE versions of VxWorks. <p></blockquote><h4>RETURNS</h4><blockquote><p>OK or ERROR.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./rlogLib.html#top">rlogLib</a></b>, <b><a href="./ptyDrv.html#top">ptyDrv</a></b><hr><a name="rlogind"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>rlogind( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>rlogind( )</strong> - the VxWorks remote login daemon</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void rlogind (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine provides a facility for remote users to log in to VxWorks overthe network. If <b>INCLUDE_RLOGIN</b> is defined, <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> is spawned by<b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b> at boot time.<p>Remote login requests will cause <b>stdin</b>, <b>stdout</b>, and <b>stderr</b> to bedirected away from the console. When the remote user disconnects,<b>stdin</b>, <b>stdout</b>, and <b>stderr</b> are restored, and the shell is restarted.The <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> routine uses the remote user verification protocol specifiedby the UNIX remote shell daemon documentation, but ignores all theinformation except the user name, which is used to set the VxWorks remoteidentity (see the manual entry for <b><a href="./remLib.html#iam">iam</a>( )</b>).<p>The remote login daemon requires the existence of a pseudo-terminaldevice, which is created by <b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b> before <b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> is spawned. The<b><a href="./rlogLib.html#rlogind">rlogind</a>( )</b> routine creates two child processes, <b>tRlogInTask</b> and<b>tRlogOutTask</b>, whenever a remote user is logged in. These processes exitwhen the remote connection is terminated.<p></blockquote><h4>VXWORKS AE PROTECTION DOMAINS</h4><blockquote><p>Under VxWorks AE, you can call this function from within the kernel protection domain only. In addition, all arguments to this function can reference only that data which is valid in the kernel protection domain. This restriction does not apply under non-AE versions of VxWorks. <p></blockquote><h4>RETURNS</h4><blockquote><p>N/A<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./rlogLib.html#top">rlogLib</a></b>, <b><a href="./rlogLib.html#rlogInit">rlogInit</a>( )</b>, <b><a href="./remLib.html#iam">iam</a>( )</b><hr><a name="rlogin"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>rlogin( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>rlogin( )</strong> - log in to a remote host</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS rlogin ( char * host /* name of host to connect to */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine allows users to log in to a remote host. It may be called fromthe VxWorks shell as follows:<pre> -> rlogin "remoteSystem"</pre>where <i>remoteSystem</i> is either a host name, which has been previously addedto the remote host table by a call to <b><a href="./hostLib.html#hostAdd">hostAdd</a>( )</b>, or an Internet address indot notation (e.g., "90.0.0.2"). The remote system will be logged intowith the current user name as set by a call to <b><a href="./remLib.html#iam">iam</a>( )</b>.<p>The user disconnects from the remote system by typing:<pre> ~.</pre>as the only characters on the line, or by simply logging out from the remotesystem using <b><a href="./usrLib.html#logout">logout</a>( )</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p><p>OK, or ERROR if the host is unknown, no privileged ports are available,the routine is unable to connect to the host, or the child process cannotbe spawned.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./rlogLib.html#top">rlogLib</a></b>, <b><a href="./remLib.html#iam">iam</a>( )</b>, <b><a href="./usrLib.html#logout">logout</a>( )</b></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -