mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 00:41:08 +00:00
169 lines
9.3 KiB
HTML
169 lines
9.3 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
|
||
|
|
<HTML><HEAD>
|
||
|
|
<TITLE>Administration Reference</TITLE>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
|
||
|
|
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
|
||
|
|
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
|
||
|
|
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
|
||
|
|
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
|
||
|
|
</HEAD><BODY>
|
||
|
|
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
|
||
|
|
<BODY bgcolor="ffffff">
|
||
|
|
<!-- End Header Records ============================================ -->
|
||
|
|
<A NAME="Top_Of_Page"></A>
|
||
|
|
<H1>Administration Reference</H1>
|
||
|
|
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf230.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf232.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
|
||
|
|
<P>
|
||
|
|
<H2><A NAME="HDRRXDEBUG" HREF="auarf002.htm#ToC_245">rxdebug</A></H2>
|
||
|
|
<A NAME="IDX5440"></A>
|
||
|
|
<A NAME="IDX5441"></A>
|
||
|
|
<A NAME="IDX5442"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Provides debugging trace of Rx activity
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>rxdebug -servers</B> <<VAR>server machine</VAR>> [<B>-port</B> <<VAR>IP port</VAR>>] [<B>-nodally</B>]
|
||
|
|
[<B>-allconnections</B>] [<B>-rxstats</B>] [<B>-onlyserver</B>] [<B>-onlyclient</B>]
|
||
|
|
[<B>-onlyport</B> <<VAR>show only <port></VAR>>] [<B>-onlyhost</B> <<VAR>show only <host></VAR>>]
|
||
|
|
[<B>-onlyauth</B> <<VAR>show only <auth level></VAR>>] [<B>-version</B>] [<B>-noconns</B>]
|
||
|
|
[<B>-peers</B>] [<B>-help</B>]
|
||
|
|
|
||
|
|
<B>rxdebug -s</B> <<VAR>server machine</VAR>> [<B>-po</B> <<VAR>IP port</VAR>>] [<B>-nod</B>] [<B>-a</B>] [<B>-r</B>]
|
||
|
|
[<B>-onlys</B>] [<B>-onlyc</B>] [<B>-onlyp</B> <<VAR>show only <port></VAR>>]
|
||
|
|
[<B>-onlyh</B> <<VAR>show only <host></VAR>>] [<B>-onlya</B> <<VAR>show only <auth level></VAR>>]
|
||
|
|
[<B>-v</B>] [<B>-noc</B>] [<B>-pe</B>] [<B>-h</B>]
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>rxdebug</B> command provides a trace of Rx activity for the
|
||
|
|
server or client machine named by the <B>-servers</B> argument. Rx
|
||
|
|
is AFS's proprietary remote procedure call (RPC) protocol, so this
|
||
|
|
command enables the issuer to check the status of communication between the
|
||
|
|
Cache Manager or an AFS server process (as specified with the <B>-port</B>
|
||
|
|
argument) on the machine and one or more processes on other machines.
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-servers
|
||
|
|
</B><DD>Specifies the machine that is running the Cache Manager or server process
|
||
|
|
for which to trace Rx activity. Provide the machine's IP address
|
||
|
|
in dotted decimal format, its fully qualified host name (for example,
|
||
|
|
<B>fs1.abc.com</B>), or the shortest abbreviated form of its
|
||
|
|
host name that distinguishes it from other machines. Successful use of
|
||
|
|
an abbreviated form depends on the availability of a name resolution service
|
||
|
|
(such as the Domain Name Service or a local host table) at the time the
|
||
|
|
command is issued.
|
||
|
|
<P><DT><B>-port
|
||
|
|
</B><DD>Specifies the process for which to trace Rx activity. Omit this
|
||
|
|
argument to specify the File Server (<B>fileserver</B> process), or
|
||
|
|
provide one of the following values:
|
||
|
|
<DL>
|
||
|
|
<DD><P><B>7000</B> for the File Server (<B>fileserver</B> process)
|
||
|
|
<DD><P><B>7001</B> for the Cache Manager (specifically, its callback
|
||
|
|
interface)
|
||
|
|
<DD><P><B>7002</B> for the Protection Server (<B>ptserver</B> process)
|
||
|
|
<DD><P><B>7003</B> for the Volume Location (VL) Server (<B>vlserver</B>
|
||
|
|
process)
|
||
|
|
<DD><P><B>7004</B> for the Authentication Server (<B>kaserver</B>
|
||
|
|
process)
|
||
|
|
<DD><P><B>7005</B> for the Volume Server (<B>volserver</B> process)
|
||
|
|
<DD><P><B>7007</B> for the BOS Server (<B>bosserver</B> process)
|
||
|
|
<DD><P><B>7008</B> for the Update Server (<B>upserver</B> process)
|
||
|
|
<DD><P><B>7009</B> for the NFS/AFS Translator's <B>rmtsysd</B>
|
||
|
|
daemon
|
||
|
|
<DD><P><B>7021</B> for the Backup Server (<B>buserver</B> process)
|
||
|
|
<DD><P><B>7025</B> through <B>65535</B> for the Backup Tape Coordinator
|
||
|
|
(<B>butc</B> process) that has the port offset number derived by
|
||
|
|
subtracting 7025 from this value
|
||
|
|
</DL>
|
||
|
|
<P><DT><B>-nodally
|
||
|
|
</B><DD>Produces output only for connections that are not in dally mode.
|
||
|
|
<P><DT><B>-allconnections
|
||
|
|
</B><DD>Produces output for all connections, even inactive ones. By
|
||
|
|
default, the output includes information only for connections that are active
|
||
|
|
or in dally mode when the <B>rxdebug</B> command is issued.
|
||
|
|
<P><DT><B>-rxstats
|
||
|
|
</B><DD>Produces detailed statistics about Rx history and performance (for
|
||
|
|
example, counts of the number of packets of various types the process has read
|
||
|
|
and sent, calculations of average and minimum roundtrip time, and so
|
||
|
|
on).
|
||
|
|
<P><DT><B>-onlyserver
|
||
|
|
</B><DD>Produces output only for connections in which the process designated by
|
||
|
|
the <B>-port</B> argument is acting as the server.
|
||
|
|
<P><DT><B>-onlyclient
|
||
|
|
</B><DD>Produces output only for connections in which the process designated by
|
||
|
|
the <B>-port</B> argument is acting as the client.
|
||
|
|
<P><DT><B>-onlyport
|
||
|
|
</B><DD>Produces output only for connections between the process designated by the
|
||
|
|
<B>-port</B> argument and the specified port on any another
|
||
|
|
machine. Use the same port identifiers as for the <B>-port</B>
|
||
|
|
argument.
|
||
|
|
<P><DT><B>-onlyhost
|
||
|
|
</B><DD>Produces output only for connections between the process designated by the
|
||
|
|
<B>-port</B> argument and any process on the specified machine. To
|
||
|
|
identify the machine, use the same notation as for the <B>-servers</B>
|
||
|
|
argument.
|
||
|
|
<P><DT><B>-onlyauth
|
||
|
|
</B><DD>Produces output only for connections that are using the specified
|
||
|
|
authentication level. Provide one of the following values:
|
||
|
|
<UL>
|
||
|
|
<P><LI><B>auth</B> for connections at authentication level
|
||
|
|
<B>rxkad_auth</B>
|
||
|
|
<P><LI><B>clear</B> for connections at authentication level
|
||
|
|
<B>rxkad_clear</B>
|
||
|
|
<P><LI><B>crypt</B> for connections at authentication level
|
||
|
|
<B>rxkad_crypt</B>
|
||
|
|
<P><LI><B>none</B> for unauthenticated connections (equivalents are
|
||
|
|
<B>null</B>, <B>noauth</B>, and <B>unauth</B>)
|
||
|
|
</UL>
|
||
|
|
<P><DT><B>-version
|
||
|
|
</B><DD>Reports the AFS build level of the binary file for the process designated
|
||
|
|
by the <B>-port</B> argument (or of the kernel extensions file for port
|
||
|
|
7001, the Cache Manager's callback interface). Any other options
|
||
|
|
combined with this one are ignored.
|
||
|
|
<P><DT><B>-noconns
|
||
|
|
</B><DD>Produces only the standard statistics that begin the output produced by
|
||
|
|
every option (other than <B>-version</B>), without reporting on any
|
||
|
|
connections. Any other options combined with this one are
|
||
|
|
ignored.
|
||
|
|
<P><DT><B>-peers
|
||
|
|
</B><DD>Outputs information from the <I>peer structure</I> maintained for each
|
||
|
|
port on another machine to which the process designated by the
|
||
|
|
<B>-port</B> argument has a connection. There is information about
|
||
|
|
roundtrip time and numbers of packets sent and received, for example.
|
||
|
|
<P><DT><B>-help
|
||
|
|
</B><DD>Prints the online help for this command. All other valid options
|
||
|
|
are ignored.
|
||
|
|
</DL>
|
||
|
|
<P><STRONG>Output</STRONG>
|
||
|
|
<P>If any options other than <B>-version</B> or <B>-help</B> are
|
||
|
|
provided, the output written to the standard output stream begins with basic
|
||
|
|
statistics about packet usage and availability, how many calls are waiting for
|
||
|
|
a thread, how many threads are free, and so on (this is the only information
|
||
|
|
provided by the <B>-noconns</B> flag). Adding other options
|
||
|
|
produces additional information as described in the preceding
|
||
|
|
<B>Options</B> section of this reference page. The output is
|
||
|
|
intended for debugging purposes and is meaningful to someone familiar with the
|
||
|
|
implementation of Rx.
|
||
|
|
<P><STRONG>Privilege Required</STRONG>
|
||
|
|
<P>None.
|
||
|
|
<P><STRONG>Related Information</STRONG>
|
||
|
|
<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
|
||
|
|
<P><A HREF="auarf124.htm#HDRBOSSERVER">bosserver</A>
|
||
|
|
<P><A HREF="auarf125.htm#HDRBUSERVER">buserver</A>
|
||
|
|
<P><A HREF="auarf126.htm#HDRBUTC">butc</A>
|
||
|
|
<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
|
||
|
|
<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
|
||
|
|
<P><A HREF="auarf227.htm#HDRPTSERVER">ptserver</A>
|
||
|
|
<P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
|
||
|
|
<P><A HREF="auarf241.htm#HDRUPSERVER">upserver</A>
|
||
|
|
<P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
|
||
|
|
<P><A HREF="auarf251.htm#HDRVOLSERVER">volserver</A>
|
||
|
|
<P>
|
||
|
|
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf230.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf232.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
|
||
|
|
<!-- Begin Footer Records ========================================== -->
|
||
|
|
<P><HR><B>
|
||
|
|
<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
|
||
|
|
</B>
|
||
|
|
<!-- End Footer Records ============================================ -->
|
||
|
|
<A NAME="Bot_Of_Page"></A>
|
||
|
|
</BODY></HTML>
|