File: //usr/share/doc/acct/html/dump_002dacct.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>dump-acct (Accounting Utilities Manual)</title>
<meta name="description" content="dump-acct (Accounting Utilities Manual)">
<meta name="keywords" content="dump-acct (Accounting Utilities Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="sa.html" rel="prev" title="sa">
<style type="text/css">
<!--
a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
span:hover a.copiable-anchor {visibility: visible}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<div class="chapter" id="dump_002dacct">
<div class="header">
<p>
Previous: <a href="sa.html" accesskey="p" rel="prev"><code>sa</code></a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<hr>
<span id="dump_002dacct-1"></span><h2 class="chapter">5 <code>dump-acct</code></h2>
<p><code>dump-acct</code> dumps some of the contents of one or more <code>acct</code>
files in human readable form. Usage:
</p>
<p><code>dump-acct [<var>opts</var>] <var>files</var></code>
</p>
<p>Unless called with the <code>--raw</code> option, it prints a table with the
following fields, separated by vertical bars(<code>|</code>):
</p>
<dl compact="compact">
<dt><span><code>ac_comm</code></span></dt>
<dd><p>name of the executed program
</p>
</dd>
<dt><span><code>ac_version</code></span></dt>
<dd><p>version of the <code>acct</code> file format
</p>
</dd>
<dt><span><code>ac_utime</code></span></dt>
<dd><p>user time
</p>
</dd>
<dt><span><code>ac_stime</code></span></dt>
<dd><p>system time
</p>
</dd>
<dt><span><code>ac_etime</code></span></dt>
<dd><p>elapsed time
</p>
</dd>
<dt><span><code>ac_uid</code></span></dt>
<dd><p>user id
</p>
</dd>
<dt><span><code>ac_gid</code></span></dt>
<dd><p>group id
</p>
</dd>
<dt><span><code>ac_mem</code></span></dt>
<dd><p>(average) memory usage
</p>
</dd>
<dt><span><code>ac_io</code></span></dt>
<dd><p>number of characters transferred on input/output
</p>
</dd>
<dt><span><code>ac_pid</code></span></dt>
<dd><p>process id
</p>
</dd>
<dt><span><code>ac_ppid</code></span></dt>
<dd><p>parent’s process id
</p>
</dd>
</dl>
<p>All times will be given in platform dependent units (“<code>AHZ</code>”).
Not all of the above columns will actually appear, depending on what
information your operating system provides in it’s <code>struct acct</code>.
</p>
<ul class="section-toc">
<li><a href="#Flags-4" accesskey="1">Flags</a></li>
</ul>
<div class="section" id="Flags-4">
<h3 class="section">5.1 Flags</h3>
<dl compact="compact">
<dt><span><code>--ahz <var>hz</var></code></span></dt>
<dd><p>Use this flag to tell the program what <code>AHZ</code> should be (in Hertz).
This option is useful if you are trying to view an <code>acct</code> file
created on another machine which has a different value for <code>AHZ</code>.
</p>
</dd>
<dt><span><code>--byteswap</code></span></dt>
<dd><p>Swap the bytes (relative to your system’s native byte order) in
<code>--raw</code> output.
</p>
</dd>
<dt><span><code>--format</code></span></dt>
<dd><p>Set output format with <code>--raw</code> option.
</p>
</dd>
<dt><span><code>-n <var>num</var></code></span></dt>
<dt><span><code>--num <var>num</var></code></span></dt>
<dd><p>Limit the number of lines (or records with <code>--raw</code>) to print.
</p>
</dd>
<dt><span><code>-r</code></span></dt>
<dt><span><code>--reverse</code></span></dt>
<dd><p>Read the accounting file backwards (print latest record first).
</p>
</dd>
<dt><span><code>-R</code></span></dt>
<dt><span><code>--raw</code></span></dt>
<dd><p>Don’t print human readable output, dump the raw record instead.
Useful to convert between different Linux file formats (see below).
</p>
</dd>
<dt><span><code>-h</code></span></dt>
<dt><span><code>--help</code></span></dt>
<dd><p>Print <code>dump-acct</code>’s usage string and default location of
the accouning file to standard output.
</p>
</dd>
</dl>
<p><code>--byteswap</code> and <code>--format</code> options are only available with
Linux multiformat support. They only affect <em>output</em> with
the <code>--raw</code> option, format and byte order of the input are
automatically detected.
Thus they are useful to convert between different file formats.
</p>
<p>The <code>--ahz</code> option affects input and output (except for v3 file
format, which by definition is fixed to <code>AHZ=100</code>).
If you ever need to convert between different <code>AHZ</code> values,
use a two-step process:
First convert to v3 format with the <em>old</em> <code>AHZ</code> value, then
convert to the desired output format with the <em>new</em> <code>AHZ</code>
setting.
</p>
</div>
</div>
<hr>
<div class="header">
<p>
Previous: <a href="sa.html"><code>sa</code></a>, Up: <a href="index.html">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
</body>
</html>