diff options
Diffstat (limited to 'usr/src/man/man1m/bart.1m')
| -rw-r--r-- | usr/src/man/man1m/bart.1m | 83 |
1 files changed, 9 insertions, 74 deletions
diff --git a/usr/src/man/man1m/bart.1m b/usr/src/man/man1m/bart.1m index 1149e794b8..520ab571ed 100644 --- a/usr/src/man/man1m/bart.1m +++ b/usr/src/man/man1m/bart.1m @@ -3,25 +3,25 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH bart 1M "26 Oct 2005" "SunOS 5.11" "System Administration Commands" +.TH BART 1M "Oct 26, 2005" .SH NAME bart \- basic audit reporting tool .SH SYNOPSIS .LP .nf -\fB/usr/bin/bart\fR create [ \fB-n\fR] [\fB-R\fR \fIroot_directory\fR] +\fB/usr/bin/bart\fR create [ \fB-n\fR] [\fB-R\fR \fIroot_directory\fR] [\fB-r\fR \fIrules_file\fR | -] .fi .LP .nf -\fB/usr/bin/bart\fR create [\fB-n\fR] [\fB-R\fR \fIroot_directory\fR] \fB-I\fR +\fB/usr/bin/bart\fR create [\fB-n\fR] [\fB-R\fR \fIroot_directory\fR] \fB-I\fR [\fIfile_name\fR]... .fi .LP .nf -\fB/usr/bin/bart\fR compare [\fB-i\fR \fIattribute\fR ] [\fB-p\fR] +\fB/usr/bin/bart\fR compare [\fB-i\fR \fIattribute\fR ] [\fB-p\fR] [\fB-r\fR \fIrules_file\fR | -] \fIcontrol-manifest\fR \fItest-manifest\fR .fi @@ -39,12 +39,10 @@ by means of a rules file, \fBbart_rules\fR. See \fBbart_rules\fR(4). The \fBbart\fR utility performs two basic functions: .sp .ne 2 -.mk .na \fB\fBbart create\fR\fR .ad .RS 16n -.rt The manifest generator tool takes a file-level \fBsnapshot\fR of a system. The output is a catalog of file attributes referred to as a \fBmanifest\fR. See \fBbart_manifest\fR(4). @@ -67,12 +65,10 @@ since they are HSFS file systems. .sp .ne 2 -.mk .na \fB\fBbart compare\fR\fR .ad .RS 16n -.rt The report tool compares two manifests. The output is a list of per-file attribute discrepancies. These discrepancies are the differences between two manifests: a control manifest and a test manifest. @@ -105,12 +101,10 @@ files. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-i\fR \fIattribute\fR ...\fR .ad .RS 21n -.rt Specify the file attributes to be ignored globally. Specify attributes as a comma separated list. .sp @@ -120,48 +114,40 @@ global \fBIGNORE\fR keyword in the rules file. See \fBbart_rules\fR(4). .sp .ne 2 -.mk .na \fB\fB-I\fR [\fIfile_name\fR...]\fR .ad .RS 21n -.rt Specify the input list of files. The file list can be specified at the command line or read from standard input. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 21n -.rt Prevent computation of content signatures for all regular files in the file list. .RE .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 21n -.rt Display manifest comparison output in ``programmatic mode,'' which is suitable for programmatic parsing. The output is not localized. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR \fIrules_file\fR\fR .ad .RS 21n -.rt Use \fIrules_file\fR to specify which files and directories to catalog, and to define which file attribute discrepancies to flag. If \fIrules_file\fR is \fB-\fR, then the rules are read from standard input. See \fBbart_rules\fR(4) @@ -170,12 +156,10 @@ for the definition of the syntax. .sp .ne 2 -.mk .na \fB\fB-R\fR \fIroot_directory\fR\fR .ad .RS 21n -.rt Specify the root directory for the manifest. All paths specified by the rules, and all paths reported in the manifest, are relative to \fIroot_directory\fR. .LP @@ -199,23 +183,19 @@ appearing in subtree and subtree modifier specifications. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcontrol-manifest\fR\fR .ad .RS 20n -.rt Specify the manifest created by \fBbart create\fR on the control system. .RE .sp .ne 2 -.mk .na \fB\fItest-manifest\fR\fR .ad .RS 20n -.rt Specify the manifest created by \fBbart create\fR on the test system. .RE @@ -246,12 +226,10 @@ that is suitable for programmatic manipulation. .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad .RS 13n -.rt Name of the file that differs between \fIcontrol-manifest\fR and \fItest-manifest\fR. For file names that contain embedded whitespace or newline characters, see \fBbart_manifest\fR(4). @@ -259,12 +237,10 @@ characters, see \fBbart_manifest\fR(4). .sp .ne 2 -.mk .na \fB\fIattribute\fR\fR .ad .RS 13n -.rt The name of the file attribute that differs between the manifests that are compared. \fIxxxx\fR is the attribute value from \fIcontrol-manifest\fR, and \fIyyyy\fR is the attribute value from \fItest-manifest\fR. When discrepancies @@ -274,35 +250,29 @@ separate line. The following attributes are supported: .sp .ne 2 -.mk .na \fBacl\fR .ad .RS 12n -.rt ACL attributes for the file. For a file with ACL attributes, this field contains the output from \fBacltotext()\fR. .RE .sp .ne 2 -.mk .na \fBall\fR .ad .RS 12n -.rt All attributes. .RE .sp .ne 2 -.mk .na \fBcontents\fR .ad .RS 12n -.rt Checksum value of the file. This attribute is only specified for regular files. If you turn off context checking or if checksums cannot be computed, the value of this field is \fB-\fR. @@ -310,113 +280,93 @@ of this field is \fB-\fR. .sp .ne 2 -.mk .na \fBdest\fR .ad .RS 12n -.rt Destination of a symbolic link. .RE .sp .ne 2 -.mk .na \fBdevnode\fR .ad .RS 12n -.rt Value of the device node. This attribute is for character device files and block device files only. .RE .sp .ne 2 -.mk .na \fBdirmtime\fR .ad .RS 12n -.rt Modification time in seconds since 00:00:00 UTC, January 1, 1970 for directories. .RE .sp .ne 2 -.mk .na \fBgid\fR .ad .RS 12n -.rt Numerical group ID of the owner of this entry. .RE .sp .ne 2 -.mk .na \fBlnmtime\fR .ad .RS 12n -.rt Creation time for links. .RE .sp .ne 2 -.mk .na \fBmode\fR .ad .RS 12n -.rt Octal number that represents the permissions of the file. .RE .sp .ne 2 -.mk .na \fBmtime\fR .ad .RS 12n -.rt Modification time in seconds since 00:00:00 UTC, January 1, 1970 for files. .RE .sp .ne 2 -.mk .na \fBsize\fR .ad .RS 12n -.rt File size in bytes. .RE .sp .ne 2 -.mk .na \fBtype\fR .ad .RS 12n -.rt Type of file. .RE .sp .ne 2 -.mk .na \fBuid\fR .ad .RS 12n -.rt Numerical user ID of the owner of this entry. .RE @@ -450,7 +400,6 @@ test:84b2b32c4165887355317207b48a6ec7 .sp .ne 2 -.mk .na \fB\fIfilename\fR\fR .ad @@ -461,7 +410,6 @@ Same as \fIfilename\fR in the default format. .sp .ne 2 -.mk .na \fB\fIattribute\fR \fIcontrol-val\fR \fItest-val\fR\fR .ad @@ -497,34 +445,28 @@ contents daca28ae0de97afd7a6b91fde8d57afa 84b2b32c4165887355317207b48a6ec7 The manifest generator returns the following exit values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt Success .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Non-fatal error when processing files; for example, permission problems .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt Fatal error; for example, invalid command-line options .RE @@ -534,34 +476,28 @@ Fatal error; for example, invalid command-line options The report tool returns the following exit values: .sp .ne 2 -.mk .na \fB\fB0\fR\fR .ad .RS 6n -.rt No discrepancies reported .RE .sp .ne 2 -.mk .na \fB\fB1\fR\fR .ad .RS 6n -.rt Discrepancies found .RE .sp .ne 2 -.mk .na \fB\fB>1\fR\fR .ad .RS 6n -.rt Fatal error executing comparison .RE @@ -681,13 +617,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO |