.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "SUM 1"
.TH SUM 1 "2001-06-06" "perl v5.20.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
sum \- display file checksums and block counts
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBsum\fR
[ \fB\-o\fR \fI0|1|2\fR ]
[ \fB\-h\fR ]
[ \fIfilename ...\fR ]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
sum outputs three space seperated values:  file \s-1CRC,\s0 file size, and
file name.  Can be used to find errors in transmitted files.  You should
not use sum for security checks as they are easily fooled.  Look into
md5sum for something a bit more secure.  If no file names are specified,
stdin is used and no file name will displayed in the output.
.SH "OPTIONS AND ARGUMENTS"
.IX Header "OPTIONS AND ARGUMENTS"
.IP "\fI\-h\fR	Display the usage help message." 4
.IX Item "-h Display the usage help message."
.PD 0
.ie n .IP "\fI\-o\fR	Specify the output type for file \s-1CRC\s0 and size. 0\-\-CRC is computed using the \s-1CRC 32\s0 algorithm, the default unless otherwise specified.  Output size is in bytes.	1\-\-CRC is computed using \s-1BSD\s0 Historic Algorithm 1 (16\-bit checksum with right rotation between byte addition).  Output size is number of 1024 byte blocks. 2\-\-CRC is computed using \s-1SYSV\s0 Historic Algorithm 2 (32\-bit checksum). Output size is number of 512 byte blocks." 4
.el .IP "\fI\-o\fR	Specify the output type for file \s-1CRC\s0 and size. \f(CW0\fR\-\-CRC is computed using the \s-1CRC 32\s0 algorithm, the default unless otherwise specified.  Output size is in bytes.	\f(CW1\fR\-\-CRC is computed using \s-1BSD\s0 Historic Algorithm 1 (16\-bit checksum with right rotation between byte addition).  Output size is number of 1024 byte blocks. \f(CW2\fR\-\-CRC is computed using \s-1SYSV\s0 Historic Algorithm 2 (32\-bit checksum). Output size is number of 512 byte blocks." 4
.IX Item "-o Specify the output type for file CRC and size. 0--CRC is computed using the CRC 32 algorithm, the default unless otherwise specified. Output size is in bytes. 1--CRC is computed using BSD Historic Algorithm 1 (16-bit checksum with right rotation between byte addition). Output size is number of 1024 byte blocks. 2--CRC is computed using SYSV Historic Algorithm 2 (32-bit checksum). Output size is number of 512 byte blocks."
.PD
.SH "NOTES"
.IX Header "NOTES"
sum returns 0 on success or 1 if an error occurred.
.PP
The program checks the name in which it was called.  If it is anything
except \*(L"cksum\*(R", the output will default to \s-1BSD\s0 Historic Algorithm 1
unless otherwise specified.  Otherwise, the default is \s-1CRC32\s0 mode.
.PP
Algorithms 1 and 2 will round up to the next block count for partial blocks.
.PP
\&\s-1CRC 32\s0 algorithm ported directly from OpenBSD cksum C source code.
.SH "HISTORY"
.IX Header "HISTORY"
Perl version rewritten for the Perl Power Tools project from the
description of the cksum program in OpenBSD.
.SH "AUTHOR"
.IX Header "AUTHOR"
Theo Van Dinter (felicity@kluge.net)
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fImd5sum\fR\|(1)
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 192:" 4
.IX Item "Around line 192:"
\&'=item' outside of any '=over'
.IP "Around line 202:" 4
.IX Item "Around line 202:"
You forgot a '=back' before '=head1'