.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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 >0, 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 "SYMPA_NEWALIASES 1"
.TH SYMPA_NEWALIASES 1 "2020-12-30" "6.2.58" "sympa 6.2.58"
.\" 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"
sympa_newaliases, sympa_newaliases.pl \- Alias database maintenance
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  sympa_newaliases.pl \-\-domain=dom.ain
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fIsympa_newaliases.pl\fR is a program to maintain alias database.
.PP
It is typically invoked from
Sympa::Aliases::Template module via sympa_newaliases\-wrapper,
then updates alias database.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fIsympa_newaliases.pl\fR may run with following options.
.ie n .IP """\-\-domain=""\fIdomain\fR" 4
.el .IP "\f(CW\-\-domain=\fR\fIdomain\fR" 4
.IX Item "--domain=domain"
Name of virtual robot on which aliases will be updated.
.ie n .IP """\-h"", ""\-\-help""" 4
.el .IP "\f(CW\-h\fR, \f(CW\-\-help\fR" 4
.IX Item "-h, --help"
Print this help message.
.SH "CONFIGURATION PARAMETERS"
.IX Header "CONFIGURATION PARAMETERS"
Following site configuration parameters in \fI/etc/sympa/sympa/sympa.conf\fR will be referred.
They may be overridden by robot.conf of each virtual robot.
.IP "sendmail_aliases" 4
.IX Item "sendmail_aliases"
Source text of alias database.
.Sp
Default value is \fI\f(CI$SENDMAIL_ALIASES\fI\fR.
.IP "aliases_program" 4
.IX Item "aliases_program"
System command to update alias database.
Possible values are:
.RS 4
.ie n .IP """makemap""" 4
.el .IP "\f(CWmakemap\fR" 4
.IX Item "makemap"
Sendmail makemap utility.
.ie n .IP """newaliases""" 4
.el .IP "\f(CWnewaliases\fR" 4
.IX Item "newaliases"
\&\fBnewaliases\fR\|(1) or compatible utility.
.ie n .IP """postalias""" 4
.el .IP "\f(CWpostalias\fR" 4
.IX Item "postalias"
Postfix \fBpostalias\fR\|(1) utility.
.ie n .IP """postmap""" 4
.el .IP "\f(CWpostmap\fR" 4
.IX Item "postmap"
Postfix \fBpostmap\fR\|(1) utility.
.IP "Full path" 4
.IX Item "Full path"
Full path to executable file.
File will be invoked with the value of \f(CW\*(C`sendmail_aliases\*(C'\fR as an argument.
.RE
.RS 4
.Sp
Default value is \f(CW\*(C`newaliases\*(C'\fR.
.RE
.IP "aliases_db_type" 4
.IX Item "aliases_db_type"
Type of alias database.
This is meaningful when value of \f(CW\*(C`aliases_program\*(C'\fR parameter is
\&\f(CW\*(C`makemap\*(C'\fR, \f(CW\*(C`postalias\*(C'\fR or \f(CW\*(C`postmap\*(C'\fR.
.Sp
Possible values will be vary by system commands.
For example, \f(CW\*(C`postalias\*(C'\fR and \f(CW\*(C`postmap\*(C'\fR can support any of
\&\f(CW\*(C`btree\*(C'\fR, \f(CW\*(C`cdb\*(C'\fR, \f(CW\*(C`dbm\*(C'\fR, \f(CW\*(C`hash\*(C'\fR and \f(CW\*(C`sdbm\*(C'\fR.
.Sp
Default value is \f(CW\*(C`hash\*(C'\fR.
.SH "RETURN VALUE"
.IX Header "RETURN VALUE"
Returns with exit code 0.
If invoked system command failed, returns with its exit code.
On other failures, returns with 1.
.SH "FILES"
.IX Header "FILES"
.IP "\fI/etc/sympa/sympa/sympa.conf\fR" 4
.IX Item "/etc/sympa/sympa/sympa.conf"
Sympa site configuration.
.IP "\fI\f(CI$LIBEXECDIR\fI/sympa_newaliases\-wrapper\fR" 4
.IX Item "$LIBEXECDIR/sympa_newaliases-wrapper"
Set \s-1UID\s0 wrapper for sympa_newaliases.pl.
.SH "HISTORY"
.IX Header "HISTORY"
sympa_newaliases.pl appeared on Sympa 6.1.18.
It was initially written by
\&\s-1IKEDA\s0 Soji <ikeda@conversion.co.jp>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Sympa::Aliases::Template.