qmail-start.9
changeset 0 068428edee47
equal deleted inserted replaced
-1:000000000000 0:068428edee47
       
     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)