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