.\" 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_MSG 8"
.TH SYMPA_MSG 8 "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_msg, sympa_msg.pl \- Daemon to handle incoming messages
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\f(CW\*(C`sympa_msg.pl\*(C'\fR [\ \f(CW\*(C`\-d\*(C'\fR,\ \f(CW\*(C`\-\-debug\*(C'\fR\ ]
[\ \f(CW\*(C`\-f\*(C'\fR,\ \f(CW\*(C`\-\-file\*(C'\fR=\fIanother.sympa.conf\fR\ ]
[\ \f(CW\*(C`\-k\*(C'\fR,\ \f(CW\*(C`\-\-keepcopy\*(C'\fR=\fIdirectory\fR\ ]
[\ \f(CW\*(C`\-l\*(C'\fR,\ \f(CW\*(C`\-\-lang\*(C'\fR=\fIlang\fR\ ] [\ \f(CW\*(C`\-m\*(C'\fR,\ \f(CW\*(C`\-\-mail\*(C'\fR\ ]
[\ \f(CW\*(C`\-h\*(C'\fR,\ \f(CW\*(C`\-\-help\*(C'\fR\ ] [\ \f(CW\*(C`\-v\*(C'\fR,\ \f(CW\*(C`\-\-version\*(C'\fR\ ]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Sympa_msg.pl is a program which scans permanently the incoming message spool
and processes each message.
.PP
Messages bound for the lists and authorized sending are modified as necessity
and at last stored into digest spool, archive spool and outgoing spool.
Those bound for command addresses are interpreted and appropriate actions are
taken.
Those bound for listmasters or list admins are forwarded to them.
.SH "OPTIONS"
.IX Header "OPTIONS"
Sympa_msg.pl follows the usual \s-1GNU\s0 command line syntax,
with long options starting with two dashes (\f(CW\*(C`\-\-\*(C'\fR).  A summary of
options is included below.
.ie n .IP """\-d"", ""\-\-debug""" 4
.el .IP "\f(CW\-d\fR, \f(CW\-\-debug\fR" 4
.IX Item "-d, --debug"
Enable debug mode.
.ie n .IP """\-f"", ""\-\-config=""\fIfile\fR" 4
.el .IP "\f(CW\-f\fR, \f(CW\-\-config=\fR\fIfile\fR" 4
.IX Item "-f, --config=file"
Force Sympa to use an alternative configuration file instead
of \fI/etc/sympa/sympa/sympa.conf\fR.
.ie n .IP """\-l"", ""\-\-lang=""\fIlang\fR" 4
.el .IP "\f(CW\-l\fR, \f(CW\-\-lang=\fR\fIlang\fR" 4
.IX Item "-l, --lang=lang"
Set this option to use a language for Sympa. The corresponding
gettext catalog file must be located in \fI\f(CI$LOCALEDIR\fI\fR
directory.
.ie n .IP """\-\-log_level=""\fIlevel\fR" 4
.el .IP "\f(CW\-\-log_level=\fR\fIlevel\fR" 4
.IX Item "--log_level=level"
Sets Sympa log level.
.PP
\&\fIsympa_msg.pl\fR may run in daemon mode with following options.
.ie n .IP """\-\-foreground""" 4
.el .IP "\f(CW\-\-foreground\fR" 4
.IX Item "--foreground"
The process remains attached to the \s-1TTY.\s0
.ie n .IP """\-k"", ""\-\-keepcopy=""\fIdirectory\fR" 4
.el .IP "\f(CW\-k\fR, \f(CW\-\-keepcopy=\fR\fIdirectory\fR" 4
.IX Item "-k, --keepcopy=directory"
This option tells Sympa to keep a copy of every incoming message, 
instead of deleting them. `directory' is the directory to 
store messages.
.ie n .IP """\-m"", ""\-\-mail""" 4
.el .IP "\f(CW\-m\fR, \f(CW\-\-mail\fR" 4
.IX Item "-m, --mail"
Sympa will log calls to sendmail, including recipients. This option is
useful for keeping track of each mail sent (log files may grow faster
though).
.ie n .IP """\-\-service=""\fIservice\fR" 4
.el .IP "\f(CW\-\-service=\fR\fIservice\fR" 4
.IX Item "--service=service"
\&\fBNote\fR:
This option was deprecated.
.Sp
Process is dedicated to messages distribution (\f(CW\*(C`process_message\*(C'\fR),
commands (\f(CW\*(C`process_command\*(C'\fR) or to automatic lists
creation (\f(CW\*(C`process_creation\*(C'\fR, default three of them).
.PP
With following options \fIsympa_msg.pl\fR will print some information and exit.
.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.
.ie n .IP """\-v"", ""\-\-version""" 4
.el .IP "\f(CW\-v\fR, \f(CW\-\-version\fR" 4
.IX Item "-v, --version"
Print the version number.
.SH "FILES"
.IX Header "FILES"
\&\fI/etc/sympa/sympa/sympa.conf\fR main configuration file.
.PP
\&\fI\f(CI$PIDDIR\fI/sympa_msg.pid\fR this file contains the process \s-1ID\s0
of \fIsympa_msg.pl\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBsympa.conf\fR\|(5), \fBsympa\fR\|(1).
.PP
\&\fBarchived\fR\|(8), \fBbulk\fR\|(8), \fBbounced\fR\|(8), \fBsympa_automatic\fR\|(8),
\&\fBtask_manager\fR\|(8).
.PP
Sympa::Spindle::ProcessDigest,
Sympa::Spindle::ProcessIncoming.
.SH "HISTORY"
.IX Header "HISTORY"
\&\fIsympa.pl\fR was originally written by:
.IP "Serge Aumont" 4
.IX Item "Serge Aumont"
Comite\*' Re\*'seau des Universite\*'s
.IP "Olivier Salau\*:n" 4
.IX Item "Olivier Salau:n"
Comite\*' Re\*'seau des Universite\*'s
.PP
As of Sympa 6.2b.4, it was split into three programs:
\&\fIsympa.pl\fR command line utility, \fIsympa_automatic.pl\fR daemon and
\&\fIsympa_msg.pl\fR daemon.