Debian Codegraph @

upstream/debian-unstable/man8/dump-acct.8

raw
1 .TH DUMP-ACCT 8 "2006-04-22" "6.6.4" "GNU Accounting Utilities"
2
3 .SH NAME
4 dump-acct \- print an acct file in human-readable format.
5
6 .SH SYNOPSIS
7 .B dump-acct
8 .RB [\| \-r \||\| \-\-reverse \|]
9 .RB [\| \-R \||\| \-\-raw \|]
10 .RB [\| \-\-format \|]
11 .IR version \|]
12 .RB [\| \-\-byteswap \|]
13 .RB [\| \-\-ahz \|]
14 .IR hertz \|]
15 .RB [\| \-n \||\| \-\-num
16 .IR recs \|]
17 .RB [\| \-h \||\| \-\-help \|]
18 .RB [\|
19 .IR files \|]
20
21 .SH DESCRIPTION
22 .B dump-acct
23 .I filename
24 prints a list of all executed processes. This list is written by the kernel
25 which must be compiled with BSD process accounting enabled (Debian kernel image
26 have it already enabled). It must be started with
27 .BR accton (5).
28 Note that on Debian systems, this is ensured via the init script
29 .IR /etc/init.d/acct .
30 .LP
31 All fields are separated by vertical line. Fields are:
32 .IR command ,
33 .IR version ,
34 .IR "user time" ,
35 .IR "system time" ,
36 .IR "effective time" ,
37 .IR uid ,
38 .IR gid ,
39 .IR memory ,
40 .IR io ,
41 .IR pid ,
42 .IR ppid ,
43 .IR time .
44 User, system and effective times are ticks per second. One tick is usually 1/50
45 of a second. The
46 .I time
47 field shows the start time of the process.
48
49 The
50 .B \-\-raw
51 switch, as well as the
52 .B \-\-format,
53 .B \-\-byteswap,
54 and
55 .B \-\-ahz
56 can be used as a handy format converter.
57
58 .SH OPTIONS
59 .TP
60 .B \-h, \-\-help
61 Prints the usage string and default locations of system files to standard output
62 and exits.
63 .TP
64 .B \-n, \-\-num recs
65 Number of lines to print.
66 .TP
67 .B \-r, \-\-reverse
68 Start printing from last records.
69 .TP
70 .B \-R, \-\-raw
71 Print raw records, not human-readable.
72 .TP
73 .B \-\-format version
74 Use specified format version to display records.
75 .TP
76 .B \-\-byteswap
77 Swap bytes endianness when reading records.
78 .TP
79 .B \-\-ahz
80 Use specified units of time to display data from other kernel versions and
81 architectures.
82
83 .SH FILES
84 .TP
85 .I acct
86 The system wide process accounting file. See
87 .BR acct (5)
88 for further details.
89
90 .SH SEE ALSO
91 .BR acct (5),
92 .BR ac (8).
93
94 .SH AUTHOR
95 The GNU accounting utilities were written by Noel Cragg <[email protected]>.
96 .PP
97 This manual page was written by Ognyan Kulev <[email protected]> and updated
98 by Daniel Baumann <[email protected]> and Mathieu Trudel <[email protected]>
99 for the Debian project (but may be used by others).