path: root/alck.1
authorSergey Poznyakoff <>2013-03-05 20:09:24 (GMT)
committer Sergey Poznyakoff <>2013-03-05 20:09:24 (GMT)
commit8f8a1c98f84669306d1489ddc5d55b6f589df9be (patch) (side-by-side diff)
tree9cb03914f08dea95f1713010d94b274c6458d6ae /alck.1
parentc56e18d5a97384a33941a9c0acf0872df16f2f8d (diff)
Add a manpage.
Diffstat (limited to 'alck.1') (more/less context) (ignore whitespace changes)
1 files changed, 155 insertions, 0 deletions
diff --git a/alck.1 b/alck.1
new file mode 100644
index 0000000..6e842ae
--- a/dev/null
+++ b/alck.1
@@ -0,0 +1,155 @@
+.\" This file is part of ALCK -*- nroff -*-
+.\" Copyright (C) 2013 Sergey Poznyakoff
+.\" Alck is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 3, or (at your option)
+.\" any later version.
+.\" Alck is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" GNU General Public License for more details.
+.\" You should have received a copy of the GNU General Public License
+.\" along with Alck. If not, see <>.
+.TH ALCK 1 "March 5, 2013" "ALCK"
+alck \- check MTA alias files
+\fBalck\fR [\fB\-d\fR \fILEVEL\fR] [\fB\-T\fR \fIFILE\fR]\
+ [\-\fBruv\fR] [\fB\-w\fR \fIFILE\fR] \fIFILE\fR
+\fBalck\fR \fB\-h\fR
+\fBalck\fR \fB\-V\fR
+.B Alck
+checks one or several
+.BR sendmail -style
+alias files for consistency. The following tests are performed:
+.B Transitivity test
+This test discovers eventual circular dependencies.
+.B Use of prohibited aliases
+The program returns 0 if all tests pass successfully. Otherwise,
+it diagnoses encountered problems and exits with error code 1.
+The program takes a list of alias files to be checked from its command
+line. Command line options can be interspersed with filename
+arguments. The command line option
+.B \-T
+can be used to read the list of file names from a plain-text file.
+Such a file must contain one file name per line. Empty lines and
+lines beginning with
+.B #
+are ignored. Any file name that does not begin with a
+.B /
+is searched in the same directory where the list file resides. For
+example, assuming that the file
+.B /etc/mailman/LIST contains:
+.sp +2
+the following invocation
+.sp +2
+$ alck /etc/mail/aliases -T/etc/mailman/LIST
+would instruct
+.B alck
+to process files
+.BR /etc/mail/aliases ,
+.B /etc/mailman/mailman
+.BR /etc/mailman/mailman-test ,
+in that order.
+In any case, if several alias files are supplied,
+.B alck
+treats them as parts of a single alias file.
+\fB\-d\fR \fISPEC\fR
+Set debug level. The \fISPEC\fR can contain one or more of the
+following letters:
+.B y
+enable parser debugging;
+.BR l " (the letter " ell ")"
+enable lexical analizer debugging.
+Upper-case variants are also accepted. Prepending a letter with
+a dash (\fB\-\fR) reverts its sense.
+\fB\-T\fR \fIFILE\fR
+Read names of alias files from \fIFILE\fR.
+.B \-r
+By default, the program allows any valid
+.B Sendmail
+constructs in its input files. To restrict the input syntax to plain
+aliases only, i.e. to prohibit the use of pipes and file redirections, use
+the \fB\-r\fR option. This option affects all file names following
+it, until the eventual occurrence of the
+.B \-u
+option or the end of command line.
+.B \-u
+This options cancels the effect of the previous
+.B \-r
+.B \-v
+Verbosely report the results.
+\fB\-w\fR \fIFILE\fR
+Read contents of the
+.BR Sendmail 's
+.B w
+class from the given
+The following two options instruct the program to display a certain
+kind of information and exit:
+.B \-h
+Display a terse help summary.
+.B \-V
+Display the program version and copyright statement.
+Sergey Poznyakoff
+Report bugs to <>.
+Copyright \(co 2013 Sergey Poznyakoff
+License GPLv3+: GNU GPL version 3 or later <>
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.\" Local variables:
+.\" eval: (add-hook 'write-file-hooks 'time-stamp)
+.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.-]* [0-9] \""
+.\" time-stamp-format: "%:B %:d, %:y"
+.\" time-stamp-end: "\""
+.\" time-stamp-line-limit: 20
+.\" end:

Return to:

Send suggestions and report system problems to the System administrator.