Commit | Line | Data |
---|---|---|
1c15e888 | 1 | .\" Copyright (c) 1985, 1987, 1990 Regents of the University of California. |
b0e4fbd0 | 2 | .\" All rights reserved. |
62cdb418 | 3 | .\" |
1c15e888 C |
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. | |
62cdb418 | 17 | .\" |
1c15e888 | 18 | .\" @(#)vacation.1 6.8 (Berkeley) 6/24/90 |
b0e4fbd0 | 19 | .\" |
1c15e888 | 20 | .TH VACATION 1 "February 7, 1989" |
62cdb418 KM |
21 | .UC 6 |
22 | .SH NAME | |
b0e4fbd0 | 23 | vacation \- return ``I am not here'' indication |
62cdb418 KM |
24 | .SH SYNOPSIS |
25 | .B vacation | |
82df9935 | 26 | .B -i |
72d85c41 KB |
27 | [ |
28 | .B -r | |
29 | interval ] | |
62cdb418 | 30 | .br |
b0e4fbd0 KB |
31 | .B vacation |
32 | [ | |
33 | .B -a | |
34 | alias ] login | |
62cdb418 | 35 | .SH DESCRIPTION |
72d85c41 KB |
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: | |
62cdb418 KM |
43 | .PP |
44 | .ti +5 | |
1c15e888 | 45 | \eeric, "|/usr/bin/vacation -a allman eric" |
62cdb418 | 46 | .PP |
82df9935 | 47 | which would send messages to you (assuming your login name was eric) and |
b0e4fbd0 KB |
48 | reply to any messages for ``eric'' or ``allman''. |
49 | .PP | |
72d85c41 KB |
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. | |
b0e4fbd0 | 75 | .PP |
72d85c41 KB |
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. | |
62cdb418 | 86 | .PP |
72d85c41 KB |
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: | |
62cdb418 KM |
93 | .PP |
94 | .in +5 | |
95 | .nf | |
ed2d2fff EA |
96 | From: eric@ucbmonet.Berkeley.EDU (Eric Allman) |
97 | Subject: I am on vacation | |
b0e4fbd0 KB |
98 | Delivered-By-The-Graces-Of: The Vacation program |
99 | Precedence: bulk | |
ed2d2fff | 100 | |
62cdb418 | 101 | I am on vacation until July 22. If you have something urgent, |
ed2d2fff | 102 | please contact Joe Kalash <kalash@ucbingres.Berkeley.EDU>. |
62cdb418 KM |
103 | --eric |
104 | .fi | |
105 | .in -5 | |
106 | .PP | |
72d85c41 KB |
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. | |
82df9935 | 112 | .PP |
72d85c41 KB |
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). | |
82df9935 KB |
119 | .SH FILES |
120 | .nf | |
b0e4fbd0 | 121 | .ta \w'~/.vacation.msg 'u |
82df9935 | 122 | ~/.vacation.dir database file |
82df9935 KB |
123 | ~/.vacation.msg message to send |
124 | ~/.vacation.pag database file | |
125 | .fi | |
126 | .SH "SEE ALSO" | |
127 | sendmail(8), syslog(8) |