contrib/sendmail-8.14/vacation/vacation.0

   1 VACATION(1)                                                        VACATION(1)
   2
   3
   4
   5 N\bNA\bAM\bME\bE
   6        vacation - E-mail auto-responder
   7
   8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
   9        v\bva\bac\bca\bat\bti\bio\bon\bn  [-\b-a\ba _\ba_\bl_\bi_\ba_\bs] [-\b-C\bC _\bc_\bf_\bf_\bi_\bl_\be] [-\b-d\bd] [-\b-f\bf _\bd_\ba_\bt_\ba_\bb_\ba_\bs_\be] [-\b-i\bi] [-\b-I\bI] [-\b-j\bj] [-\b-l\bl]
  10        [-\b-m\bm _\bm_\be_\bs_\bs_\ba_\bg_\be] [-\b-R\bR _\br_\be_\bt_\bu_\br_\bn_\ba_\bd_\bd_\br] [-\b-r\br _\bi_\bn_\bt_\be_\br_\bv_\ba_\bl] [-\b-s\bs _\ba_\bd_\bd_\br_\be_\bs_\bs] [-\b-t\bt _\bt_\bi_\bm_\be]  [-\b-U\bU]
  11        [-\b-x\bx] [-\b-z\bz] _\bl_\bo_\bg_\bi_\bn
  12
  13 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  14        V\bVa\bac\bca\bat\bti\bio\bon\bn  returns  a message, _\b~_\b/_\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\bm_\bs_\bg by default, to the sender
  15        informing them that you are currently not reading your mail.  The  mes-
  16        sage  is  only  sent  to  each  sender  once per reply interval (see -\b-r\br
  17        below).  The intended use is in a _\b._\bf_\bo_\br_\bw_\ba_\br_\bd  file.   For  example,  your
  18        _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file might have:
  19
  20               \eric, "|/usr/bin/vacation -a allman eric"
  21
  22        which  would  send  messages to you (assuming your login name was eric)
  23        and reply to any messages for ``eric'' or ``allman''.
  24
  25        Available options:
  26
  27        -\b-a\ba _\ba_\bl_\bi_\ba_\bs
  28               Handle messages for _\ba_\bl_\bi_\ba_\bs in the same manner as  those  received
  29               for the user's login name.
  30
  31        -\b-C\bC _\bc_\bf_\bp_\ba_\bt_\bh
  32               Specify  pathname  of  the  sendmail  configuration  file.  This
  33               option is ignored if -\b-U\bU is specified.  This option  defaults  to
  34               the   standard   sendmail   configuration   file,   located   at
  35               /etc/mail/sendmail.cf on most systems.
  36
  37        -\b-d\bd     Send error/debug messages to stderr instead of  syslog.   Other-
  38               wise,  fatal  errors,  such  as  calling v\bva\bac\bca\bat\bti\bio\bon\bn with incorrect
  39               arguments, or with non-existent _\bl_\bo_\bg_\bi_\bns, are logged in the system
  40               log file, using syslog(8).  This should only be used on the com-
  41               mand line, not in your _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file.
  42
  43        -\b-f\bf _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
  44               Use _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be as name of the database instead  of  _\b~_\b/_\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\bd_\bb
  45               or  _\b~_\b/_\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\b{_\bd_\bi_\br_\b,_\bp_\ba_\bg_\b}.  Unless the _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be starts with / it
  46               is relative to ~.
  47
  48        -\b-i\bi     Initialize the vacation  database  files.   It  should  be  used
  49               before  you modify your _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file.  This should only be used
  50               on the command line, not in your _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file.
  51
  52        -\b-I\bI     Same as -\b-i\bi (for backwards compatibility).  This should  only  be
  53               used on the command line, not in your _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file.
  54
  55        -\b-j\bj     Respond to the message regardless of whether the login is listed
  56               as a recipient for the message.  Do not use this flag unless you
  57               are  sure  of the consequences.  For example, this will cause to
  58               reply to mailing list messages which may result in removing  you
  59               from the list.
  60
  61        -\b-l\bl     List  the  content  of  the vacation database file including the
  62               address and the associated time of  the  last  auto-response  to
  63               that address.  This should only be used on the command line, not
  64               in your _\b._\bf_\bo_\br_\bw_\ba_\br_\bd file.
  65
  66        -\b-m\bm _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
  67               Use _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be as name of the file containing the message to  send
  68               instead  of  _\b~_\b/_\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\bm_\bs_\bg.  Unless the _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be starts with /
  69               it is relative to ~.
  70
  71        -\b-R\bR _\br_\be_\bt_\bu_\br_\bn_\ba_\bd_\bd_\br
  72               Set the reply envelope sender address
  73
  74        -\b-r\br _\bi_\bn_\bt_\be_\br_\bv_\ba_\bl
  75               Set the reply interval to _\bi_\bn_\bt_\be_\br_\bv_\ba_\bl days.   The  default  is  one
  76               week.   An interval of ``0'' or ``infinite'' (actually, any non-
  77               numeric character) will never send more than one reply.  The  -\b-r\br
  78               option  should  only  be used when the vacation database is ini-
  79               tialized (see -\b-i\bi above).
  80
  81        -\b-s\bs _\ba_\bd_\bd_\br_\be_\bs_\bs
  82               Use _\ba_\bd_\bd_\br_\be_\bs_\bs instead of the incoming message  sender  address  on
  83               the _\bF_\br_\bo_\bm line as the recipient for the vacation message.
  84
  85        -\b-t\bt _\bt_\bi_\bm_\be
  86               Ignored,  available  only  for compatibility with Sun's vacation
  87               program.
  88
  89        -\b-U\bU     Do not attempt to lookup _\bl_\bo_\bg_\bi_\bn in the password file.  The -f and
  90               -m options must be used to specify the database and message file
  91               since there is no home directory for the  default  settings  for
  92               these options.
  93
  94        -\b-x\bx     Reads  an  exclusion  list  from  stdin  (one address per line).
  95               Mails coming from an address in this exclusion list won't get  a
  96               reply  by  v\bva\bac\bca\bat\bti\bio\bon\bn.  It is possible to exclude complete domains
  97               by specifying ``@domain'' as  element  of  the  exclusion  list.
  98               This  should only be used on the command line, not in your _\b._\bf_\bo_\br_\b-
  99               _\bw_\ba_\br_\bd file.
 100
 101        -\b-z\bz     Set the sender of the vacation message to ``<>'' instead of  the
 102               user.   This  probably violates the RFCs since vacation messages
 103               are not required  by  a  standards-track  RFC  to  have  a  null
 104               reverse-path.
 105
 106        V\bVa\bac\bca\bat\bti\bio\bon\bn  reads  the  first  line  from  the  standard input for a UNIX
 107        ``From'' line to  determine  the  sender.   Sendmail(8)  includes  this
 108        ``From'' line automatically.
 109
 110        No message will be sent unless _\bl_\bo_\bg_\bi_\bn (or an _\ba_\bl_\bi_\ba_\bs supplied using the -\b-a\ba
 111        option) is part of either the ``To:'' or ``Cc:'' headers of  the  mail.
 112        No   messages   from   ``???-REQUEST'',  ``???-RELAY'',  ``???-OWNER'',
 113        ``OWNER-???'', ``Postmaster'', ``UUCP'', ``MAILER'',  or  ``MAILER-DAE-
 114        MON'' will be replied to (where these strings are case insensitive) nor
 115        is a notification sent  if  a  ``Precedence:  bulk''  or  ``Precedence:
 116        junk''  line is included in the mail headers.  The people who have sent
 117        you messages are maintained as a db(3) or dbm(3) database in  the  file
 118        _\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\bd_\bb or _\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\b{_\bd_\bi_\br_\b,_\bp_\ba_\bg_\b} in your home directory.
 119
 120        V\bVa\bac\bca\bat\bti\bio\bon\bn expects a file _\b._\bv_\ba_\bc_\ba_\bt_\bi_\bo_\bn_\b._\bm_\bs_\bg, in your home directory, contain-
 121        ing a message to be sent back to each sender.  It should be  an  entire
 122        message (including headers).  For example, it might contain:
 123
 124               From: eric@CS.Berkeley.EDU (Eric Allman)
 125               Subject: I am on vacation
 126               Delivered-By-The-Graces-Of: The Vacation program
 127               Precedence: bulk
 128
 129               I am on vacation until July 22.  If you have something urgent,
 130               please contact Keith Bostic <bostic@CS.Berkeley.EDU>.
 131               --eric
 132
 133 F\bFI\bIL\bLE\bES\bS
 134        ~/.vacation.db    default database file for db(3)
 135
 136        ~/.vacation.{dir,pag}
 137                          default database file for dbm(3)
 138
 139        ~/.vacation.msg   default message to send
 140
 141 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 142        sendmail(8), syslog(8)
 143
 144 H\bHI\bIS\bST\bTO\bOR\bRY\bY
 145        The v\bva\bac\bca\bat\bti\bio\bon\bn command appeared in 4.3BSD.
 146
 147
 148
 149                          $Date: 2002/06/27 23:51:52 $              VACATION(1)