mdw@git.distorted.org.uk Git - qmail/blob - qmail-start.9

   1 .TH qmail-start 8
   2 .SH NAME
   3 qmail-start \- turn on mail delivery
   4 .SH SYNOPSIS
   5 .B qmail-start
   6 [
   7 .I defaultdelivery
   8 [
   9 .I logger arg ...
  10 ]
  11 ]
  12 .SH DESCRIPTION
  13 .B qmail-start
  14 invokes
  15 .BR qmail-send ,
  16 .BR qmail-lspawn ,
  17 .BR qmail-rspawn ,
  18 and
  19 .BR qmail-clean ,
  20 under the proper uids and gids.
  21 These four daemons cooperate to deliver messages from the queue.
  22
  23 .B qmail-start
  24 arranges for
  25 .BR qmail-send 's
  26 activity record to be sent to
  27 .BR qmail-start 's
  28 output.
  29 See
  30 .B qmail-log(5)
  31 for the format of the activity record.
  32 Other than this,
  33 .B qmail-start
  34 does not print anything, even on failure.
  35
  36 If
  37 .I defaultdelivery
  38 is supplied,
  39 .B qmail-start
  40 passes it to
  41 .BR qmail-lspawn .
  42
  43 If
  44 .I logger
  45 is supplied,
  46 .B qmail-start
  47 invokes
  48 .I logger
  49 with the given arguments,
  50 and feeds
  51 .BR qmail-send 's
  52 activity record through
  53 .IR logger .
  54
  55 Environment variables given to
  56 .B qmail-start
  57 will eventually be passed on to
  58 .BR qmail-local ,
  59 so make sure to clean up the environment if you run
  60 .B qmail-start
  61 manually:
  62
  63 .EX
  64    # env - PATH="QMAILHOME/bin:$PATH"
  65 .br
  66    qmail-start ./Mailbox splogger qmail &
  67 .br
  68    (all on one line)
  69 .EE
  70
  71 Resource limits, controlling ttys, et al. are also passed from
  72 .B qmail-start
  73 to
  74 .BR qmail-local .
  75
  76 Note that
  77 .B qmail-send
  78 normally juggles several simultaneous deliveries.
  79 To reduce
  80 .BR qmail-send 's
  81 impact on other programs,
  82 you can run
  83 .B qmail-start
  84 with a low priority.
  85 .SH "SEE ALSO"
  86 logger(1),
  87 splogger(1),
  88 nice(1),
  89 qmail-log(5),
  90 qmail-local(8),
  91 qmail-clean(8),
  92 qmail-lspawn(8),
  93 qmail-rspawn(8),
  94 qmail-send(8)