pow.3: Minor tweak to BUGS

[thirdparty/man-pages.git] / man5 / acct.5

diff --git a/man5/acct.5 b/man5/acct.5
index 17793afb72b141585e860d8cf6970c7df6b0061a..798eb01d447cc3bf9470a8d6854659e5cea7dfdf 100644 (file)
--- a/man5/acct.5
+++ b/man5/acct.5
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2008, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,8 +20,9 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH ACCT 5 2008-06-15 "Linux" "Linux Programmer's Manual"
+.TH ACCT 5 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 acct \- process accounting file
 .SH SYNOPSIS
@@ -31,20 +33,20 @@ If the kernel is built with the process accounting option enabled
 then calling
 .BR acct (2)
 starts process accounting, for example:
-
+.PP
 .in +4n
 acct("/var/log/pacct");
 .in
-
+.PP
 When process accounting is enabled, the kernel writes a record
 to the accounting file as each process on the system terminates.
 This record contains information about the terminated process,
 and is defined in
 .I <sys/acct.h>
 as follows:
-
+.PP
 .in +4n
-.nf
+.EX
 #define ACCT_COMM 16
 
 typedef u_int16_t comp_t;
@@ -79,7 +81,7 @@ enum {          /* Bits that may be set in ac_flag field */
     ACORE = 0x08,           /* Dumped core */
     AXSIG = 0x10            /* Killed by a signal */
 };
-.fi
+.EE
 .in
 .PP
 The
@@ -89,8 +91,8 @@ and a 13-bit mantissa.
 A value,
 .IR c ,
 of this type can be converted to a (long) integer as follows:
+.PP
 .nf
-
     v = (c & 0x1fff) << (((c >> 13) & 0x7) * 3);
 .fi
 .PP
@@ -102,7 +104,7 @@ and
 fields measure time in "clock ticks"; divide these values by
 .I sysconf(_SC_CLK_TCK)
 to convert them to seconds.
-.SS Version 3 Accounting File Format
+.SS Version 3 accounting file format
 Since kernel 2.6.8,
 an optional alternative version of the accounting file can be produced
 if the
@@ -117,9 +119,9 @@ and
 fields is widened from 16 to 32 bits
 (in line with the increased size of UID and GIDs in Linux 2.4 and later).
 The records are defined as follows:
-
+.PP
 .in +4n
-.nf
+.EX
 struct acct_v3 {
     char      ac_flag;      /* Flags */
     char      ac_version;   /* Always set to ACCT_VERSION (3) */
@@ -142,8 +144,7 @@ struct acct_v3 {
     comp_t    ac_swaps;     /* Number of swaps (unused) */
     char      ac_comm[ACCT_COMM]; /* Command name */
 };
-
-.fi
+.EE
 .in
 .SH VERSIONS
 The
@@ -156,21 +157,21 @@ and the details vary somewhat between systems.
 .SH NOTES
 Records in the accounting file are ordered by termination time of
 the process.
-
+.PP
 In kernels up to and including 2.6.9,
 a separate accounting record is written for each thread created using
 the NPTL threading library;
 since Linux 2.6.10,
 a single accounting record is written for the entire process
 on termination of the last thread in the process.
-
+.PP
 The
-.I proc/sys/kernel/acct
+.I /proc/sys/kernel/acct
 file, described in
 .BR proc (5),
 defines settings that control the behavior of process accounting
 when disk space runs low.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR lastcomm (1),
 .BR acct (2),
 .BR accton (8),