If you are not familiar with how to access the departmental server, please check out the Physics IT Essentials documentation section.
The simplest method to set up your vacation message is to access the online form at:
Follow the instructions presented there.
Overview Command Line
Setting up your vacation message consists of three steps:
- initialize the sender address database
- compose your vacation message
- tell the mail filter that you are on vacation
- Delete $HOME/.vacation.cache if it exists
- Update .vacation.msg
- Set VACATION=“yes” in your procmail
Initializing the Vacation Database
The vacation program does not reply to every sender with every message. When someone sends you an email, the vacation program replies to the first message from a given sender and then saves that address in a small database. Further messages from that address are ignored for a configurable amount of time which defaults to one week.
To initialize the database, do the following:
# if $HOME/.vacation.cache exists
The Two Important Files
The message containing the vacation message is called
.vacation.msg and the file containing your personal filtering rules is called
.procmailrc. Both of these files must be present and correctly set if you are using both spam filtering and the vacation auto-reply.
Because both filenames start with a dot ("."); they are invisible files, not shown by a normal file listing. However if they are explicitly named they will be shown.
.vacation.msg Contains the actual vacation message.
.procmailr contains rules for filtering email.
Open this file with an editor and add text similar to the following:
Subject: On vacation (was: $SUBJECT)
I am currently away from the office and will not be reading email
during the period July 6, 2004 to July 21, 2004. If your message
is urgent, please contact Mr. Foo Bar <firstname.lastname@example.org>.
Quux the Magnificent
Be sure that there are no blank lines above the
Because we have many generations of procmail configurations deployed, it is impossible to give comprehensive instructions here. So, we will concentrate on the version that most newer users will have.
The .procmailrc file is no longer a file that a normal user can edit. It is a symbolic link to a file that can only be edited by the administrative users. Instead, users control the procmail filter via three files contained in the .procmail folder of their home directory.
The three files are:
and they contain, respectively: user variables, rules that are applied before spam filtering, and rules that are applied after spam filtering.
To activate the vacation message, open $HOME/.procmail/user-vars with the editor of your choice, seek out the line
and change it to
If .procmailrc is an actual file that you can edit, then you have an older setup and the following rules may apply.
The beginning of .procmailrc will typically look something like the following code segment.
# This file contains procmail filtering recipes. See procmail(1), procmailrc(5)
# for details.
Use an editor to open .procmailrc and edit the VACATION line to read:
If there is no VACATION line, create it.
The value of vacation is case-sensitive. Please use "yes" or "no", not "YES" or "Yes", etc. .
Some Special Considerations
If you are receiving your email via any aliases or re-written addresses (eg. you have requested that your address appear externally as John.Blogs@physics.utoronto.ca instead of email@example.com), then you may need to invoke vacation with an additional argument in .procmailrc.
The standard code
* VACATION ?? yes
needs to replaced with
* VACATION ?? yes
|/usr/bin/vacation -a myalias $LOGNAME
Please contact PCS for assistance if you are in this situation, because it will require additional tailoring that most system users will be unable to handle themselves.