.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ALFSUM" 1 "2025-11-21" "0.1.0" "Urchlay's Atari 8-bit Tools"
.SH NAME
alfsum \- calculate ALF checksums
.\" RST source for alfsum(1) man page. Convert with:
.
.\" rst2man.py alfsum.rst > alfsum.1
.
.SH SYNOPSIS
.sp
alfsum \fBfile\fP [\fBfile\fP ...] | [\fB\-\-help\fP | \fB\-h\fP] | [\fB\-\-version\fP | \fB\-V\fP]
.SH DESCRIPTION
.sp
\fBalfsum\fP calculates the checksums used by the \fBALF\fP compression
utility on the Atari 8\-bit platform.
.sp
To read from standard input, use \fB\-\fP as a filename.
.sp
Output lines have a tab separating the checksum and filename, for ease
of scripting (e.g. with \fBcut\fP(1) or \fBawk\fP(1)).
.sp
\fBalfsum\fP\(aqs primary use is to check files extracted from \fBALF\fP
archives against the checksums stored in the archive. The \fBunalf\fP
program already does this, but \fBalfsum\fP is a separate (much simpler)
program. It serves as a second opinion, in case you suspect a bug in
\fBunalf\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
Show built\-in help message.
.TP
.B  \-V\fP,\fB  \-\-version
Show \fBalfsum\fP version number and exit.
.UNINDENT
.SH NOTES
.sp
The checksum algorithm is very simple: all the bytes in the file are
added together, and the low 16 bits of the result are the checksum.
.SH EXIT STATUS
.INDENT 0.0
.TP
.B 0
Success.
.TP
.B 1 to 254
File I/O error count. If there are more than 254 I/O errors, 254 is returned.
.TP
.B 255
Error in command\-line arguments: no filenames given.
.UNINDENT
.SH COPYRIGHT
.sp
\fBalfsum\fP is released under the WTPFL: Do WTF you want with this.
.SH AUTHORS
.INDENT 0.0
.IP B. 3
Watson <\fI\%urchlay@slackware.uk\fP>
.UNINDENT
.SH SEE ALSO
.sp
\fBunalf\fP(1)
.sp
The git repository for \fBunalf\fP:
.INDENT 0.0
.INDENT 3.5
\fI\%https://slackware.uk/~urchlay/repos/unalf\fP
.UNINDENT
.UNINDENT
.sp
Other Atari\-related projects by the author, including \fBbw\-atari8\-tools\fP
and \fBunmac65\fP:
.INDENT 0.0
.INDENT 3.5
\fI\%https://slackware.uk/~urchlay/repos/\fP
.UNINDENT
.UNINDENT
.\" Generated by docutils manpage writer.
.