|
|
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)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.