~ubuntu-branches/ubuntu/raring/postfix/raring

« back to all changes in this revision

Viewing changes to html/spawn.8.html

Tags: upstream-2.2.6
ImportĀ upstreamĀ versionĀ 2.2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5
5
<title> Postfix manual - spawn(8) </title>
6
6
</head> <body> <pre>
7
 
SPAWN(8)                                                 SPAWN(8)
 
7
SPAWN(8)                                                              SPAWN(8)
8
8
 
9
9
<b>NAME</b>
10
10
       spawn - Postfix external command spawner
13
13
       <b>spawn</b> [generic Postfix daemon options] command_attributes...
14
14
 
15
15
<b>DESCRIPTION</b>
16
 
       The <b>spawn</b> daemon provides the Postfix equivalent of <b>inetd</b>.
17
 
       It listens on a port as specified in the Postfix <b>master.cf</b>
18
 
       file  and spawns an external command whenever a connection
19
 
       is established.  The connection can be made over local IPC
20
 
       (such  as UNIX-domain sockets) or over non-local IPC (such
21
 
       as TCP sockets).  The command's standard input, output and
22
 
       error  streams are connected directly to the communication
23
 
       endpoint.
 
16
       The  <a href="spawn.8.html"><b>spawn</b>(8)</a>  daemon  provides  the Postfix equivalent of
 
17
       <b>inetd</b>.  It listens on a port as specified in  the  Postfix
 
18
       <b>master.cf</b>  file  and spawns an external command whenever a
 
19
       connection is established.  The  connection  can  be  made
 
20
       over  local IPC (such as UNIX-domain sockets) or over non-
 
21
       local IPC (such as TCP sockets).  The  command's  standard
 
22
       input,  output and error streams are connected directly to
 
23
       the communication endpoint.
24
24
 
25
25
       This daemon expects to be run from the  <a href="master.8.html"><b>master</b>(8)</a>  process
26
26
       manager.
38
38
              execute  commands with root privileges, or with the
39
39
              privileges of the mail system owner.  If  <i>groupname</i>
40
40
              is  specified,  the  corresponding group ID is used
41
 
              instead of the group ID of of <i>username</i>.
 
41
              instead of the group ID of <i>username</i>.
42
42
 
43
43
       <b>argv</b>=<i>command</i>... (required)
44
44
              The command to be executed. This must be  specified
49
49
 
50
50
<b>BUGS</b>
51
51
       In order to enforce standard Postfix process resource con-
52
 
       trols,  the <b>spawn</b> daemon runs only one external command at
53
 
       a time.  As such, it presents  a  noticeable  overhead  by
54
 
       wasting  precious  process  resources. The <b>spawn</b> daemon is
 
52
       trols,  the <a href="spawn.8.html"><b>spawn</b>(8)</a> daemon runs only one external command
 
53
       at a time.  As such, it presents a noticeable overhead  by
 
54
       wasting precious process resources. The <a href="spawn.8.html"><b>spawn</b>(8)</a> daemon is
55
55
       expected to be replaced by a more structural solution.
56
56
 
57
57
<b>DIAGNOSTICS</b>
58
 
       The <b>spawn</b> daemon reports abnormal child  exits.   Problems
59
 
       are logged to <b>syslogd</b>(8).
 
58
       The <a href="spawn.8.html"><b>spawn</b>(8)</a> daemon reports abnormal child  exits.   Prob-
 
59
       lems are logged to <b>syslogd</b>(8).
60
60
 
61
61
<b>SECURITY</b>
62
62
       This  program  needs  root  privilege  in order to execute
63
63
       external commands as the specified user. It  is  therefore
64
 
       security  sensitive.   However  the  <b>spawn</b> daemon does not
 
64
       security  sensitive.  However the <a href="spawn.8.html"><b>spawn</b>(8)</a> daemon does not
65
65
       talk to the external command and thus is not vulnerable to
66
66
       data-driven attacks.
67
67
 
68
68
<b>CONFIGURATION PARAMETERS</b>
69
 
       Changes to <b>main.cf</b> are picked up automatically as <a href="spawn.8.html">spawn(8)</a>
 
69
       Changes to <b>main.cf</b> are picked up automatically as <a href="spawn.8.html"><b>spawn</b>(8)</a>
70
70
       processes run for only a limited amount of time.  Use  the
71
71
       command "<b>postfix reload</b>" to speed up a change.
72
72
 
73
73
       The  text  below  provides  only  a parameter summary. See
74
 
       <a href="postconf.5.html">postconf(5)</a> for more details including examples.
 
74
       <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
75
75
 
76
76
       In the text below, <i>transport</i> is the  first  field  of  the
77
77
       entry in the <b>master.cf</b> file.
113
113
              Postfix daemon process terminates.
114
114
 
115
115
       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
116
 
              The  process ID of a Postfix command or daemon pro-
117
 
              cess.
 
116
              The  process  ID  of  a  Postfix  command or daemon
 
117
              process.
118
118
 
119
119
       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
120
120
              The process name of a  Postfix  command  or  daemon
128
128
              The syslog facility of Postfix logging.
129
129
 
130
130
       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (postfix)</b>
131
 
              The mail system name that is prepended to the  pro-
132
 
              cess  name  in  syslog  records,  so  that  "smtpd"
 
131
              The mail system  name  that  is  prepended  to  the
 
132
              process  name  in  syslog  records, so that "smtpd"
133
133
              becomes, for example, "postfix/smtpd".
134
134
 
135
135
<b>SEE ALSO</b>
147
147
       P.O. Box 704
148
148
       Yorktown Heights, NY 10598, USA
149
149
 
150
 
                                                         SPAWN(8)
 
150
                                                                      SPAWN(8)
151
151
</pre> </body> </html>