Annotation of src/usr.bin/vacation/vacation.1, Revision 1.17
1.17 ! deraadt 1: .\" $OpenBSD: vacation.1,v 1.16 2007/02/23 15:35:22 jmc Exp $
1.1 deraadt 2: .\" $NetBSD: vacation.1,v 1.5 1995/08/31 21:57:08 jtc Exp $
3: .\"
4: .\" Copyright (c) 1985, 1987, 1990, 1991, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.14 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)vacation.1 8.2 (Berkeley) 4/28/95
32: .\"
33: .Dd April 28, 1995
34: .Dt VACATION 1
1.8 aaron 35: .Os
1.1 deraadt 36: .Sh NAME
37: .Nm vacation
38: .Nd return ``I am not here'' indication
39: .Sh SYNOPSIS
40: .Nm vacation
41: .Fl i
42: .Op Fl r Ar interval
43: .Nm vacation
44: .Op Fl a Ar alias
45: .Ar login
46: .Sh DESCRIPTION
1.13 aaron 47: .Nm
1.1 deraadt 48: returns a message to the sender of a message telling them that you
1.13 aaron 49: are currently not reading your mail.
50: The intended use is in a
1.1 deraadt 51: .Pa .forward
1.13 aaron 52: file.
53: For example, your
1.1 deraadt 54: .Pa .forward
55: file might have:
56: .Bd -literal -offset indent
57: \eeric, "|/usr/bin/vacation -a allman eric"
58: .Ed
1.12 aaron 59: .Pp
1.1 deraadt 60: which would send messages to you (assuming your login name was eric) and
61: reply to any messages for
62: .Dq eric
63: or
64: .Dq allman .
65: .Pp
1.12 aaron 66: The options are as follows:
1.1 deraadt 67: .Bl -tag -width Ds
68: .It Fl a Ar alias
69: Handle messages for
70: .Ar alias
71: in the same manner as those received for the user's
72: login name.
73: .It Fl i
1.13 aaron 74: Initialize the vacation database files.
75: It should be used before you modify your
1.1 deraadt 76: .Pa .forward
77: file.
1.17 ! deraadt 78: .It Fl r Ar interval
1.1 deraadt 79: Set the reply interval to
80: .Ar interval
1.13 aaron 81: days.
82: The default is one week.
83: An interval of
1.1 deraadt 84: .Dq 0
85: means that
86: a reply is sent to each message, and an interval of
87: .Dq Li infinite
88: (actually, any non-numeric character) will never send more than
1.13 aaron 89: one reply.
90: It should be noted that intervals of
1.1 deraadt 91: .Dq Li \&0
92: are quite
93: dangerous, as it allows mailers to get into
94: .Dq I am on vacation
95: loops.
96: .El
97: .Pp
1.16 jmc 98: Messages will not be replied to
99: if any of the following conditions are true:
100: .Bl -dash -offset indent
101: .It
102: Message are not
103: .Dq To:
104: or
105: .Dq Cc:
106: a valid
1.1 deraadt 107: .Ar login
1.16 jmc 108: (or
1.1 deraadt 109: .Ar alias
110: supplied using the
111: .Fl a
1.16 jmc 112: option).
113: .It
114: Messages are from
1.1 deraadt 115: .Dq ???-REQUEST ,
116: .Dq Postmaster ,
117: .Dq Tn UUCP ,
118: .Dq MAILER ,
119: or
120: .Dq MAILER-DAEMON
1.16 jmc 121: (where these strings are case insensitive).
122: .It
123: A
1.11 deraadt 124: .Dq Precedence: bulk ,
125: .Dq Precedence: list ,
1.1 deraadt 126: or
127: .Dq Precedence: junk
128: line is included in the mail headers.
1.16 jmc 129: .It
130: An
131: .Dq Auto-Submitted
132: line is included in the mail headers
133: with a value of anything but
134: .Dq no .
135: .El
136: .Pp
1.1 deraadt 137: The people who have sent you messages are maintained as a
138: .Xr db 3
139: database in the file
140: .Pa .vacation.db
141: in your home directory.
142: .Pp
1.13 aaron 143: .Nm
1.1 deraadt 144: expects a file
145: .Pa .vacation.msg ,
146: in your home directory, containing a message to be sent back to each
1.13 aaron 147: sender.
148: It should be an entire message (including headers).
149: For example, it might contain:
1.15 jmc 150: .Bd -literal -offset indent
1.1 deraadt 151: From: eric@CS.Berkeley.EDU (Eric Allman)
152: Subject: I am on vacation
153: Delivered-By-The-Graces-Of: The Vacation program
154: Precedence: bulk
155:
1.13 aaron 156: I am on vacation until July 22.
157: If you have something urgent,
1.1 deraadt 158: please contact Keith Bostic <bostic@CS.Berkeley.EDU>.
159: --eric
160: .Ed
1.7 marc 161: .Pp
1.9 pjanzen 162: Any occurrence of the string
1.7 marc 163: .Li $SUBJECT
1.10 aaron 164: in
1.7 marc 165: .Pa .vacation.msg
166: will be replaced by the subject of the message that triggered the
1.13 aaron 167: .Nm
1.7 marc 168: program.
1.1 deraadt 169: .Pp
1.13 aaron 170: .Nm
1.5 marc 171: reads the incoming message from standard input, checking the message
172: headers for either the
1.1 deraadt 173: .Ux
174: .Dq From
1.5 marc 175: line or a
176: .Dq Return-Path
1.13 aaron 177: header to determine the sender.
178: If both are present the sender from the
1.5 marc 179: .Dq Return-Path
180: header is used.
1.1 deraadt 181: .Pp
182: Fatal errors, such as calling
1.13 aaron 183: .Nm
1.1 deraadt 184: with incorrect arguments, or with non-existent
185: .Ar login Ns Ar s ,
186: are logged in the system log file, using
1.3 deraadt 187: .Xr syslog 3 .
1.1 deraadt 188: .Sh FILES
189: .Bl -tag -width "vacation.dirxxx" -compact
190: .It Pa ~/.vacation.db
191: database file
192: .It Pa ~/.vacation.msg
193: message to send
194: .El
195: .Sh SEE ALSO
1.6 alex 196: .Xr syslog 3 ,
197: .Xr sendmail 8
1.1 deraadt 198: .Sh HISTORY
199: The
1.13 aaron 200: .Nm
1.1 deraadt 201: command appeared in
202: .Bx 4.3 .