vacation(1)vacation(1)NAMEvacation - return "I am not here" indication
SYNOPSIS
alias]... login
DESCRIPTION
The program returns a message to the sender of a message telling them
that you are currently not reading your mail. The intended use is in a
file in For example, your file might contain:
which would send messages to you (assuming your login name was and
reply to any messages for or The preceding is required to force direct
delivery to mailbox and prevent an infinite loop through the file. The
double quotes are needed to tell sendmail(1M) to treat the enclosed as
a unit, rather than separate recipients. It is also important to spec‐
ify the full path for the vacation program, and there must be no white
space between the character and the start of the path name.
No message is sent unless login or an alias supplied using the option
is a substring of either the or headers of the mail. No messages from
or are replied to, nor is a notification sent if a or line is included
in the mail headers. Only one message per week is sent to each unique
sender (at each unique host system). The people who have sent you mes‐
sages are recorded in a database in the files and in your home direc‐
tory.
The program expects a file in your home directory, containing a message
to be sent back to each sender. It should be an entire message
(including headers). For example, it might say:
>From: eric@ucbmonet.Berkeley.EDU (Eric Allman)
Subject: I am on vacation
X-Delivered-By-The-Graces-Of: The vacation program
Precedence: bulk
I am on vacation until July 22. If you have something urgent,
please contact Joe Kalash <kalash@ucbingres.Berkeley.EDU>.
--eric
Header lines in this file must be left-aligned and must not be preceded
by any other lines, including blank lines (see sendmail(1M)). If there
is no file, uses the following file (if it exists):
Otherwise, it logs an error.
reads the first line from the standard input (the incoming mail message
in the example file above) for a UNIX style line to determine the
sender. sendmail(1M) includes this line automatically, and its absence
indicates non-mail input.
Options
The program supports the following options:
Initializes the vacation database files.
This option should be used before modifying a
file.
Identifies another name that can legitimately appear in the
line of the mail header instead of your login
name. More than one option can be specified.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which error messages are printed.
DIAGNOSTICS
On error, exits with a value from and causes to report an error back to
the sender of the original message. Errors such as the absence of or
calling with incorrect arguments, are logged using on the system where
actually runs (see syslogd(1M)). The file by default; see and sys‐
logd(1M) for customizations) should be inspected when generates mailer
error messages.
Remember that if the machine is configured for shared mail, inbound
mail is handled at the mail server rather than on mail client nodes.
This means that diagnostics appear in the mail server's not the
client's
WARNINGS
Errors in the file can lead to loss of mail and infinite mail loops.
Always send test mail to yourself after configuring to be sure that it
is working properly. This is akin to checking telephone forwarding
before leaving for an extended period, and can prevent loss of mes‐
sages.
Some mail recipients look for an RFC 822 compliant header in their
incoming mail messages. Such recipients have to set the option to in
the configuration file,
AUTHOR
was developed by Eric Allman and the University of California, Berke‐
ley.
FILES
Database file.
Message to send.
Database file.
System-wide default header and message.
Dictates where error messages are recorded.
SEE ALSOsendmail(1M), syslogd(1M), ndbm(3X).
vacation(1)
