summaryrefslogtreecommitdiff
path: root/usr/src/man/man1/sum.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1/sum.1')
-rw-r--r--usr/src/man/man1/sum.172
1 files changed, 6 insertions, 66 deletions
diff --git a/usr/src/man/man1/sum.1 b/usr/src/man/man1/sum.1
index ac143d4e0c..01c8405f94 100644
--- a/usr/src/man/man1/sum.1
+++ b/usr/src/man/man1/sum.1
@@ -10,7 +10,7 @@
.\" 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 sum 1 "11 Aug 2009" "SunOS 5.11" "User Commands"
+.TH SUM 1 "Aug 11, 2009"
.SH NAME
sum \- print checksum and block count for a file
.SH SYNOPSIS
@@ -48,34 +48,28 @@ This can be explicitly overridden by the \fB--logical\fR, \fB--metaphysical\fR,
and \fB--physical\fR options below. \fBPATH_RESOLVE\fR can be one of:
.sp
.ne 2
-.mk
.na
\fB\fB--logical\fR\fR
.ad
.RS 18n
-.rt
Follow all symbolic links.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB--metaphysical\fR\fR
.ad
.RS 18n
-.rt
Follow command argument symbolic links, otherwise do not follow.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB--physical\fR\fR
.ad
.RS 18n
-.rt
Do not follow symbolic links.
.RE
@@ -85,7 +79,6 @@ Do not follow symbolic links.
The following options are supported for \fB/usr/bin/sum\fR:
.sp
.ne 2
-.mk
.na
\fB\fB-a\fR\fR
.ad
@@ -101,7 +94,6 @@ and total checksums and block counts.
.sp
.ne 2
-.mk
.na
\fB\fB-b\fR\fR
.ad
@@ -116,7 +108,6 @@ Read files in binary mode. This is the default.
.sp
.ne 2
-.mk
.na
\fB\fB-B\fR\fR
.ad
@@ -132,7 +123,6 @@ the output. The default is method-specific.
.sp
.ne 2
-.mk
.na
\fB\fB-c\fR\fR
.ad
@@ -152,7 +142,6 @@ lines, lines starting with #<space>, or the line # are ignored. Lines
containing no blanks are interpreted as [no]name[=\fIvalue\fR] options:
.sp
.ne 2
-.mk
.na
\fB\fBmethod=name\fR\fR
.ad
@@ -163,7 +152,6 @@ Checksum method to apply to subsequent lines.
.sp
.ne 2
-.mk
.na
\fB\fBpermissions\fR\fR
.ad
@@ -176,7 +164,6 @@ Subsequent lines were generated with \fB--permissions\fR.
.sp
.ne 2
-.mk
.na
\fB\fB-h\fR\fR
.ad
@@ -192,7 +179,6 @@ Print the checksum method as the first output line. Used with \fB--check\fR and
.sp
.ne 2
-.mk
.na
\fB\fB-l\fR\fR
.ad
@@ -207,7 +193,6 @@ Each file is interpreted as a list of files, one per line, that is checksummed.
.sp
.ne 2
-.mk
.na
\fB\fB-p\fR\fR
.ad
@@ -226,7 +211,6 @@ the standard error for each changed file.
.sp
.ne 2
-.mk
.na
\fB\fB-R\fR\fR
.ad
@@ -241,7 +225,6 @@ Recursively checksum the contents of directories.
.sp
.ne 2
-.mk
.na
\fB\fB-t\fR\fR
.ad
@@ -260,7 +243,6 @@ separately.
.sp
.ne 2
-.mk
.na
\fB\fB-T\fR\fR
.ad
@@ -275,7 +257,6 @@ Read files in text mode (for example, treat \r\n as \n).
.sp
.ne 2
-.mk
.na
\fB\fB-w\fR\fR
.ad
@@ -291,7 +272,6 @@ Warn about invalid \fB--check\fR lines. On by default; \fB-w\fR means
.sp
.ne 2
-.mk
.na
\fB\fB-x\fR\fR
.ad
@@ -305,7 +285,6 @@ Specifies the checksum method to apply. Parenthesized method options are
readonly implementation details.
.sp
.ne 2
-.mk
.na
\fB\fBatt\fR|\fBsys5\fR|\fBs5\fR|\fBdefault\fR\fR
.ad
@@ -318,7 +297,6 @@ methods are order dependent.
.sp
.ne 2
-.mk
.na
\fB\fBast4\fR|\fB32x4\fR|\fBtw\fR\fR
.ad
@@ -330,7 +308,6 @@ The \fBast\fR 128 bit \fBPRNG\fR hash generated by catenating 4 separate 32 bit
.sp
.ne 2
-.mk
.na
\fB\fBbsd\fR|\fBucb\fR\fR
.ad
@@ -341,7 +318,6 @@ The BSD checksum.
.sp
.ne 2
-.mk
.na
\fB\fBcrc\fR\fR
.ad
@@ -350,7 +326,6 @@ The BSD checksum.
32 bit CRC (cyclic redundancy check).
.sp
.ne 2
-.mk
.na
\fB\fBpolynomial\fR=\fImask\fR\fR
.ad
@@ -362,7 +337,6 @@ is 0xedb88320.
.sp
.ne 2
-.mk
.na
\fB\fBdone\fR[=\fInumber\fR]\fR
.ad
@@ -374,7 +348,6 @@ omitted. The option value may be omitted. The default value is 0.
.sp
.ne 2
-.mk
.na
\fB\fBinit\fR[=\fInumber\fR]\fR
.ad
@@ -386,7 +359,6 @@ option value may be omitted. The default value is 0.
.sp
.ne 2
-.mk
.na
\fB\fBrotate\fR\fR
.ad
@@ -398,7 +370,6 @@ order).
.sp
.ne 2
-.mk
.na
\fB\fBsize\fR[=\fInumber\fR]\fR
.ad
@@ -412,7 +383,6 @@ XOR'd into the size. The option value may be omitted. The default value is 0.
.sp
.ne 2
-.mk
.na
\fB\fBprng\fR\fR
.ad
@@ -421,34 +391,28 @@ XOR'd into the size. The option value may be omitted. The default value is 0.
32 bit \fBPRNG\fR (pseudo random number generator) hash.
.sp
.ne 2
-.mk
.na
\fB\fBmpy\fR=\fInumber\fR\fR
.ad
.RS 17n
-.rt
The 32 bit \fBPRNG\fR multiplier. The default value is 0x01000193.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBadd\fR=\fInumber\fR\fR
.ad
.RS 17n
-.rt
The 32 bit \fBPRNG\fR addend. The default value is 0.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBinit\fR[=\fInumber\fR]\fR
.ad
.RS 17n
-.rt
The \fBPRNG\fR initial value. 0xffffffff is used if number is omitted. The
option value may be omitted. The default value is 0x811c9dc5.
.RE
@@ -457,7 +421,6 @@ option value may be omitted. The default value is 0x811c9dc5.
.sp
.ne 2
-.mk
.na
\fB\fBmd4\fR|\fBMD4\fR\fR
.ad
@@ -469,7 +432,6 @@ is not printed. (version) \fBmd4\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26
.sp
.ne 2
-.mk
.na
\fB\fBmd5\fR|\fBMD5\fR\fR
.ad
@@ -481,7 +443,6 @@ is not printed. (version) \fBmd5\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26
.sp
.ne 2
-.mk
.na
\fB\fBsha1\fR|\fBSHA1\fR|\fBsha-1\fR|\fBSHA-1\fR\fR
.ad
@@ -494,7 +455,6 @@ Cryptographically weak. The block count is not printed. (version) \fBsha1\fR
.sp
.ne 2
-.mk
.na
\fB\fBsha256\fR|\fBsha-256\fR|\fBSHA256\fR|\fBSHA-256\fR\fR
.ad
@@ -506,7 +466,6 @@ printed. (version) \fBsha256\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26
.sp
.ne 2
-.mk
.na
\fB\fBsha384\fR|\fBsha-384\fR|\fBSHA384\fR|\fBSHA-384\fR\fR
.ad
@@ -518,7 +477,6 @@ printed. (version) \fBsha384\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26
.sp
.ne 2
-.mk
.na
\fB\fBsha512\fR|\fBsha-512\fR|\fBSHA512\fR|\fBSHA-512\fR\fR
.ad
@@ -530,7 +488,6 @@ printed. (version) \fBsha512\fR (\fBsolaris\fR \fB-lmd\fR) 2005-07-26
.sp
.ne 2
-.mk
.na
\fB\fBposix\fR|\fBcksum\fR|\fBstd\fR|\fBstandard\fR\fR
.ad
@@ -542,7 +499,6 @@ The \fBposix 1003.2-1992\fR 32 bit \fBcrc\fR checksum. This is the default
.sp
.ne 2
-.mk
.na
\fB\fBzip\fR\fR
.ad
@@ -553,7 +509,6 @@ The \fBzip\fR(1) \fBcrc\fR. Shorthand for \fBcrc-0xedb88320-init-done\fR.
.sp
.ne 2
-.mk
.na
\fB\fBfddi\fR\fR
.ad
@@ -565,7 +520,6 @@ The \fBFDDI\fR \fBcrc\fR. Shorthand for
.sp
.ne 2
-.mk
.na
\fB\fBfnv\fR|\fBfnv1\fR\fR
.ad
@@ -577,7 +531,6 @@ The \fBFowler-Noll-Vo\fR 32 bit \fBPRNG\fR hash with non-zero initializer
.sp
.ne 2
-.mk
.na
\fB\fBast\fR|\fBstrsum\fR\fR
.ad
@@ -591,7 +544,6 @@ The \fBast\fR \fBstrsum\fR \fBPRNG\fR hash. Shorthand for
.sp
.ne 2
-.mk
.na
\fB\fB-L\fR\fR
.ad
@@ -607,7 +559,6 @@ Follow symbolic links when traversing directories. The default is determined by
.sp
.ne 2
-.mk
.na
\fB\fB-H\fR\fR
.ad
@@ -624,7 +575,6 @@ when traversing directories. The default is determined by \fBgetconf\fR
.sp
.ne 2
-.mk
.na
\fB\fB-P\fR\fR
.ad
@@ -640,7 +590,6 @@ determined by \fBgetconf\fR \fBPATH_RESOLVE\fR.
.sp
.ne 2
-.mk
.na
\fB\fB-r\fR\fR
.ad
@@ -656,7 +605,6 @@ sum implementations.
.sp
.ne 2
-.mk
.na
\fB\fB-s\fR\fR
.ad
@@ -672,7 +620,6 @@ implementations.
.sp
.ne 2
-.mk
.na
\fB\fB-S\fR\fR
.ad
@@ -692,12 +639,10 @@ at least one sum failed to match. Ignored for \fB--permissions\fR.
The following operands are supported:
.sp
.ne 2
-.mk
.na
\fB\fIfile\fR\fR
.ad
.RS 8n
-.rt
A path name of a file. If no files are named, the standard input is used.
.RE
@@ -718,23 +663,19 @@ that affect the execution of \fBsum\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and
The following exit values are returned.
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
-.rt
Successful completion.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB>0\fR\fR
.ad
.RS 6n
-.rt
An error occurred.
.RE
@@ -746,13 +687,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
_
-CSIEnabled
+CSI Enabled
.TE
.SH SEE ALSO
generated by cgit v1.2.3 (git 2.46.0) at 2025-10-17 15:20:09 +0000