vacation(1) User Commands vacation(1)NAMEvacation - reply to mail automatically
SYNOPSISvacation [-I]
vacation [-a alias] [-e filter_file] [-f database_file] [-j] [-m mes‐
sage_file] [-s sender] [-tN] username
DESCRIPTION
The vacation utility automatically replies to incoming mail.
Installation
The installation consists of an interactive program which sets up vaca‐
tion's basic configuration.
To install vacation, type it with no arguments on the command line.
The program creates a .vacation.msg file, which contains the message
that is automatically sent to all senders when vacation is enabled, and
starts an editor for you to modify the message. (See USAGE section.)
Which editor is invoked is determined by the VISUAL or EDITOR environ‐
ment variable, or vi(1) if neither of those environment variables are
set.
A .forward file is also created if one does not exist in your home
directory. Once created, the .forward file will contain a line of the
form:
One copy of an incoming message is sent to the username and another
copy is piped into vacation:
\username, "|/usr/bin/vacation username"
If a .forward file is present in your home directory, it will ask
whether you want to remove it, which disables vacation and ends the
installation.
The program automatically creates .vacation.pag and .vacation.dir,
which contain a list of senders when vacation is enabled.
Activation and Deactivation
The presence of the .forward file determines whether or not vacation is
disabled or enabled. To disable vacation, remove the .forward file, or
move it to a new name.
Initialization
The -I option clears the vacation log files, .vacation.pag and .vaca‐
tion.dir, erasing the list of senders from a previous vacation session.
(See OPTIONS section.)
Additional Configuration
vacation provides configuration options that are not part of the
installation, these being -a, -e, -f, -j, -m, -s, and -t. (See OPTIONS
section.)
OPTIONS
The following options are supported:
-I Initializes the .vacation.pag and .vacation.dir files and
enables vacation. If the -I flag is not specified, and a user
argument is given, vacation reads the first line from the
standard input (for a From: line, no colon). If absent, it
produces an error message.
Options -a, -e, -f, -j, -m, -s, and -t are configuration options to be
used in conjunction with vacation in the .forward file, not on the com‐
mand line. For example,
\username, "|/usr/bin/vacation -t1m username"
repeats replies to the sender every minute.
-a alias Indicates that alias is one of the valid
aliases for the user running vacation, so that
mail addressed to that alias generates a reply.
-e filter_file Uses filter_file instead of .vacation.filter as
the source of the domain and email address fil‐
ters.
-f database_file Uses database_file instead of .vacation as the
base name for the database file.
-j Does not check whether the recipient appears in
the To: or the Cc: line. Warning: use of this
option can result in vacation replies being
sent to mailing lists and other inappropriate
places; its use is therefore strongly discour‐
aged.
-m message_file Uses ~/message_file as the message to send for
the reply instead of ~/.vacation.msg. mes‐
sage_file is a relative path to the desired
vacation message file. To prevent direc‐
tory/file "not found" errors, message_file
should be on the same disk partition as ~/.for‐
ward.
-s sender Replies to sender instead of the value read
from the UNIX From line of the incoming mes‐
sage.
-tN Changes the interval between repeat replies to
the same sender. The default is 1 week. A
trailing s, m, h, d, or w scales N to seconds,
minutes, hours, days, or weeks, respectively.
USAGE
.vacation.msg should include a header with at least a Subject: line (it
should not include a To: line). For example:
Subject: I am on vacation
I am on vacation until July 22. If you have something urgent,
please contact Joe Jones (jones@fB0).
--John
If the string $SUBJECT appears in the .vacation.msg file, it is
replaced with the subject of the original message when the reply is
sent. Thus, a .vacation.msg file such as
Subject: I am on vacation
I am on vacation until July 22.
Your mail regarding "$SUBJECT" will be read when I return.
If you have something urgent, please contact
Joe Jones (jones@fB0).
--John
will include the subject of the message in the reply.
No message is sent if the To: or the Cc: line does not list the user to
whom the original message was sent or one of a number of aliases for
them, if the initial From line includes the string −REQUEST@, or if a
Precedence: bulk or Precedence: junk line is included in the header.
vacation will also not respond to mail from either postmaster or
Mailer-Daemon.
In addition to the above criteria, if a .vacation.filter file exists,
it is used to constrain further the set of addresses to which a reply
is sent. Each line in that file should be either a domain name or an
email address. If the incoming sender address matches one of the lines
in the file, a reply is sent. If no lines match, no reply is sent. For
lines containing an email address, the match must be exact, except for
case, which is ignored. For lines containing a domain name, the sender
address must be either something@domain-name or something@some‐
thing.domain-name. A sample filter file might look like the following:
sun.com
mydomain.com
onefriend@hisisp.com
anotherfriend@herisp.com
Note: Blank lines and lines starting with "#" are ignored.
FILES
~/.forward
~/.vacation.filter
~/.vacation.msg
A list of senders is kept in the dbm format files .vacation.pag and
.vacation.dir in your home directory. These files are dbm files and
cannot be viewed directly with text editors.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWsndmu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOvi(1), sendmail(1M), dbm(3UCB), getusershell(3C), aliases(4),
shells(4), attributes(5)SunOS 5.10 19 Mar 2004 vacation(1)
