Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
vacation(1)			 User Commands			   vacation(1)

       vacation	- reply	to mail	automatically

       vacation	[-I]

       vacation	 [-a alias]  [-e filter_file] [-f database_file] [-j] [-m mes-
       sage_file] [-s sender] [-tN] username

       The vacation utility automatically replies to incoming mail.

       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

       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

       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

       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.

       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

       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-

       -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-

       -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-

       -s sender	       Replies	to  sender  instead  of	the value read
			       from the	UNIX From line of  the	incoming  mes-

       -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.

       .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).

       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).

       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

       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:

       Note: Blank lines and lines starting with  "#" are ignored.




       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.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWsndmu			   |

       vi(1),	 sendmail(1M),	  dbm(3UCB),   getusershell(3C),   aliases(4),
       shells(4), attributes(5)

SunOS 5.10			  19 Mar 2004			   vacation(1)


Want to link to this manual page? Use this URL:

home | help