mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 17:00:15 +00:00
108 lines
5.9 KiB
HTML
108 lines
5.9 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="auarf173.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="auarf175.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="HDRFSTRACE_LSLOG" HREF="auarf002.htm#ToC_188">fstrace lslog</A></H2>
|
|
<P><STRONG>Purpose</STRONG>
|
|
<A NAME="IDX5036"></A>
|
|
<A NAME="IDX5037"></A>
|
|
<P>Displays information about a log
|
|
<P><STRONG>Synopsis</STRONG>
|
|
<PRE><B>fstrace lslog</B> [<B>-set</B> <<VAR>set_name</VAR>><SUP>+</SUP>] [<B>-log</B> <<VAR>log_name</VAR>>] [<B>-long</B>] [<B>-help</B>]
|
|
|
|
<B>fstrace lsl</B> [<B>-s</B> <<VAR>set_name</VAR>><SUP>+</SUP>] [<B>-log</B> <<VAR>log_name</VAR>>] [<B>-lon</B>] [<B>-h</B>]
|
|
</PRE>
|
|
<P><STRONG>Description</STRONG>
|
|
<P>The <B>fstrace lslog</B> command reports whether the <B>cmfx</B>
|
|
log is available for use. If the <B>-long</B> argument is included,
|
|
the output reports the log's defined size, and whether that amount of
|
|
space is currently allocated in kernel memory or not.
|
|
<P>To change the <B>cmfx</B> trace log's size, use the <B>fstrace
|
|
setlog</B> command. To display or set whether space is allocated for
|
|
it in kernel memory, use the <B>fstrace lsset</B> or <B>fstrace
|
|
setset</B> command to display or set the state of the corresponding
|
|
<B>cm</B> event set, respectively.
|
|
<P><STRONG>Options</STRONG>
|
|
<DL>
|
|
<P><DT><B>-set
|
|
</B><DD>Names the event set for which to display information about the
|
|
corresponding trace log. The only acceptable value is <B>cm</B>
|
|
(for which the associated trace log is <B>cmfx</B>). Provide either
|
|
this argument or the <B>-log</B> argument, or omit both to display
|
|
information about the <B>cmfx</B> log by default.
|
|
<P><DT><B>-log
|
|
</B><DD>Names the trace log about which to report. The only acceptable
|
|
value is <B>cmfx</B>. Provide either this argument or the
|
|
<B>-set</B> argument, or omit both to report on the <B>cmfx</B> log by
|
|
default.
|
|
<P><DT><B>-long
|
|
</B><DD>Reports the defined size of the log in kilobyte units and whether that
|
|
amount of space is currently allocated in kernel memory.
|
|
<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>By default, the <B>fstrace lslog</B> command displays only the name of
|
|
the available log, <B>cmfx</B>, in the following format:
|
|
<PRE> Available logs:
|
|
cmfx
|
|
|
|
</PRE>
|
|
<P>When the <B>-long</B> flag is included, the output also reports the
|
|
defined size of the log in kilobytes, and whether or not that amount of space
|
|
is currently allocated in kernel memory, in the following format:
|
|
<PRE> Available logs:
|
|
cmfx : <VAR>log_size</VAR> kbytes (allocated | unallocated)
|
|
|
|
</PRE>
|
|
<P>The <TT>allocated</TT> state indicates that the indicated number of
|
|
kilobytes is reserved for the <B>cmfx</B> trace log in kernel
|
|
memory. The <B>cm</B> event set's state is either
|
|
<TT>active</TT> or <TT>inactive</TT>, as reported by the <B>fstrace
|
|
lsset</B> command, and set by the <B>fstrace setset</B> command's
|
|
<B>-active</B> or <B>-inactive</B> flags respectively.
|
|
<P>The <TT>unallocated</TT> state indicates that no kernel memory is
|
|
currently reserved for the <B>cmfx</B> trace log. The <B>cm</B>
|
|
event set's state is <TT>dormant</TT>, as reported by the <B>fstrace
|
|
lsset</B> command and set by the <B>fstrace setset</B> command's
|
|
<B>-dormant</B> flag. If the event set's state is later
|
|
changed to active or inactive, the number of kilobytes indicated as
|
|
<VAR>log_size</VAR> are again allocated in kernel memory.
|
|
<P><STRONG>Examples</STRONG>
|
|
<P>The following example uses the <B>-long</B> flag to display information
|
|
about the <B>cmfx</B> log:
|
|
<PRE> # <B>fstrace lslog -log cmfx -long</B>
|
|
Available logs:
|
|
cmfx : 60 kbytes (allocated)
|
|
|
|
</PRE>
|
|
<P><STRONG>Privilege Required</STRONG>
|
|
<P>The issuer must be logged in as the local superuser <B>root</B>.
|
|
<P><STRONG>Related Information</STRONG>
|
|
<P><A HREF="auarf169.htm#HDRFSTRACE_INTRO">fstrace</A>
|
|
<P><A HREF="auarf175.htm#HDRFSTRACE_LSSET">fstrace lsset</A>
|
|
<P><A HREF="auarf176.htm#HDRFSTRACE_SETLOG">fstrace setlog</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="auarf173.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="auarf175.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>
|