external/ibm-public/postfix/dist/man/man8/pickup.8

   1 .\"     $NetBSD$
   2 .\"
   3 .TH PICKUP 8
   4 .ad
   5 .fi
   6 .SH NAME
   7 pickup
   8 \-
   9 Postfix local mail pickup
  10 .SH "SYNOPSIS"
  11 .na
  12 .nf
  13 \fBpickup\fR [generic Postfix daemon options]
  14 .SH DESCRIPTION
  15 .ad
  16 .fi
  17 The \fBpickup\fR(8) daemon waits for hints that new mail has been
  18 dropped into the \fBmaildrop\fR directory, and feeds it into the
  19 \fBcleanup\fR(8) daemon.
  20 Ill-formatted files are deleted without notifying the originator.
  21 This program expects to be run from the \fBmaster\fR(8) process
  22 manager.
  23 .SH "STANDARDS"
  24 .na
  25 .nf
  26 .ad
  27 .fi
  28 None. The \fBpickup\fR(8) daemon does not interact with
  29 the outside world.
  30 .SH "SECURITY"
  31 .na
  32 .nf
  33 .ad
  34 .fi
  35 The \fBpickup\fR(8) daemon is moderately security sensitive. It runs
  36 with fixed low privilege and can run in a chrooted environment.
  37 However, the program reads files from potentially hostile users.
  38 The \fBpickup\fR(8) daemon opens no files for writing, is careful about
  39 what files it opens for reading, and does not actually touch any data
  40 that is sent to its public service endpoint.
  41 .SH DIAGNOSTICS
  42 .ad
  43 .fi
  44 Problems and transactions are logged to \fBsyslogd\fR(8).
  45 .SH BUGS
  46 .ad
  47 .fi
  48 The \fBpickup\fR(8) daemon copies mail from file to the \fBcleanup\fR(8)
  49 daemon.  It could avoid message copying overhead by sending a file
  50 descriptor instead of file data, but then the already complex
  51 \fBcleanup\fR(8) daemon would have to deal with unfiltered user data.
  52 .SH "CONFIGURATION PARAMETERS"
  53 .na
  54 .nf
  55 .ad
  56 .fi
  57 As the \fBpickup\fR(8) daemon is a relatively long-running process, up
  58 to an hour may pass before a \fBmain.cf\fR change takes effect.
  59 Use the command "\fBpostfix reload\fR" command to speed up a change.
  60
  61 The text below provides only a parameter summary. See
  62 \fBpostconf\fR(5) for more details including examples.
  63 .SH "CONTENT INSPECTION CONTROLS"
  64 .na
  65 .nf
  66 .ad
  67 .fi
  68 .IP "\fBcontent_filter (empty)\fR"
  69 The name of a mail delivery transport that filters mail after
  70 it is queued.
  71 .IP "\fBreceive_override_options (empty)\fR"
  72 Enable or disable recipient validation, built-in content
  73 filtering, or address mapping.
  74 .SH "MISCELLANEOUS CONTROLS"
  75 .na
  76 .nf
  77 .ad
  78 .fi
  79 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
  80 The default location of the Postfix main.cf and master.cf
  81 configuration files.
  82 .IP "\fBipc_timeout (3600s)\fR"
  83 The time limit for sending or receiving information over an internal
  84 communication channel.
  85 .IP "\fBline_length_limit (2048)\fR"
  86 Upon input, long lines are chopped up into pieces of at most
  87 this length; upon delivery, long lines are reconstructed.
  88 .IP "\fBmax_idle (100s)\fR"
  89 The maximum amount of time that an idle Postfix daemon process waits
  90 for an incoming connection before terminating voluntarily.
  91 .IP "\fBmax_use (100)\fR"
  92 The maximal number of incoming connections that a Postfix daemon
  93 process will service before terminating voluntarily.
  94 .IP "\fBprocess_id (read-only)\fR"
  95 The process ID of a Postfix command or daemon process.
  96 .IP "\fBprocess_name (read-only)\fR"
  97 The process name of a Postfix command or daemon process.
  98 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
  99 The location of the Postfix top-level queue directory.
 100 .IP "\fBsyslog_facility (mail)\fR"
 101 The syslog facility of Postfix logging.
 102 .IP "\fBsyslog_name (see 'postconf -d' output)\fR"
 103 The mail system name that is prepended to the process name in syslog
 104 records, so that "smtpd" becomes, for example, "postfix/smtpd".
 105 .SH "SEE ALSO"
 106 .na
 107 .nf
 108 cleanup(8), message canonicalization
 109 sendmail(1), Sendmail-compatible interface
 110 postdrop(1), mail posting agent
 111 postconf(5), configuration parameters
 112 master(5), generic daemon options
 113 master(8), process manager
 114 syslogd(8), system logging
 115 .SH "LICENSE"
 116 .na
 117 .nf
 118 .ad
 119 .fi
 120 The Secure Mailer license must be distributed with this software.
 121 .SH "AUTHOR(S)"
 122 .na
 123 .nf
 124 Wietse Venema
 125 IBM T.J. Watson Research
 126 P.O. Box 704
 127 Yorktown Heights, NY 10598, USA