xref: /netbsd-src/external/ibm-public/postfix/dist/html/pickup.8.html (revision 059c16a85b0b39d60ad6d18f53c09510815afa2b)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
6<title> Postfix manual - pickup(8) </title>
7</head> <body> <pre>
8PICKUP(8)                                                            PICKUP(8)
9
10<b>NAME</b>
11       pickup - Postfix local mail pickup
12
13<b>SYNOPSIS</b>
14       <b>pickup</b> [generic Postfix daemon options]
15
16<b>DESCRIPTION</b>
17       The  <a href="pickup.8.html"><b>pickup</b>(8)</a>  daemon  waits  for hints that new mail has been dropped
18       into the <b>maildrop</b> directory, and feeds it into the  <a href="cleanup.8.html"><b>cleanup</b>(8)</a>  daemon.
19       Ill-formatted files are deleted without notifying the originator.  This
20       program expects to be run from the <a href="master.8.html"><b>master</b>(8)</a> process manager.
21
22<b>STANDARDS</b>
23       None. The <a href="pickup.8.html"><b>pickup</b>(8)</a> daemon does not interact with the outside world.
24
25<b>SECURITY</b>
26       The <a href="pickup.8.html"><b>pickup</b>(8)</a> daemon is moderately security  sensitive.  It  runs  with
27       fixed  low  privilege  and can run in a chrooted environment.  However,
28       the program reads files from potentially hostile users.  The  <a href="pickup.8.html"><b>pickup</b>(8)</a>
29       daemon opens no files for writing, is careful about what files it opens
30       for reading, and does not actually touch any data that is sent  to  its
31       public service endpoint.
32
33<b>DIAGNOSTICS</b>
34       Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
35
36<b>BUGS</b>
37       The  <a href="pickup.8.html"><b>pickup</b>(8)</a>  daemon  copies mail from file to the <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon.
38       It could avoid message copying overhead by sending  a  file  descriptor
39       instead  of  file  data, but then the already complex <a href="cleanup.8.html"><b>cleanup</b>(8)</a> daemon
40       would have to deal with unfiltered user data.
41
42<b>CONFIGURATION PARAMETERS</b>
43       As the <a href="pickup.8.html"><b>pickup</b>(8)</a> daemon is a relatively long-running process, up to  an
44       hour  may  pass  before a <a href="postconf.5.html"><b>main.cf</b></a> change takes effect.  Use the command
45       "<b>postfix reload</b>" command to speed up a change.
46
47       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
48       more details including examples.
49
50<b>CONTENT INSPECTION CONTROLS</b>
51       <b><a href="postconf.5.html#content_filter">content_filter</a> (empty)</b>
52              After  the  message  is  queued,  send the entire message to the
53              specified <i>transport:destination</i>.
54
55       <b><a href="postconf.5.html#receive_override_options">receive_override_options</a> (empty)</b>
56              Enable or disable recipient validation, built-in content filter-
57              ing, or address mapping.
58
59<b>MISCELLANEOUS CONTROLS</b>
60       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
61              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
62              figuration files.
63
64       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
65              The time limit for sending  or  receiving  information  over  an
66              internal communication channel.
67
68       <b><a href="postconf.5.html#line_length_limit">line_length_limit</a> (2048)</b>
69              Upon  input,  long  lines  are chopped up into pieces of at most
70              this length; upon delivery, long lines are reconstructed.
71
72       <b><a href="postconf.5.html#max_idle">max_idle</a> (100s)</b>
73              The maximum amount of time that an idle Postfix  daemon  process
74              waits for an incoming connection before terminating voluntarily.
75
76       <b><a href="postconf.5.html#max_use">max_use</a> (100)</b>
77              The maximal number of incoming connections that a Postfix daemon
78              process will service before terminating voluntarily.
79
80       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
81              The process ID of a Postfix command or daemon process.
82
83       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
84              The process name of a Postfix command or daemon process.
85
86       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
87              The location of the Postfix top-level queue directory.
88
89       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
90              The syslog facility of Postfix logging.
91
92       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
93              A  prefix  that  is  prepended  to  the  process  name in syslog
94              records, so that, for example, "smtpd" becomes "prefix/smtpd".
95
96       Available in Postfix 3.3 and later:
97
98       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
99              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
100
101       Available in Postfix 3.5 and later:
102
103       <b><a href="postconf.5.html#info_log_address_format">info_log_address_format</a> (external)</b>
104              The email address form that will be used  in  non-debug  logging
105              (info, warning, etc.).
106
107<b>SEE ALSO</b>
108       <a href="cleanup.8.html">cleanup(8)</a>, message canonicalization
109       <a href="sendmail.1.html">sendmail(1)</a>, Sendmail-compatible interface
110       <a href="postdrop.1.html">postdrop(1)</a>, mail posting agent
111       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
112       <a href="master.5.html">master(5)</a>, generic daemon options
113       <a href="master.8.html">master(8)</a>, process manager
114       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
115       syslogd(8), system logging
116
117<b>LICENSE</b>
118       The Secure Mailer license must be distributed with this software.
119
120<b>AUTHOR(S)</b>
121       Wietse Venema
122       IBM T.J. Watson Research
123       P.O. Box 704
124       Yorktown Heights, NY 10598, USA
125
126       Wietse Venema
127       Google, Inc.
128       111 8th Avenue
129       New York, NY 10011, USA
130
131                                                                     PICKUP(8)
132</pre> </body> </html>
133