Annotation of 43BSDReno/usr.bin/vacation/vacation.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1985, 1987, 1990 Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)vacation.1 6.8 (Berkeley) 6/24/90
                     19: .\"
                     20: .TH VACATION 1 "February 7, 1989"
                     21: .UC 6
                     22: .SH NAME
                     23: vacation \- return ``I am not here'' indication
                     24: .SH SYNOPSIS
                     25: .B vacation
                     26: .B -i
                     27: [
                     28: .B -r
                     29: interval ]
                     30: .br
                     31: .B vacation
                     32: [
                     33: .B -a
                     34: alias ] login
                     35: .SH DESCRIPTION
                     36: .I Vacation
                     37: returns a message to the sender of a message telling them that you
                     38: are currently not reading your mail.  The intended use is in a
                     39: .I .forward
                     40: file.  For example, your
                     41: .I .forward
                     42: file might have:
                     43: .PP
                     44: .ti +5
                     45: \eeric, "|/usr/bin/vacation -a allman eric"
                     46: .PP
                     47: which would send messages to you (assuming your login name was eric) and
                     48: reply to any messages for ``eric'' or ``allman''.
                     49: .PP
                     50: No message will be sent unless
                     51: .I login
                     52: (or an
                     53: .I alias
                     54: supplied using the
                     55: .B -a
                     56: option) is part of either the ``To:'' or ``Cc:'' headers of the mail.
                     57: No messages from ``???-REQUEST'', ``Postmaster'', ``UUCP'', ``MAILER'',
                     58: or ``MAILER-DAEMON'' will be replied to (where these strings are
                     59: case insensitive) nor is a notification sent if a ``Precedence: bulk''
                     60: or ``Precedence: junk'' line is included in the mail headers.
                     61: The people who have sent you messages are maintained as an
                     62: .IR ndbm (3)
                     63: database in the files
                     64: .I .vacation.pag
                     65: and
                     66: .I .vacation.dir
                     67: in your home directory.
                     68: .PP
                     69: The
                     70: .B -i
                     71: flag initializes the vacation database files.  It should be used
                     72: before you modify your
                     73: .I .forward
                     74: file.
                     75: .PP
                     76: The
                     77: .B -r
                     78: flag sets the reply interval to
                     79: .I interval
                     80: days.  The default is one week.  An interval of ``0'' means that
                     81: a reply is sent to each message, and an interval of ``infinite''
                     82: (actually, any non-numeric character) will never send more than
                     83: one reply.  It should be noted that intervals of ``0'' are quite
                     84: dangerous, as it allows mailers to get into ``I am on vacation''
                     85: loops.
                     86: .PP
                     87: .I Vacation
                     88: expects a file
                     89: .IR .vacation.msg ,
                     90: in your home directory, containing a message to be sent back to each
                     91: sender.  It should be an entire message (including headers).  For
                     92: example, it might contain:
                     93: .PP
                     94: .in +5
                     95: .nf
                     96: From: [email protected] (Eric Allman)
                     97: Subject: I am on vacation
                     98: Delivered-By-The-Graces-Of: The Vacation program
                     99: Precedence: bulk
                    100: 
                    101: I am on vacation until July 22.  If you have something urgent,
                    102: please contact Joe Kalash <[email protected]>.
                    103:        --eric
                    104: .fi
                    105: .in -5
                    106: .PP
                    107: .I Vacation
                    108: reads the first line from the standard input for a \s-1UNIX\s0-style
                    109: ``From'' line to determine the sender.
                    110: .IR Sendmail (8)
                    111: includes this ``From'' line automatically.
                    112: .PP
                    113: Fatal errors, such as calling
                    114: .I vacation
                    115: with incorrect arguments, or with non-existent
                    116: .IR login s,
                    117: are logged in the system log file, using
                    118: .IR syslog (8).
                    119: .SH FILES
                    120: .nf
                    121: .ta \w'~/.vacation.msg    'u
                    122: ~/.vacation.dir        database file
                    123: ~/.vacation.msg        message to send
                    124: ~/.vacation.pag        database file
                    125: .fi
                    126: .SH "SEE ALSO"
                    127: sendmail(8), syslog(8)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.