diff options
Diffstat (limited to 'doc/gsc.texi')
-rw-r--r-- | doc/gsc.texi | 150 |
1 files changed, 0 insertions, 150 deletions
diff --git a/doc/gsc.texi b/doc/gsc.texi index ad7c127..ac7018e 100644 --- a/doc/gsc.texi +++ b/doc/gsc.texi @@ -113,7 +113,6 @@ Source Tree Utilities Root Utilities -* ckaliases:: Check MTA alias files. * bind replication:: A Framework for Replicating Master @command{bind} Server. * firewall:: M4 Wrappers For Setting Firewalls. * session-cleanup:: Manage PHP Sessions. @@ -800,160 +799,11 @@ cases, though not always. Such files should probably be inspected after This chapter describes a set of utilities useful in system administration. @menu -* ckaliases:: Check MTA alias files. * bind replication:: A Framework for Replicating Master @command{bind} Server. * firewall:: M4 Wrappers For Setting Firewalls. * session-cleanup:: Manage PHP Sessions. @end menu -@node ckaliases -@section ckaliases - -@pindex ckaliases - @command{Ckaliases} checks one or several -@command{sendmail}-style alias files for consistency. Following -checks are performed: - -@enumerate 1 -@item Transitivity check - This check discovers eventual circular dependencies. - -@item Use of prohibited aliases -@end enumerate - - The program returns 0 if all checks pass successfully. Otherwise, -it diagnoses encountered problems and exits with error code 1. - -@cindex @option{--files-from}, ckaliases option -@cindex @option{-f}, ckaliases option -@cindex ckaliases, @option{--files-from} command line option -@cindex ckaliases, @option{-f} command line option - The program takes a list of alias files to be checked from its command -line. Additionally, the command line option @option{--files-from} -(@option{-f}) 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 @samp{#} are ignored. Any -file name that does not begin with a @samp{/} is searched in the same -directory where the list file resides. For example, assuming that the file -@file{/etc/mailman/LIST} contains: - -@smallexample -mailman -mailman-test -@end smallexample - -@noindent -then, the following invocation - -@smallexample -$ ckaliases /etc/mail/aliases --files-from=/etc/mailman/LIST -@end smallexample - -@noindent -instructs @command{ckaliases} to process files -@file{/etc/mail/aliases}, @file{/etc/mailman/mailman} and -@file{/etc/mailman/mailman-test}, in that order. - - In any case, if several alias files are supplied, -@command{ckaliases} treats them as parts of a single alias file. - -@cindex @option{-w}, ckaliases option -@cindex ckaliases, @option{-w} command line option - Before processing its input files, @command{ckaliases} reads -definitions of Sendmail @code{w} class from file -@file{/etc/mail/sendmail.cw}, or from a file specified using -@option{-w} command line option. For example, running - -@smallexample -ckaliases -w /etc/mail/local-domains aliases -@end smallexample - -@noindent -instructs @command{ckaliases} to use @file{/etc/mail/local-domains}. - -@cindex @option{-r}, ckaliases option -@cindex @option{--restrict}, ckaliases option -@cindex ckaliases, @option{-r} command line option -@cindex ckaliases, @option{--restrict} command line option -@cindex @option{-u}, ckaliases option -@cindex @option{--unrestrict}, ckaliases option -@cindex ckaliases, @option{-u} command line option -@cindex ckaliases, @option{--unrestrict} command line option - By default, the program allows any valid Sendmail constructions -in its input files. To restrict the input syntax to plain aliases only, -i.e. to prohibit use of pipes and file redirections, use -@option{--restrict} (@option{-r}) command line option. This option -affects any file names following it. To cances the restriction, use -@option{--unrestrict} (@option{-u}) option. For example: - -@smallexample -ckaliases aliases -r local -u global -@end smallexample - -@noindent -This command restricts @file{local} to plain aliases only, while -allowing any aliases in files @file{aliases} and @file{global}. - -@cindex @option{-v}, ckaliases option -@cindex @option{--verbose}, ckaliases option -@cindex ckaliases, @option{-v} command line option -@cindex ckaliases, @option{--verbose} command line option -@cindex @option{-d}, ckaliases option -@cindex @option{--debug}, ckaliases option -@cindex ckaliases, @option{-d} command line option -@cindex ckaliases, @option{--debug} command line option - Two options are provided to help trace and debug program -actions. First, @option{--verbose} (@option{-v}) increases the verbosity -level. Secondly, @option{--debug} (@option{-d}) enables debugging -mode. This option takes a mandatory argument, a string specifying part -or parts of the program to debug. The characters valid in this string are: - -@table @asis -@item l or L - Enable lexical analyzer debugging information. - -@item y or Y - Enable debugging input grammar analyzer (parser). -@end table - - Any of these characters can be prefixed with @samp{-} (a dash), -to disable corresponding debugging feature, e.g. @code{-d y-l}. - -@cindex @option{-h}, ckaliases option -@cindex @option{--help}, ckaliases option -@cindex ckaliases, @option{-h} command line option -@cindex ckaliases, @option{--help} command line option - Finally, two usual informational options are available. The -@option{--help} (@option{-h}) displays a short usage summary, and -@option{--verbose} (@option{-v}) shows the program version number and -short reference to its copying conditions. - -@subheading Example of @command{ckaliases} usage - -@cindex @command{ckaliases}, example - The following @file{/etc/mail/Makefile} rule constructs -@file{aliases} from several input files, provided that these are -valid alias files: - -@smallexample -@group -aliases: .depend Aliases mailman/LISTS /com/mailer/aliases - ckaliases Aliases -f mailman/LISTS -r /com/mailer/aliases - @@(echo "# WARNING: DO NOT EDIT THIS FILE!!!"; \ - cat Aliases;\ - cat mailman/LISTS | \ - (cd mailman; \ - while read name; \ - do \ - case $$name in \ - \#*) ;; \ - *) cat $$name;; \ - esac;\ - done);\ - cat /com/mailer/aliases) > aliases -@end group -@end smallexample - @node bind replication @section bind replication @UNREVISED{} |