SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Mandrake 8.X aliases2cdbm-1.0-2rph.i586.rpm

aliases2cdbm

Section: User Commands (1)
Updated: 2000-Jan-09
Index 

NAME

aliases2cdbm: convert mail aliases into input suitable for cdbmake. 

SYNOPSIS

(1) aliases2cdbm [filename [filename...]]

(2) aliases2cdbm {-h|--help}

(3) aliases2cdbm {-V|--version} 

DESCRIPTION

Aliases2cdbmis a utility for converting mail aliases from a text file (e.g.,/etc/aliases)into input suitable for the cdbmake utility.Cdbmakecan then create a constant database (CDB) suitable for reliable,high-speed mail alias lookups. 

PARAMETERS

 

Input

One or more text files in /etc/aliasessyntax (see below). 

Output

Text suitable for use as input tocdbmakefor creating a CDB database. 

Arguments

A filename of -will cause input to be read from stdin.

If no filename is specified on the command line, input is read fromstdin.

Output is printed on stdout, and warning messages are printed onstderr. 

INPUT FORMAT

The input thataliases2cdbmexpects is a series of alias definitions of the following format:


key {space|:[space]} value
[space value
[space value ...]]

where:


space
is any sequence of whitespace characters except for a newline ('\n');that is, any combination of space (' '), tab ('\t'), carriage return('\r'), formfeed ('\f'), or vertical tab ('\v') characters.
key
is the key used looking up the alias; it is terminated either byspaceor by a colon (':') character, which may optionally be followed byadditionalspace.
value
is the value the alias should expand to.Avaluemay span multiple lines of the input file by beginning the second andsuccessive lines withspace.The lines of a multi-linevalueare concatenated together without intervening newlines. Anyspacebetween lines is collapsed to single space characters (' '), whiletrailingspaceis removed.

Comments begin with a hash/number/pound sign ('#'), optionally precededby space,and end at the end of the line:


[space] # text

Comments are ignored (and hence can occur in the middle of a multi-line value).Blank lines are skipped, but a blank line terminates a multi-linevalue,even if the blank line begins withspace.

For example, the following input text:


MAILER-DAEMON: postmaster
postmaster : root
root me
everyone::include:/lists/everyone,

    me,

    # Bob also gets a copy

    bob
# Zeb is an alias for the archive agent
zeb: "|/usr/sbin/zebTheMailArchiveAgent"

expands to the following output:


+13,10:MAILER-DAEMON->postmaster
+10,4:postmaster->root
+4,2:root->me
+8,33:everyone->:include:/lists/everyone, me, bob
+3,35:zeb->"|/usr/sbin/zebTheMailArchiveAgent"
(blank line)

Aliases2cdbm

tries to be helpful by printing warnings when it detects syntax errorsin the input. In particular,aliases2cdbmcomplains about emptykeys,emptyvalues,and lines that begin withspacebut do not continue avalue.Lines that cause a complaint fromaliases2cdbmdo not end up in the cdbmake-ifiedoutput. 

BUGS

Aliases2cdbmwas designed for use with theeximMTA (mail transport agent) version2.x, by Philip Hazel. In particular,aliases2cdbmparses the aliases file format described inexim'sspecification document, with a few additions gleaned from inspectingthe source code.Aliases2cdbmmay well not parse aliases files that work with other MTAs. Yourmileage may vary. 

SEE ALSO

The Exim Specification,available from theeximwebsite<http://www.exim.org/>.

D. J. Bernstein'scdbpackage <ftp://koobera.math.uic.edu/www/cdb.html>. 

AUTHOR

Jim Knoble <jmknobleAATTpobox.com>

Thanks to Philip Hazel and the Exim folks, D. J. Bernstein, my mom, andothers. 

LICENSE

Aliases2cdbmis Copyright 1999-2000 by the author.

Aliases2cdbmis open source software and is licensed under version 2 of the GNUGeneral Public License (GPL) <ftp://ftp.gnu.org/gnu/COPYING-2.0>, or,at your option, any later version <ftp://ftp.gnu.org/gnu/COPYING>. Formore information about open source software, please see the Open SourceInitiative's website <http://www.opensource.org/>. 

DISCLAIMER

Your mileage may vary. Eat your vegetables.


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
Input
Output
Arguments
INPUT FORMAT
BUGS
SEE ALSO
AUTHOR
LICENSE
DISCLAIMER

This document was created byman2html,using the manual pages.