1 |
unnilennium |
1.1 |
--- smeserver-vacation-1.0/root/usr/local/man/man1/vacation.1.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
2 |
|
|
+++ smeserver-vacation-1.0/root/usr/local/man/man1/vacation.1 2008-04-28 18:09:36.000000000 -0600 |
3 |
|
|
@@ -1,585 +1,585 @@ |
4 |
|
|
-.\" |
5 |
unnilennium |
1.5 |
-.\" $Id: vacation.1,v 1.3 1999/01/04 04:28:02 psamuel Exp $ |
6 |
unnilennium |
1.1 |
-.\" |
7 |
|
|
-.TH vacation 1 "23 Sep 1998" |
8 |
|
|
-.SH NAME |
9 |
|
|
-vacation \- reply to mail automatically |
10 |
|
|
-.SH SYNOPSIS |
11 |
|
|
-.B vacation |
12 |
|
|
-.br |
13 |
|
|
-.B vacation |
14 |
|
|
-.RI [ -I ] |
15 |
|
|
-.br |
16 |
|
|
-.B vacation |
17 |
|
|
-.RI [ -s ] |
18 |
|
|
-.br |
19 |
|
|
-.B vacation |
20 |
|
|
-.RI [ -j ] |
21 |
|
|
-.RI [ -n ] |
22 |
|
|
-.RI [ -tN ] |
23 |
|
|
-.I username |
24 |
|
|
-.SH DESCRIPTION |
25 |
|
|
-.B vacation |
26 |
|
|
-automatically replies to incoming mail. This version of |
27 |
|
|
-.B vacation |
28 |
|
|
-has been specifically tailored for use with a |
29 |
|
|
-.B qmail |
30 |
|
|
-mail transport agent. It will almost certainly fail if used with a |
31 |
|
|
-different mail transport agent. |
32 |
|
|
-.SH USAGE |
33 |
|
|
-.SS Preparing to go away on vacation |
34 |
|
|
-.LP |
35 |
|
|
-Run |
36 |
|
|
-.B vacation |
37 |
|
|
-without any command line arguments. |
38 |
|
|
-.LP |
39 |
|
|
-The first time you run |
40 |
|
|
-.BR vacation , |
41 |
|
|
-a default reply message will be created in |
42 |
|
|
-.BR ~/.vacation.msg . |
43 |
|
|
-If this file already exists, it will not be overwritten. You'll be |
44 |
|
|
-given the opportunity to see the contents of this file as well as the |
45 |
|
|
-chance to edit it to make your own changes. |
46 |
|
|
-.LP |
47 |
|
|
-Once you are satisfied with the contents of the reply message, |
48 |
|
|
-you will be asked if you would like to enable |
49 |
|
|
-.BR vacation . |
50 |
|
|
-.LP |
51 |
|
|
-If you answer |
52 |
|
|
-.IR yes , |
53 |
|
|
-a default |
54 |
|
|
-.B ~/.qmail |
55 |
|
|
-file will be created. The contents of this file are: |
56 |
|
|
- |
57 |
|
|
-.in 2i |
58 |
|
|
-| /usr/local/bin/vacation \fIusername\fP |
59 |
|
|
-.br |
60 |
|
|
-$home/Maildir/ |
61 |
|
|
-.in |
62 |
|
|
- |
63 |
|
|
-(If you see an environment variable above - such as |
64 |
|
|
-.I $home |
65 |
|
|
-or |
66 |
|
|
-.I $user |
67 |
|
|
-- it will be expanded to its correct value during |
68 |
|
|
-.B vacation's |
69 |
|
|
-setup phase). |
70 |
|
|
-.LP |
71 |
|
|
-These instructions tell the |
72 |
|
|
-.B qmail-local |
73 |
|
|
-mail delivery agent to send an automatic reply to the sender of the |
74 |
|
|
-message and to save a copy of the message in your default mailbox. |
75 |
|
|
-.LP |
76 |
|
|
-Answering |
77 |
|
|
-.I yes |
78 |
|
|
-also instructs |
79 |
|
|
-.B vacation |
80 |
|
|
-to initialise the |
81 |
|
|
-.I dbm |
82 |
|
|
-database file(s). The |
83 |
|
|
-.I dbm |
84 |
|
|
-database file(s) will contain details of who was sent an automatic |
85 |
|
|
-reply and when it was sent. If the |
86 |
|
|
-.I dbm |
87 |
|
|
-database file(s) already exist, the contents will be cleared. |
88 |
|
|
-.LP |
89 |
|
|
-If you answer |
90 |
|
|
-.I no |
91 |
|
|
-when asked if you wish to enable |
92 |
|
|
-.BR vacation , |
93 |
|
|
-neither the |
94 |
|
|
-.B ~/.qmail |
95 |
|
|
-nor the |
96 |
|
|
-.I dbm |
97 |
|
|
-database file(s) will be created. |
98 |
|
|
-.SS Returning from vacation |
99 |
|
|
-Run |
100 |
|
|
-.B vacation |
101 |
|
|
-without any command line arguments. |
102 |
|
|
-.LP |
103 |
|
|
-.B vacation |
104 |
|
|
-displays the contents of your |
105 |
|
|
-.B ~/.qmail |
106 |
|
|
-file and asks if you would like to remove the file, thereby disabling |
107 |
|
|
-.BR vacation . |
108 |
|
|
-.LP |
109 |
|
|
-If you answer |
110 |
|
|
-.IR yes , |
111 |
|
|
-your |
112 |
|
|
-.B ~/.qmail |
113 |
|
|
-file will be removed. |
114 |
|
|
-.B vacation |
115 |
|
|
-will then display the contents of the |
116 |
|
|
-.I dbm |
117 |
|
|
-database, listing the mail addresses of those who were sent an |
118 |
|
|
-automatic reply to their mail while you were away and the date on which |
119 |
|
|
-the automatic reply was sent. The |
120 |
|
|
-.I dbm |
121 |
|
|
-database will then be cleared. |
122 |
|
|
-.LP |
123 |
|
|
-If you answer |
124 |
|
|
-.IR no , |
125 |
|
|
-your |
126 |
|
|
-.B ~/.qmail |
127 |
|
|
-file will not be removed and the contents of the |
128 |
|
|
-.I dbm |
129 |
|
|
-database will remain unchanged. |
130 |
|
|
- |
131 |
|
|
-.SS Processing incoming mail |
132 |
|
|
-When not in setup mode, |
133 |
|
|
-.B vacation |
134 |
|
|
-reads an incoming mail message from standard input and automatically |
135 |
|
|
-sends a reply message to the sender. The reply text is taken from |
136 |
|
|
-.BR ~/.vacation.msg . |
137 |
|
|
-If this file does not exist, a default message will be used. |
138 |
|
|
- |
139 |
|
|
-.B vacation |
140 |
|
|
-will |
141 |
|
|
-.I not |
142 |
|
|
-generate a reply if any of the following conditions are met: |
143 |
|
|
-.TP |
144 |
|
|
-.B - |
145 |
|
|
-The sender address includes the string |
146 |
|
|
-.BR -REQUEST@ . |
147 |
|
|
-.TP |
148 |
|
|
-.B - |
149 |
|
|
-The sender is you. |
150 |
|
|
-.TP |
151 |
|
|
-.B - |
152 |
|
|
-The sender's name is any of: |
153 |
|
|
-.in 2i |
154 |
|
|
-daemon |
155 |
|
|
-.br |
156 |
|
|
-postmaster |
157 |
|
|
-.br |
158 |
|
|
-mailer-daemon |
159 |
|
|
-.br |
160 |
|
|
-mailer |
161 |
|
|
-.br |
162 |
|
|
-root |
163 |
|
|
-.in |
164 |
|
|
-.TP |
165 |
|
|
-.B - |
166 |
|
|
-The sender matches any of the mail addresses listed in the optional |
167 |
|
|
-files |
168 |
|
|
-.B ~/.vacation.aliases |
169 |
|
|
-and |
170 |
|
|
-.BR ~/.vacation.noreply . |
171 |
|
|
-See the |
172 |
|
|
-.B FILES |
173 |
|
|
-section below for more details on these files. |
174 |
|
|
-.TP |
175 |
|
|
-.B - |
176 |
|
|
-There is a |
177 |
|
|
-.B Precedence: bulk |
178 |
|
|
-or |
179 |
|
|
-.B Precedence: junk |
180 |
|
|
-header. |
181 |
|
|
-.TP |
182 |
|
|
-.B - |
183 |
|
|
-There is a |
184 |
|
|
-.B Mailing-List: |
185 |
|
|
-header. |
186 |
|
|
-.TP |
187 |
|
|
-.B - |
188 |
|
|
-Your mail address, or any address you have listed in the optional |
189 |
|
|
-.B ~/.vacation.aliases |
190 |
|
|
-file does |
191 |
|
|
-.I not |
192 |
|
|
-appear in either the |
193 |
|
|
-.B To: |
194 |
|
|
-or |
195 |
|
|
-.B Cc: |
196 |
|
|
-headers. This feature can be disabled using the |
197 |
|
|
-.B -j |
198 |
|
|
-option. See the |
199 |
|
|
-.B OPTIONS |
200 |
|
|
-section below for more details on this option. |
201 |
|
|
-.TP |
202 |
|
|
-.B - |
203 |
|
|
-An automatic reply has already been sent to the same address during |
204 |
|
|
-the last week. The timeout value may be changed using the |
205 |
|
|
-.B -t |
206 |
|
|
-option. See the |
207 |
|
|
-.B OPTIONS |
208 |
|
|
-section below for more details on this option. |
209 |
|
|
-.TP |
210 |
|
|
-.B - |
211 |
|
|
-.B -n |
212 |
|
|
-was specified on the command line and the user does not have a |
213 |
|
|
-.B ~/.vacation.msg |
214 |
|
|
-file. |
215 |
|
|
-.SH OPTIONS |
216 |
|
|
-.TP 10 |
217 |
|
|
-.I none |
218 |
|
|
-If no command line options are provided, |
219 |
|
|
-.B vacation |
220 |
|
|
-will run as an interactive setup program. If you do not have a |
221 |
|
|
-.B ~/.qmail |
222 |
|
|
-file, |
223 |
|
|
-.B vacation |
224 |
|
|
-will assume you wish to enable its services. If you have a |
225 |
|
|
-.B ~/.qmail |
226 |
|
|
-file, |
227 |
|
|
-.B vacation |
228 |
|
|
-will assume you wish to disable its services. |
229 |
|
|
-.TP 10 |
230 |
|
|
-.B -I |
231 |
|
|
-Hands free initialisation. |
232 |
|
|
-.B vacation |
233 |
|
|
-will create your |
234 |
|
|
-.BR ~/.qmail , |
235 |
|
|
-.B ~/.vacation.msg |
236 |
|
|
-and |
237 |
|
|
-.I dbm |
238 |
|
|
-database files. If |
239 |
|
|
-.I any |
240 |
|
|
-of these files already exist, their contents will be replaced by the |
241 |
|
|
-.B vacation |
242 |
|
|
-defaults. |
243 |
|
|
-.B vacation |
244 |
|
|
-will exit after the initialisation process, regardless of any other |
245 |
|
|
-command line options provided. |
246 |
|
|
-.TP 10 |
247 |
|
|
-.B -s |
248 |
|
|
-Show the contents of the |
249 |
|
|
-.I dbm |
250 |
|
|
-database. The contents will not be cleared and your |
251 |
|
|
-.B ~/.qmail |
252 |
|
|
-and |
253 |
|
|
-.B ~/.vacation.msg |
254 |
|
|
-files will remain intact. |
255 |
|
|
-.B vacation |
256 |
|
|
-will exit after displaying the contents of the |
257 |
|
|
-.I dbm |
258 |
|
|
-database, regardless of any other command line options provided. |
259 |
|
|
-.TP 10 |
260 |
|
|
-.B -j |
261 |
|
|
-Do not examine the incoming message |
262 |
|
|
-.B To: |
263 |
|
|
-or |
264 |
|
|
-.B Cc: |
265 |
|
|
-headers to determine if the message was sent directly to you rather |
266 |
|
|
-than an alias. Using this option means that mail sent to an alias of |
267 |
|
|
-which you are a member may generate an automatic reply. This option is |
268 |
|
|
-only useful when specified in the |
269 |
|
|
-.B ~/.qmail |
270 |
|
|
-file. |
271 |
|
|
-.TP 10 |
272 |
|
|
-.B -n |
273 |
|
|
-Do not generate a reply message if the user's |
274 |
|
|
-.B ~/.vacation.msg |
275 |
|
|
-does not exist. Updates to the |
276 |
|
|
-.I dbm |
277 |
|
|
-database will still be performed. This option is for those users who |
278 |
|
|
-wish to quickly disable |
279 |
|
|
-.B vacation |
280 |
|
|
-by removing their |
281 |
|
|
-.B ~/.vacation.msg |
282 |
|
|
-file. It can also be used at sites where users do not have shell |
283 |
|
|
-accounts but can remove their own files via ftp or perhaps a purpose |
284 |
|
|
-built web interface. |
285 |
|
|
-.TP 10 |
286 |
|
|
-.BI -t N |
287 |
|
|
-Change the interval between repeat replies to the same sender. The |
288 |
|
|
-default is 1 week. A trailing |
289 |
|
|
-.BR s , |
290 |
|
|
-.BR m , |
291 |
|
|
-.BR h , |
292 |
|
|
-.BR d , |
293 |
|
|
-or |
294 |
|
|
-.B w |
295 |
|
|
-scales the number |
296 |
|
|
-.I N |
297 |
|
|
-to seconds, minutes, hours, days or weeks respectively. For example, to |
298 |
|
|
-set the interval value to 3 days you would specify |
299 |
|
|
-.B -t3d. |
300 |
|
|
-There should be |
301 |
|
|
-.I no |
302 |
|
|
-spaces between the |
303 |
|
|
-.B -t |
304 |
|
|
-and |
305 |
|
|
-.IR N . |
306 |
|
|
-This option is only useful when specified in the |
307 |
|
|
-.B ~/.qmail |
308 |
|
|
-file. |
309 |
|
|
-.TP 10 |
310 |
|
|
-.I username |
311 |
|
|
-Your login name. When |
312 |
|
|
-.B vacation |
313 |
|
|
-sees this argument it will examine standard input for an incoming mail |
314 |
|
|
-message. The value of this argument is not actually used by this |
315 |
|
|
-implementation of |
316 |
|
|
-.B vacation |
317 |
|
|
-as your login name is provided by a |
318 |
|
|
-.B qmail |
319 |
|
|
-environment variable. However an argument |
320 |
|
|
-.I must |
321 |
|
|
-be supplied so that |
322 |
|
|
-.B vacation |
323 |
|
|
-knows when to process incoming mail and when to provide an interactive |
324 |
|
|
-setup session. Using your login name for this argument simply maintains |
325 |
|
|
-a look and feel similar to the |
326 |
|
|
-.B sendmail |
327 |
|
|
-version of |
328 |
|
|
-.BR vacation . |
329 |
|
|
-.SH ENVIRONMENT |
330 |
|
|
-.LP |
331 |
|
|
-If the environment variable |
332 |
|
|
-.B $VISUAL |
333 |
|
|
-is set and is not null, its value determines the editor used to edit |
334 |
|
|
-the |
335 |
|
|
-.BR ~/.vacation.msg . |
336 |
|
|
-If |
337 |
|
|
-.B $VISUAL |
338 |
|
|
-is not set or its value is null, the environment variable |
339 |
|
|
-.B $EDITOR |
340 |
|
|
-is examined. If it is set and is not null, its value determines the |
341 |
|
|
-editor to be used. If |
342 |
|
|
-.B $EDITOR |
343 |
|
|
-is not set or its value is null, the default editor |
344 |
|
|
-.B vi |
345 |
|
|
-will be used. |
346 |
|
|
-.LP |
347 |
|
|
-If the environment variable |
348 |
|
|
-.B $PAGER |
349 |
|
|
-is set and is not null, its value determines the page viewing program |
350 |
|
|
-to be used to display the |
351 |
|
|
-.B ~/.vacation.msg |
352 |
|
|
-and the contents of the |
353 |
|
|
-.I dbm |
354 |
|
|
-database. If it is not set or its value is null, the default page |
355 |
|
|
-viewer |
356 |
|
|
-.B less |
357 |
|
|
-will be used. |
358 |
|
|
-.SH FILES |
359 |
|
|
-.TP 10 |
360 |
|
|
-.B ~/.vacation.msg |
361 |
|
|
-Contains the text of the automatic reply message. It should |
362 |
|
|
-.I not |
363 |
|
|
-contain any |
364 |
|
|
-.B From: |
365 |
|
|
-or |
366 |
|
|
-.B To: |
367 |
|
|
-headers. If the string |
368 |
|
|
-.B $SUBJECT |
369 |
|
|
-appears in |
370 |
|
|
-.BR ~/.vacation.msg , |
371 |
|
|
-it will be replaced with the subject of the original message. The |
372 |
|
|
-default message is: |
373 |
|
|
- |
374 |
|
|
-.in 2i |
375 |
|
|
-Subject: away from my mail |
376 |
|
|
- |
377 |
|
|
-I will not be reading my mail for a while. Your mail regarding |
378 |
|
|
- |
379 |
|
|
- "$SUBJECT" |
380 |
|
|
- |
381 |
|
|
-will be read when I return. |
382 |
|
|
-.in |
383 |
|
|
-.TP 10 |
384 |
|
|
-.B ~/.qmail |
385 |
|
|
-Contains the delivery instructions for |
386 |
|
|
-the local mail delivery agent, |
387 |
|
|
-.BR qmail-local . |
388 |
|
|
-The default contents of this file are: |
389 |
|
|
- |
390 |
|
|
-.in 2i |
391 |
|
|
-| /usr/local/bin/vacation \fIusername\fP |
392 |
|
|
-.br |
393 |
|
|
-$home/Maildir/ |
394 |
|
|
-.in |
395 |
|
|
- |
396 |
|
|
-(If you see an environment variable above - such as |
397 |
|
|
-.I $home |
398 |
|
|
-or |
399 |
|
|
-.I $user |
400 |
|
|
-- it will be expanded to its correct value during |
401 |
|
|
-.B vacation's |
402 |
|
|
-setup phase). |
403 |
|
|
- |
404 |
|
|
-The first line instructs |
405 |
|
|
-.B qmail-local |
406 |
|
|
-to generate an automatic reply and the second line instructs |
407 |
|
|
-.B qmail-local |
408 |
|
|
-to save the incoming message in your default mailbox. Failure to |
409 |
|
|
-include this line will result in automatic replies being generated but |
410 |
|
|
-.I no |
411 |
|
|
-mail will be saved in your default Mailbox. |
412 |
|
|
-.TP 10 |
413 |
|
|
-.B ~/.vacation.* |
414 |
|
|
-The |
415 |
|
|
-.I dbm |
416 |
|
|
-database file(s) used to store sender mail addresses and time stamps. |
417 |
|
|
-The actual name of this file, or files, depends on the implementation |
418 |
|
|
-of |
419 |
|
|
-.B Perl |
420 |
|
|
-you have at your site. Possibilities include |
421 |
|
|
-.B ~/.vacation.pag |
422 |
|
|
-and |
423 |
|
|
-.B ~/.vacation.dir |
424 |
|
|
-or |
425 |
|
|
-.BR ~/.vacation.db . |
426 |
|
|
-The actual names are unimportant as |
427 |
|
|
-.B Perl |
428 |
|
|
-deals with them internally. |
429 |
|
|
-.TP 10 |
430 |
|
|
-.B ~/.vacation.aliases |
431 |
|
|
-This optional file contains a list of mail addresses, one per line. |
432 |
|
|
-Each address should be a fully qualified alias for yourself. This file |
433 |
|
|
-serves two purposes. |
434 |
|
|
- |
435 |
|
|
-Unless started |
436 |
|
|
-with the |
437 |
|
|
-.B -j |
438 |
|
|
-option, |
439 |
|
|
-.B vacation |
440 |
|
|
-examines the incoming message |
441 |
|
|
-.B To: |
442 |
|
|
-and |
443 |
|
|
-.B Cc: |
444 |
|
|
-headers. If your mail address, or any of the mail addresses specified |
445 |
|
|
-in |
446 |
|
|
-.BR ~/.vacation.aliases , |
447 |
|
|
-match any of the addresses in these headers, an automatic reply will |
448 |
|
|
-be generated for the message. If there is no match, an automatic reply |
449 |
|
|
-will not be generated. This restricts |
450 |
|
|
-.B vacation |
451 |
|
|
-to replying to mail explicitly addressed to you or any of your |
452 |
|
|
-aliases. |
453 |
|
|
- |
454 |
|
|
-The second purpose is to avoid sending an automatic reply to any |
455 |
|
|
-incoming mail from yourself or one of your aliases - you already know |
456 |
|
|
-you're on vacation! |
457 |
|
|
- |
458 |
|
|
-Lines beginning with a |
459 |
|
|
-.I # |
460 |
|
|
-character and blank lines will be ignored. |
461 |
|
|
-.TP 10 |
462 |
|
|
-.B ~/.vacation.noreply |
463 |
|
|
-This file contains a list of mail addresses, one per line. If an |
464 |
|
|
-incoming mail message matches one of the listed addresses, an |
465 |
|
|
-automatic reply will not be generated for that message. The addresses |
466 |
|
|
-need not be fully qualified. If you will be sending yourself mail from |
467 |
|
|
-a remote site, you may wish to include your remote address to avoid |
468 |
|
|
-sending yourself an automatic reply. |
469 |
|
|
- |
470 |
|
|
-Lines beginning with a |
471 |
|
|
-.I # |
472 |
|
|
-character and blank lines will be ignored. |
473 |
|
|
-.SH CAVEATS |
474 |
|
|
-If you already have a |
475 |
|
|
-.B ~/.qmail |
476 |
|
|
-file, which contains delivery instructions other than those specified |
477 |
|
|
-by |
478 |
|
|
-.BR vacation , |
479 |
|
|
-there is a risk that it will be deleted by |
480 |
|
|
-.BR vacation . |
481 |
|
|
-It is good practise to keep a copy of your |
482 |
|
|
-.B ~/.qmail |
483 |
|
|
-file. |
484 |
|
|
- |
485 |
|
|
-If you are hand editing your |
486 |
|
|
-.B ~/.qmail |
487 |
|
|
-file, remember to include a delivery instruction to save the message in |
488 |
|
|
-your default Mailbox, which should be |
489 |
|
|
-.BR $home/Maildir/ . |
490 |
|
|
-You |
491 |
|
|
-.I must |
492 |
|
|
-expand any environment variables - such as |
493 |
|
|
-.I $home |
494 |
|
|
-or |
495 |
|
|
-.I $user |
496 |
|
|
-- as |
497 |
|
|
-.B qmail-local |
498 |
|
|
-will not expand them for you. |
499 |
|
|
- |
500 |
|
|
-If you have a detailed |
501 |
|
|
-.B ~/.vacation.msg |
502 |
|
|
-with text different from the default, there is a risk that it will be |
503 |
|
|
-deleted by |
504 |
|
|
-.BR vacation . |
505 |
|
|
-It is good practise to keep a copy of your |
506 |
|
|
-.B ~/.vacation.msg |
507 |
|
|
-file. |
508 |
|
|
- |
509 |
|
|
-If you are hand editing your |
510 |
|
|
-.B ~/.vacation.msg |
511 |
|
|
-file, the first block of lines up to the first blank line will form |
512 |
|
|
-part of the mail headers. |
513 |
|
|
- |
514 |
|
|
-There is |
515 |
|
|
-.I no |
516 |
|
|
-need to run this version of |
517 |
|
|
-.B vacation |
518 |
|
|
-through |
519 |
|
|
-.BR qmail 's |
520 |
|
|
-.B preline |
521 |
|
|
-program. |
522 |
|
|
-.B preline |
523 |
|
|
-is used to insert a |
524 |
|
|
-.B UUCP |
525 |
|
|
-style |
526 |
|
|
-.B From |
527 |
|
|
-header into the message. This version of |
528 |
|
|
-.B vacation |
529 |
|
|
-does not need that header. In fact, running this version of |
530 |
|
|
-.B vacation |
531 |
|
|
-through |
532 |
|
|
-.B preline |
533 |
|
|
-will cause problems if the incoming message is larger than your system's |
534 |
|
|
-standard I/O buffer size. |
535 |
|
|
-.B preline |
536 |
|
|
-expects to pipe the entire message through a subsequent command. |
537 |
|
|
-However |
538 |
|
|
-.B vacation |
539 |
|
|
-only examines the headers of the message, and then stops reading from |
540 |
|
|
-standard input. This upsets |
541 |
|
|
-.B preline |
542 |
|
|
-if the size of the message is larger than a single I/O buffer. In this |
543 |
|
|
-case |
544 |
|
|
-.B preline |
545 |
|
|
-will terminate with a transient error to |
546 |
|
|
-.B qmail-send |
547 |
|
|
-and you'll see the following message in your mail logs: |
548 |
|
|
- |
549 |
|
|
-.in 1i |
550 |
|
|
-.B deferral: preline:_fatal:_unable_to_copy_input:_broken_pipe/ |
551 |
|
|
-.in |
552 |
|
|
- |
553 |
|
|
-The same problem exists if you use the traditional |
554 |
|
|
-.B sendmail |
555 |
|
|
-version of |
556 |
|
|
-.B vacation |
557 |
|
|
-with |
558 |
|
|
-.BR qmail . |
559 |
|
|
-That version of |
560 |
|
|
-.B vacation |
561 |
|
|
-requires the use of |
562 |
|
|
-.B preline |
563 |
|
|
-to provide it with the |
564 |
|
|
-.B UUCP |
565 |
|
|
-style |
566 |
|
|
-.B From |
567 |
|
|
-header. |
568 |
|
|
-.SH VERSION |
569 |
|
|
-Version 1.3 |
570 |
|
|
-.SH AUTHOR |
571 |
|
|
-Peter Samuel, Uniq Professional Services |
572 |
|
|
-.br |
573 |
|
|
-<Peter.Samuel@uniq.com.au> |
574 |
|
|
-.SH AVAILABILITY |
575 |
|
|
-The latest version of |
576 |
|
|
-.B vacation |
577 |
|
|
-for |
578 |
|
|
-.B qmail |
579 |
|
|
-should always be available from |
580 |
|
|
-.I ftp://ftp.uniq.com.au/pub/tools |
581 |
|
|
-.SH SEE ALSO |
582 |
|
|
-.BR vi (1), |
583 |
|
|
-.BR less (1), |
584 |
|
|
-.BR dot-qmail (5), |
585 |
|
|
-.BR qmail (7), |
586 |
|
|
-.BR qmail-command (8), |
587 |
|
|
-.BR qmail-local (8), |
588 |
|
|
-.BR qmail-send (8). |
589 |
|
|
+.\" |
590 |
unnilennium |
1.5 |
+.\" $Id: vacation.1,v 1.3 1999/01/04 04:28:02 psamuel Exp $ |
591 |
unnilennium |
1.1 |
+.\" |
592 |
|
|
+.TH vacation 1 "23 Sep 1998" |
593 |
|
|
+.SH NAME |
594 |
|
|
+vacation \- reply to mail automatically |
595 |
|
|
+.SH SYNOPSIS |
596 |
|
|
+.B vacation |
597 |
|
|
+.br |
598 |
|
|
+.B vacation |
599 |
|
|
+.RI [ -I ] |
600 |
|
|
+.br |
601 |
|
|
+.B vacation |
602 |
|
|
+.RI [ -s ] |
603 |
|
|
+.br |
604 |
|
|
+.B vacation |
605 |
|
|
+.RI [ -j ] |
606 |
|
|
+.RI [ -n ] |
607 |
|
|
+.RI [ -tN ] |
608 |
|
|
+.I username |
609 |
|
|
+.SH DESCRIPTION |
610 |
|
|
+.B vacation |
611 |
|
|
+automatically replies to incoming mail. This version of |
612 |
|
|
+.B vacation |
613 |
|
|
+has been specifically tailored for use with a |
614 |
|
|
+.B qmail |
615 |
|
|
+mail transport agent. It will almost certainly fail if used with a |
616 |
|
|
+different mail transport agent. |
617 |
|
|
+.SH USAGE |
618 |
|
|
+.SS Preparing to go away on vacation |
619 |
|
|
+.LP |
620 |
|
|
+Run |
621 |
|
|
+.B vacation |
622 |
|
|
+without any command line arguments. |
623 |
|
|
+.LP |
624 |
|
|
+The first time you run |
625 |
|
|
+.BR vacation , |
626 |
|
|
+a default reply message will be created in |
627 |
|
|
+.BR ~/.vacation.msg . |
628 |
|
|
+If this file already exists, it will not be overwritten. You'll be |
629 |
|
|
+given the opportunity to see the contents of this file as well as the |
630 |
|
|
+chance to edit it to make your own changes. |
631 |
|
|
+.LP |
632 |
|
|
+Once you are satisfied with the contents of the reply message, |
633 |
|
|
+you will be asked if you would like to enable |
634 |
|
|
+.BR vacation . |
635 |
|
|
+.LP |
636 |
|
|
+If you answer |
637 |
|
|
+.IR yes , |
638 |
|
|
+a default |
639 |
|
|
+.B ~/.qmail |
640 |
|
|
+file will be created. The contents of this file are: |
641 |
|
|
+ |
642 |
|
|
+.in 2i |
643 |
|
|
+| /usr/local/bin/vacation \fIusername\fP |
644 |
|
|
+.br |
645 |
|
|
+$home/Maildir/ |
646 |
|
|
+.in |
647 |
|
|
+ |
648 |
|
|
+(If you see an environment variable above - such as |
649 |
|
|
+.I $home |
650 |
|
|
+or |
651 |
|
|
+.I $user |
652 |
|
|
+- it will be expanded to its correct value during |
653 |
|
|
+.B vacation's |
654 |
|
|
+setup phase). |
655 |
|
|
+.LP |
656 |
|
|
+These instructions tell the |
657 |
|
|
+.B qmail-local |
658 |
|
|
+mail delivery agent to send an automatic reply to the sender of the |
659 |
|
|
+message and to save a copy of the message in your default mailbox. |
660 |
|
|
+.LP |
661 |
|
|
+Answering |
662 |
|
|
+.I yes |
663 |
|
|
+also instructs |
664 |
|
|
+.B vacation |
665 |
|
|
+to initialise the |
666 |
|
|
+.I dbm |
667 |
|
|
+database file(s). The |
668 |
|
|
+.I dbm |
669 |
|
|
+database file(s) will contain details of who was sent an automatic |
670 |
|
|
+reply and when it was sent. If the |
671 |
|
|
+.I dbm |
672 |
|
|
+database file(s) already exist, the contents will be cleared. |
673 |
|
|
+.LP |
674 |
|
|
+If you answer |
675 |
|
|
+.I no |
676 |
|
|
+when asked if you wish to enable |
677 |
|
|
+.BR vacation , |
678 |
|
|
+neither the |
679 |
|
|
+.B ~/.qmail |
680 |
|
|
+nor the |
681 |
|
|
+.I dbm |
682 |
|
|
+database file(s) will be created. |
683 |
|
|
+.SS Returning from vacation |
684 |
|
|
+Run |
685 |
|
|
+.B vacation |
686 |
|
|
+without any command line arguments. |
687 |
|
|
+.LP |
688 |
|
|
+.B vacation |
689 |
|
|
+displays the contents of your |
690 |
|
|
+.B ~/.qmail |
691 |
|
|
+file and asks if you would like to remove the file, thereby disabling |
692 |
|
|
+.BR vacation . |
693 |
|
|
+.LP |
694 |
|
|
+If you answer |
695 |
|
|
+.IR yes , |
696 |
|
|
+your |
697 |
|
|
+.B ~/.qmail |
698 |
|
|
+file will be removed. |
699 |
|
|
+.B vacation |
700 |
|
|
+will then display the contents of the |
701 |
|
|
+.I dbm |
702 |
|
|
+database, listing the mail addresses of those who were sent an |
703 |
|
|
+automatic reply to their mail while you were away and the date on which |
704 |
|
|
+the automatic reply was sent. The |
705 |
|
|
+.I dbm |
706 |
|
|
+database will then be cleared. |
707 |
|
|
+.LP |
708 |
|
|
+If you answer |
709 |
|
|
+.IR no , |
710 |
|
|
+your |
711 |
|
|
+.B ~/.qmail |
712 |
|
|
+file will not be removed and the contents of the |
713 |
|
|
+.I dbm |
714 |
|
|
+database will remain unchanged. |
715 |
|
|
+ |
716 |
|
|
+.SS Processing incoming mail |
717 |
|
|
+When not in setup mode, |
718 |
|
|
+.B vacation |
719 |
|
|
+reads an incoming mail message from standard input and automatically |
720 |
|
|
+sends a reply message to the sender. The reply text is taken from |
721 |
|
|
+.BR ~/.vacation.msg . |
722 |
|
|
+If this file does not exist, a default message will be used. |
723 |
|
|
+ |
724 |
|
|
+.B vacation |
725 |
|
|
+will |
726 |
|
|
+.I not |
727 |
|
|
+generate a reply if any of the following conditions are met: |
728 |
|
|
+.TP |
729 |
|
|
+.B - |
730 |
|
|
+The sender address includes the string |
731 |
|
|
+.BR -REQUEST@ . |
732 |
|
|
+.TP |
733 |
|
|
+.B - |
734 |
|
|
+The sender is you. |
735 |
|
|
+.TP |
736 |
|
|
+.B - |
737 |
|
|
+The sender's name is any of: |
738 |
|
|
+.in 2i |
739 |
|
|
+daemon |
740 |
|
|
+.br |
741 |
|
|
+postmaster |
742 |
|
|
+.br |
743 |
|
|
+mailer-daemon |
744 |
|
|
+.br |
745 |
|
|
+mailer |
746 |
|
|
+.br |
747 |
|
|
+root |
748 |
|
|
+.in |
749 |
|
|
+.TP |
750 |
|
|
+.B - |
751 |
|
|
+The sender matches any of the mail addresses listed in the optional |
752 |
|
|
+files |
753 |
|
|
+.B ~/.vacation.aliases |
754 |
|
|
+and |
755 |
|
|
+.BR ~/.vacation.noreply . |
756 |
|
|
+See the |
757 |
|
|
+.B FILES |
758 |
|
|
+section below for more details on these files. |
759 |
|
|
+.TP |
760 |
|
|
+.B - |
761 |
|
|
+There is a |
762 |
|
|
+.B Precedence: bulk |
763 |
|
|
+or |
764 |
|
|
+.B Precedence: junk |
765 |
|
|
+header. |
766 |
|
|
+.TP |
767 |
|
|
+.B - |
768 |
|
|
+There is a |
769 |
|
|
+.B Mailing-List: |
770 |
|
|
+header. |
771 |
|
|
+.TP |
772 |
|
|
+.B - |
773 |
|
|
+Your mail address, or any address you have listed in the optional |
774 |
|
|
+.B ~/.vacation.aliases |
775 |
|
|
+file does |
776 |
|
|
+.I not |
777 |
|
|
+appear in either the |
778 |
|
|
+.B To: |
779 |
|
|
+or |
780 |
|
|
+.B Cc: |
781 |
|
|
+headers. This feature can be disabled using the |
782 |
|
|
+.B -j |
783 |
|
|
+option. See the |
784 |
|
|
+.B OPTIONS |
785 |
|
|
+section below for more details on this option. |
786 |
|
|
+.TP |
787 |
|
|
+.B - |
788 |
|
|
+An automatic reply has already been sent to the same address during |
789 |
|
|
+the last week. The timeout value may be changed using the |
790 |
|
|
+.B -t |
791 |
|
|
+option. See the |
792 |
|
|
+.B OPTIONS |
793 |
|
|
+section below for more details on this option. |
794 |
|
|
+.TP |
795 |
|
|
+.B - |
796 |
|
|
+.B -n |
797 |
|
|
+was specified on the command line and the user does not have a |
798 |
|
|
+.B ~/.vacation.msg |
799 |
|
|
+file. |
800 |
|
|
+.SH OPTIONS |
801 |
|
|
+.TP 10 |
802 |
|
|
+.I none |
803 |
|
|
+If no command line options are provided, |
804 |
|
|
+.B vacation |
805 |
|
|
+will run as an interactive setup program. If you do not have a |
806 |
|
|
+.B ~/.qmail |
807 |
|
|
+file, |
808 |
|
|
+.B vacation |
809 |
|
|
+will assume you wish to enable its services. If you have a |
810 |
|
|
+.B ~/.qmail |
811 |
|
|
+file, |
812 |
|
|
+.B vacation |
813 |
|
|
+will assume you wish to disable its services. |
814 |
|
|
+.TP 10 |
815 |
|
|
+.B -I |
816 |
|
|
+Hands free initialisation. |
817 |
|
|
+.B vacation |
818 |
|
|
+will create your |
819 |
|
|
+.BR ~/.qmail , |
820 |
|
|
+.B ~/.vacation.msg |
821 |
|
|
+and |
822 |
|
|
+.I dbm |
823 |
|
|
+database files. If |
824 |
|
|
+.I any |
825 |
|
|
+of these files already exist, their contents will be replaced by the |
826 |
|
|
+.B vacation |
827 |
|
|
+defaults. |
828 |
|
|
+.B vacation |
829 |
|
|
+will exit after the initialisation process, regardless of any other |
830 |
|
|
+command line options provided. |
831 |
|
|
+.TP 10 |
832 |
|
|
+.B -s |
833 |
|
|
+Show the contents of the |
834 |
|
|
+.I dbm |
835 |
|
|
+database. The contents will not be cleared and your |
836 |
|
|
+.B ~/.qmail |
837 |
|
|
+and |
838 |
|
|
+.B ~/.vacation.msg |
839 |
|
|
+files will remain intact. |
840 |
|
|
+.B vacation |
841 |
|
|
+will exit after displaying the contents of the |
842 |
|
|
+.I dbm |
843 |
|
|
+database, regardless of any other command line options provided. |
844 |
|
|
+.TP 10 |
845 |
|
|
+.B -j |
846 |
|
|
+Do not examine the incoming message |
847 |
|
|
+.B To: |
848 |
|
|
+or |
849 |
|
|
+.B Cc: |
850 |
|
|
+headers to determine if the message was sent directly to you rather |
851 |
|
|
+than an alias. Using this option means that mail sent to an alias of |
852 |
|
|
+which you are a member may generate an automatic reply. This option is |
853 |
|
|
+only useful when specified in the |
854 |
|
|
+.B ~/.qmail |
855 |
|
|
+file. |
856 |
|
|
+.TP 10 |
857 |
|
|
+.B -n |
858 |
|
|
+Do not generate a reply message if the user's |
859 |
|
|
+.B ~/.vacation.msg |
860 |
|
|
+does not exist. Updates to the |
861 |
|
|
+.I dbm |
862 |
|
|
+database will still be performed. This option is for those users who |
863 |
|
|
+wish to quickly disable |
864 |
|
|
+.B vacation |
865 |
|
|
+by removing their |
866 |
|
|
+.B ~/.vacation.msg |
867 |
|
|
+file. It can also be used at sites where users do not have shell |
868 |
|
|
+accounts but can remove their own files via ftp or perhaps a purpose |
869 |
|
|
+built web interface. |
870 |
|
|
+.TP 10 |
871 |
|
|
+.BI -t N |
872 |
|
|
+Change the interval between repeat replies to the same sender. The |
873 |
|
|
+default is 1 week. A trailing |
874 |
|
|
+.BR s , |
875 |
|
|
+.BR m , |
876 |
|
|
+.BR h , |
877 |
|
|
+.BR d , |
878 |
|
|
+or |
879 |
|
|
+.B w |
880 |
|
|
+scales the number |
881 |
|
|
+.I N |
882 |
|
|
+to seconds, minutes, hours, days or weeks respectively. For example, to |
883 |
|
|
+set the interval value to 3 days you would specify |
884 |
|
|
+.B -t3d. |
885 |
|
|
+There should be |
886 |
|
|
+.I no |
887 |
|
|
+spaces between the |
888 |
|
|
+.B -t |
889 |
|
|
+and |
890 |
|
|
+.IR N . |
891 |
|
|
+This option is only useful when specified in the |
892 |
|
|
+.B ~/.qmail |
893 |
|
|
+file. |
894 |
|
|
+.TP 10 |
895 |
|
|
+.I username |
896 |
|
|
+Your login name. When |
897 |
|
|
+.B vacation |
898 |
|
|
+sees this argument it will examine standard input for an incoming mail |
899 |
|
|
+message. The value of this argument is not actually used by this |
900 |
|
|
+implementation of |
901 |
|
|
+.B vacation |
902 |
|
|
+as your login name is provided by a |
903 |
|
|
+.B qmail |
904 |
|
|
+environment variable. However an argument |
905 |
|
|
+.I must |
906 |
|
|
+be supplied so that |
907 |
|
|
+.B vacation |
908 |
|
|
+knows when to process incoming mail and when to provide an interactive |
909 |
|
|
+setup session. Using your login name for this argument simply maintains |
910 |
|
|
+a look and feel similar to the |
911 |
|
|
+.B sendmail |
912 |
|
|
+version of |
913 |
|
|
+.BR vacation . |
914 |
|
|
+.SH ENVIRONMENT |
915 |
|
|
+.LP |
916 |
|
|
+If the environment variable |
917 |
|
|
+.B $VISUAL |
918 |
|
|
+is set and is not null, its value determines the editor used to edit |
919 |
|
|
+the |
920 |
|
|
+.BR ~/.vacation.msg . |
921 |
|
|
+If |
922 |
|
|
+.B $VISUAL |
923 |
|
|
+is not set or its value is null, the environment variable |
924 |
|
|
+.B $EDITOR |
925 |
|
|
+is examined. If it is set and is not null, its value determines the |
926 |
|
|
+editor to be used. If |
927 |
|
|
+.B $EDITOR |
928 |
|
|
+is not set or its value is null, the default editor |
929 |
|
|
+.B vi |
930 |
|
|
+will be used. |
931 |
|
|
+.LP |
932 |
|
|
+If the environment variable |
933 |
|
|
+.B $PAGER |
934 |
|
|
+is set and is not null, its value determines the page viewing program |
935 |
|
|
+to be used to display the |
936 |
|
|
+.B ~/.vacation.msg |
937 |
|
|
+and the contents of the |
938 |
|
|
+.I dbm |
939 |
|
|
+database. If it is not set or its value is null, the default page |
940 |
|
|
+viewer |
941 |
|
|
+.B less |
942 |
|
|
+will be used. |
943 |
|
|
+.SH FILES |
944 |
|
|
+.TP 10 |
945 |
|
|
+.B ~/.vacation.msg |
946 |
|
|
+Contains the text of the automatic reply message. It should |
947 |
|
|
+.I not |
948 |
|
|
+contain any |
949 |
|
|
+.B From: |
950 |
|
|
+or |
951 |
|
|
+.B To: |
952 |
|
|
+headers. If the string |
953 |
|
|
+.B $SUBJECT |
954 |
|
|
+appears in |
955 |
|
|
+.BR ~/.vacation.msg , |
956 |
|
|
+it will be replaced with the subject of the original message. The |
957 |
|
|
+default message is: |
958 |
|
|
+ |
959 |
|
|
+.in 2i |
960 |
|
|
+Subject: away from my mail |
961 |
|
|
+ |
962 |
|
|
+I will not be reading my mail for a while. Your mail regarding |
963 |
|
|
+ |
964 |
|
|
+ "$SUBJECT" |
965 |
|
|
+ |
966 |
|
|
+will be read when I return. |
967 |
|
|
+.in |
968 |
|
|
+.TP 10 |
969 |
|
|
+.B ~/.qmail |
970 |
|
|
+Contains the delivery instructions for |
971 |
|
|
+the local mail delivery agent, |
972 |
|
|
+.BR qmail-local . |
973 |
|
|
+The default contents of this file are: |
974 |
|
|
+ |
975 |
|
|
+.in 2i |
976 |
|
|
+| /usr/local/bin/vacation \fIusername\fP |
977 |
|
|
+.br |
978 |
|
|
+$home/Maildir/ |
979 |
|
|
+.in |
980 |
|
|
+ |
981 |
|
|
+(If you see an environment variable above - such as |
982 |
|
|
+.I $home |
983 |
|
|
+or |
984 |
|
|
+.I $user |
985 |
|
|
+- it will be expanded to its correct value during |
986 |
|
|
+.B vacation's |
987 |
|
|
+setup phase). |
988 |
|
|
+ |
989 |
|
|
+The first line instructs |
990 |
|
|
+.B qmail-local |
991 |
|
|
+to generate an automatic reply and the second line instructs |
992 |
|
|
+.B qmail-local |
993 |
|
|
+to save the incoming message in your default mailbox. Failure to |
994 |
|
|
+include this line will result in automatic replies being generated but |
995 |
|
|
+.I no |
996 |
|
|
+mail will be saved in your default Mailbox. |
997 |
|
|
+.TP 10 |
998 |
|
|
+.B ~/.vacation.* |
999 |
|
|
+The |
1000 |
|
|
+.I dbm |
1001 |
|
|
+database file(s) used to store sender mail addresses and time stamps. |
1002 |
|
|
+The actual name of this file, or files, depends on the implementation |
1003 |
|
|
+of |
1004 |
|
|
+.B Perl |
1005 |
|
|
+you have at your site. Possibilities include |
1006 |
|
|
+.B ~/.vacation.pag |
1007 |
|
|
+and |
1008 |
|
|
+.B ~/.vacation.dir |
1009 |
|
|
+or |
1010 |
|
|
+.BR ~/.vacation.db . |
1011 |
|
|
+The actual names are unimportant as |
1012 |
|
|
+.B Perl |
1013 |
|
|
+deals with them internally. |
1014 |
|
|
+.TP 10 |
1015 |
|
|
+.B ~/.vacation.aliases |
1016 |
|
|
+This optional file contains a list of mail addresses, one per line. |
1017 |
|
|
+Each address should be a fully qualified alias for yourself. This file |
1018 |
|
|
+serves two purposes. |
1019 |
|
|
+ |
1020 |
|
|
+Unless started |
1021 |
|
|
+with the |
1022 |
|
|
+.B -j |
1023 |
|
|
+option, |
1024 |
|
|
+.B vacation |
1025 |
|
|
+examines the incoming message |
1026 |
|
|
+.B To: |
1027 |
|
|
+and |
1028 |
|
|
+.B Cc: |
1029 |
|
|
+headers. If your mail address, or any of the mail addresses specified |
1030 |
|
|
+in |
1031 |
|
|
+.BR ~/.vacation.aliases , |
1032 |
|
|
+match any of the addresses in these headers, an automatic reply will |
1033 |
|
|
+be generated for the message. If there is no match, an automatic reply |
1034 |
|
|
+will not be generated. This restricts |
1035 |
|
|
+.B vacation |
1036 |
|
|
+to replying to mail explicitly addressed to you or any of your |
1037 |
|
|
+aliases. |
1038 |
|
|
+ |
1039 |
|
|
+The second purpose is to avoid sending an automatic reply to any |
1040 |
|
|
+incoming mail from yourself or one of your aliases - you already know |
1041 |
|
|
+you're on vacation! |
1042 |
|
|
+ |
1043 |
|
|
+Lines beginning with a |
1044 |
|
|
+.I # |
1045 |
|
|
+character and blank lines will be ignored. |
1046 |
|
|
+.TP 10 |
1047 |
|
|
+.B ~/.vacation.noreply |
1048 |
|
|
+This file contains a list of mail addresses, one per line. If an |
1049 |
|
|
+incoming mail message matches one of the listed addresses, an |
1050 |
|
|
+automatic reply will not be generated for that message. The addresses |
1051 |
|
|
+need not be fully qualified. If you will be sending yourself mail from |
1052 |
|
|
+a remote site, you may wish to include your remote address to avoid |
1053 |
|
|
+sending yourself an automatic reply. |
1054 |
|
|
+ |
1055 |
|
|
+Lines beginning with a |
1056 |
|
|
+.I # |
1057 |
|
|
+character and blank lines will be ignored. |
1058 |
|
|
+.SH CAVEATS |
1059 |
|
|
+If you already have a |
1060 |
|
|
+.B ~/.qmail |
1061 |
|
|
+file, which contains delivery instructions other than those specified |
1062 |
|
|
+by |
1063 |
|
|
+.BR vacation , |
1064 |
|
|
+there is a risk that it will be deleted by |
1065 |
|
|
+.BR vacation . |
1066 |
|
|
+It is good practise to keep a copy of your |
1067 |
|
|
+.B ~/.qmail |
1068 |
|
|
+file. |
1069 |
|
|
+ |
1070 |
|
|
+If you are hand editing your |
1071 |
|
|
+.B ~/.qmail |
1072 |
|
|
+file, remember to include a delivery instruction to save the message in |
1073 |
|
|
+your default Mailbox, which should be |
1074 |
|
|
+.BR $home/Maildir/ . |
1075 |
|
|
+You |
1076 |
|
|
+.I must |
1077 |
|
|
+expand any environment variables - such as |
1078 |
|
|
+.I $home |
1079 |
|
|
+or |
1080 |
|
|
+.I $user |
1081 |
|
|
+- as |
1082 |
|
|
+.B qmail-local |
1083 |
|
|
+will not expand them for you. |
1084 |
|
|
+ |
1085 |
|
|
+If you have a detailed |
1086 |
|
|
+.B ~/.vacation.msg |
1087 |
|
|
+with text different from the default, there is a risk that it will be |
1088 |
|
|
+deleted by |
1089 |
|
|
+.BR vacation . |
1090 |
|
|
+It is good practise to keep a copy of your |
1091 |
|
|
+.B ~/.vacation.msg |
1092 |
|
|
+file. |
1093 |
|
|
+ |
1094 |
|
|
+If you are hand editing your |
1095 |
|
|
+.B ~/.vacation.msg |
1096 |
|
|
+file, the first block of lines up to the first blank line will form |
1097 |
|
|
+part of the mail headers. |
1098 |
|
|
+ |
1099 |
|
|
+There is |
1100 |
|
|
+.I no |
1101 |
|
|
+need to run this version of |
1102 |
|
|
+.B vacation |
1103 |
|
|
+through |
1104 |
|
|
+.BR qmail 's |
1105 |
|
|
+.B preline |
1106 |
|
|
+program. |
1107 |
|
|
+.B preline |
1108 |
|
|
+is used to insert a |
1109 |
|
|
+.B UUCP |
1110 |
|
|
+style |
1111 |
|
|
+.B From |
1112 |
|
|
+header into the message. This version of |
1113 |
|
|
+.B vacation |
1114 |
|
|
+does not need that header. In fact, running this version of |
1115 |
|
|
+.B vacation |
1116 |
|
|
+through |
1117 |
|
|
+.B preline |
1118 |
|
|
+will cause problems if the incoming message is larger than your system's |
1119 |
|
|
+standard I/O buffer size. |
1120 |
|
|
+.B preline |
1121 |
|
|
+expects to pipe the entire message through a subsequent command. |
1122 |
|
|
+However |
1123 |
|
|
+.B vacation |
1124 |
|
|
+only examines the headers of the message, and then stops reading from |
1125 |
|
|
+standard input. This upsets |
1126 |
|
|
+.B preline |
1127 |
|
|
+if the size of the message is larger than a single I/O buffer. In this |
1128 |
|
|
+case |
1129 |
|
|
+.B preline |
1130 |
|
|
+will terminate with a transient error to |
1131 |
|
|
+.B qmail-send |
1132 |
|
|
+and you'll see the following message in your mail logs: |
1133 |
|
|
+ |
1134 |
|
|
+.in 1i |
1135 |
|
|
+.B deferral: preline:_fatal:_unable_to_copy_input:_broken_pipe/ |
1136 |
|
|
+.in |
1137 |
|
|
+ |
1138 |
|
|
+The same problem exists if you use the traditional |
1139 |
|
|
+.B sendmail |
1140 |
|
|
+version of |
1141 |
|
|
+.B vacation |
1142 |
|
|
+with |
1143 |
|
|
+.BR qmail . |
1144 |
|
|
+That version of |
1145 |
|
|
+.B vacation |
1146 |
|
|
+requires the use of |
1147 |
|
|
+.B preline |
1148 |
|
|
+to provide it with the |
1149 |
|
|
+.B UUCP |
1150 |
|
|
+style |
1151 |
|
|
+.B From |
1152 |
|
|
+header. |
1153 |
|
|
+.SH VERSION |
1154 |
|
|
+Version 1.3 |
1155 |
|
|
+.SH AUTHOR |
1156 |
|
|
+Peter Samuel, Uniq Professional Services |
1157 |
|
|
+.br |
1158 |
|
|
+<Peter.Samuel@uniq.com.au> |
1159 |
|
|
+.SH AVAILABILITY |
1160 |
|
|
+The latest version of |
1161 |
|
|
+.B vacation |
1162 |
|
|
+for |
1163 |
|
|
+.B qmail |
1164 |
|
|
+should always be available from |
1165 |
|
|
+.I ftp://ftp.uniq.com.au/pub/tools |
1166 |
|
|
+.SH SEE ALSO |
1167 |
|
|
+.BR vi (1), |
1168 |
|
|
+.BR less (1), |
1169 |
|
|
+.BR dot-qmail (5), |
1170 |
|
|
+.BR qmail (7), |
1171 |
|
|
+.BR qmail-command (8), |
1172 |
|
|
+.BR qmail-local (8), |
1173 |
|
|
+.BR qmail-send (8). |
1174 |
|
|
--- smeserver-vacation-1.0/root/usr/lib/perl5/site_perl/esmith/FormMagick/Panel/uservacations.pm.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
1175 |
|
|
+++ smeserver-vacation-1.0/root/usr/lib/perl5/site_perl/esmith/FormMagick/Panel/uservacations.pm 2008-04-28 18:09:36.000000000 -0600 |
1176 |
|
|
@@ -38,8 +38,8 @@ |
1177 |
|
|
|
1178 |
|
|
|
1179 |
|
|
#server-manager functions |
1180 |
|
|
-sub user_accounts_exist |
1181 |
|
|
-{ |
1182 |
|
|
+sub user_accounts_exist |
1183 |
|
|
+{ |
1184 |
|
|
my $self = shift; |
1185 |
|
|
my $q = $self->{cgi}; |
1186 |
|
|
#return scalar $adb->users; |
1187 |
|
|
@@ -52,8 +52,8 @@ |
1188 |
|
|
my $self = shift; |
1189 |
|
|
my $q = $self->{cgi}; |
1190 |
|
|
|
1191 |
|
|
- my @users = $adb->users; |
1192 |
|
|
- return $self->localise("ACCOUNT_USER_NONE") if (@users == 0); |
1193 |
|
|
+ my @users = $adb->users; |
1194 |
|
|
+ return $self->localise("ACCOUNT_USER_NONE") if (@users == 0); |
1195 |
|
|
|
1196 |
|
|
my $vacation_table = |
1197 |
|
|
{ |
1198 |
|
|
@@ -80,7 +80,7 @@ |
1199 |
|
|
}; |
1200 |
|
|
|
1201 |
|
|
my @data = (); |
1202 |
|
|
- |
1203 |
|
|
+ |
1204 |
|
|
for my $user (@users) |
1205 |
|
|
{ |
1206 |
|
|
# make it clearer which uses have vacation |
1207 |
|
|
--- smeserver-vacation-1.0/root/etc/e-smith/web/functions/uservacations.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
1208 |
|
|
+++ smeserver-vacation-1.0/root/etc/e-smith/web/functions/uservacations 2008-04-28 18:09:36.000000000 -0600 |
1209 |
|
|
@@ -1,9 +1,9 @@ |
1210 |
|
|
#!/usr/bin/perl -wT |
1211 |
|
|
|
1212 |
|
|
#---------------------------------------------------------------------- |
1213 |
|
|
-# heading : Collaboration |
1214 |
|
|
-# description : User vacations |
1215 |
|
|
-# navigation : 3000 3150 |
1216 |
|
|
+# heading : Collaboration |
1217 |
|
|
+# description : User vacations |
1218 |
|
|
+# navigation : 3000 3150 |
1219 |
|
|
# |
1220 |
|
|
# Copyright (c) 2001 Daniel van Raay <danielvr@caa.org.au> |
1221 |
|
|
# Modified (c) 2002,2006 Stephen Noble <stephen@dungog.net> |
1222 |
|
|
@@ -32,40 +32,40 @@ |
1223 |
|
|
name="First" |
1224 |
|
|
pre-event="print_status_message()"> |
1225 |
|
|
|
1226 |
|
|
- <!-- <field type="literal" display="user_accounts_exist()" > |
1227 |
|
|
- <label>DESCRIPTION</label> |
1228 |
|
|
- </field> --> |
1229 |
|
|
+ <!-- <field type="literal" display="user_accounts_exist()" > |
1230 |
|
|
+ <label>DESCRIPTION</label> |
1231 |
|
|
+ </field> --> |
1232 |
|
|
|
1233 |
|
|
<subroutine src="user_accounts_exist()" /> |
1234 |
|
|
<subroutine src="print_vacation_table" /> |
1235 |
|
|
</page> |
1236 |
|
|
|
1237 |
|
|
<page |
1238 |
|
|
- name="VACATION_PAGE_MODIFY" |
1239 |
|
|
- pre-event="turn_off_buttons()" |
1240 |
|
|
- post-event="change_settings()" > |
1241 |
|
|
- |
1242 |
|
|
- <description>MODIFY_DESCRIPTION</description> |
1243 |
|
|
- |
1244 |
|
|
- <field type="literal" id="User" > |
1245 |
|
|
- <label>ACCOUNT</label> |
1246 |
|
|
- </field> |
1247 |
|
|
+ name="VACATION_PAGE_MODIFY" |
1248 |
|
|
+ pre-event="turn_off_buttons()" |
1249 |
|
|
+ post-event="change_settings()" > |
1250 |
|
|
|
1251 |
|
|
- <field type="literal" id="FullName"> |
1252 |
|
|
- <label>USER_NAME</label> |
1253 |
|
|
+ <description>MODIFY_DESCRIPTION</description> |
1254 |
|
|
+ |
1255 |
|
|
+ <field type="literal" id="User" > |
1256 |
|
|
+ <label>ACCOUNT</label> |
1257 |
|
|
+ </field> |
1258 |
|
|
+ |
1259 |
|
|
+ <field type="literal" id="FullName"> |
1260 |
|
|
+ <label>USER_NAME</label> |
1261 |
|
|
</field> |
1262 |
|
|
|
1263 |
|
|
<subroutine src="get_vacation_text()" /> |
1264 |
|
|
|
1265 |
|
|
- <field |
1266 |
|
|
- type="select" |
1267 |
|
|
- id="EmailVacation" |
1268 |
|
|
- options="'no' => 'NO', 'yes' => 'YES'" |
1269 |
|
|
- value="EmailVacation"> |
1270 |
|
|
- <label>VACATION_STATUS</label> |
1271 |
|
|
- </field> |
1272 |
|
|
+ <field |
1273 |
|
|
+ type="select" |
1274 |
|
|
+ id="EmailVacation" |
1275 |
|
|
+ options="'no' => 'NO', 'yes' => 'YES'" |
1276 |
|
|
+ value="EmailVacation"> |
1277 |
|
|
+ <label>VACATION_STATUS</label> |
1278 |
|
|
+ </field> |
1279 |
|
|
|
1280 |
|
|
- <subroutine src="print_button('SAVE')" /> |
1281 |
|
|
+ <subroutine src="print_button('SAVE')" /> |
1282 |
|
|
</page> |
1283 |
|
|
|
1284 |
|
|
</form> |
1285 |
|
|
--- smeserver-vacation-1.0/root/etc/e-smith/web/functions/userpanel-vacation.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
1286 |
|
|
+++ smeserver-vacation-1.0/root/etc/e-smith/web/functions/userpanel-vacation 2008-04-28 18:09:36.000000000 -0600 |
1287 |
|
|
@@ -34,31 +34,31 @@ |
1288 |
|
|
footer="/etc/e-smith/web/common/foot.tmpl"> |
1289 |
|
|
|
1290 |
|
|
<page |
1291 |
|
|
- name="First" |
1292 |
|
|
- pre-event="print_status_message()" |
1293 |
|
|
- post-event="userpanel_change_settings()" > |
1294 |
|
|
+ name="First" |
1295 |
|
|
+ pre-event="print_status_message()" |
1296 |
|
|
+ post-event="userpanel_change_settings()" > |
1297 |
|
|
|
1298 |
|
|
- <description>MODIFY_DESCRIPTION</description> |
1299 |
|
|
+ <description>MODIFY_DESCRIPTION</description> |
1300 |
|
|
|
1301 |
|
|
- <field type="literal" id="User" value="get_panel_user()"> |
1302 |
|
|
- <label>ACCOUNT</label> |
1303 |
|
|
- </field> |
1304 |
|
|
+ <field type="literal" id="User" value="get_panel_user()"> |
1305 |
|
|
+ <label>ACCOUNT</label> |
1306 |
|
|
+ </field> |
1307 |
|
|
|
1308 |
|
|
- <field type="literal" id="FullName" value="get_full_name()"> |
1309 |
|
|
- <label>USER_NAME</label> |
1310 |
|
|
+ <field type="literal" id="FullName" value="get_full_name()"> |
1311 |
|
|
+ <label>USER_NAME</label> |
1312 |
|
|
</field> |
1313 |
|
|
|
1314 |
|
|
<subroutine src="userpanel_get_vacation_text()" /> |
1315 |
|
|
|
1316 |
|
|
- <field |
1317 |
|
|
- type="select" |
1318 |
|
|
- id="EmailVacation" |
1319 |
|
|
- options="'no' => 'NO', 'yes' => 'YES'" |
1320 |
|
|
- value="get_vacation_status()"> |
1321 |
|
|
- <label>VACATION_STATUS</label> |
1322 |
|
|
- </field> |
1323 |
|
|
+ <field |
1324 |
|
|
+ type="select" |
1325 |
|
|
+ id="EmailVacation" |
1326 |
|
|
+ options="'no' => 'NO', 'yes' => 'YES'" |
1327 |
|
|
+ value="get_vacation_status()"> |
1328 |
|
|
+ <label>VACATION_STATUS</label> |
1329 |
|
|
+ </field> |
1330 |
|
|
|
1331 |
|
|
- <subroutine src="print_button('SAVE')" /> |
1332 |
|
|
+ <subroutine src="print_button('SAVE')" /> |
1333 |
|
|
</page> |
1334 |
|
|
|
1335 |
|
|
</form> |
1336 |
|
|
--- smeserver-vacation-1.0/root/etc/e-smith/templates-user/.qmail/16vacationMessage.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
1337 |
|
|
+++ smeserver-vacation-1.0/root/etc/e-smith/templates-user/.qmail/16vacationMessage 2008-04-28 18:09:36.000000000 -0600 |
1338 |
|
|
@@ -13,10 +13,10 @@ |
1339 |
|
|
# config delprop qmail VacationDelay |
1340 |
|
|
# apply to all users /etc/e-smith/events/actions/qmail-update-user |
1341 |
|
|
# |
1342 |
|
|
- # -tN Change the interval between repeat replies to the same |
1343 |
|
|
- # sender. The default is 1 week. A trailing s, m, h, d, or w |
1344 |
|
|
- # scales the number N to seconds, minutes, hours, days or |
1345 |
|
|
- # weeks respectively. For example, to set the interval value |
1346 |
|
|
- # to 3 days you would specify -t3d. There should be no spaces |
1347 |
|
|
- # between the -t and N. |
1348 |
|
|
+ # -tN Change the interval between repeat replies to the same |
1349 |
|
|
+ # sender. The default is 1 week. A trailing s, m, h, d, or w |
1350 |
|
|
+ # scales the number N to seconds, minutes, hours, days or |
1351 |
|
|
+ # weeks respectively. For example, to set the interval value |
1352 |
|
|
+ # to 3 days you would specify -t3d. There should be no spaces |
1353 |
|
|
+ # between the -t and N. |
1354 |
|
|
} |
1355 |
|
|
--- smeserver-vacation-1.0/COPYING.dos2unix 2008-04-28 18:09:06.000000000 -0600 |
1356 |
|
|
+++ smeserver-vacation-1.0/COPYING 2008-04-28 18:09:36.000000000 -0600 |
1357 |
|
|
@@ -1,340 +1,340 @@ |
1358 |
|
|
- GNU GENERAL PUBLIC LICENSE |
1359 |
|
|
- Version 2, June 1991 |
1360 |
|
|
- |
1361 |
|
|
- Copyright (C) 1989, 1991 Free Software Foundation, Inc. |
1362 |
|
|
- 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
1363 |
|
|
- Everyone is permitted to copy and distribute verbatim copies |
1364 |
|
|
- of this license document, but changing it is not allowed. |
1365 |
|
|
- |
1366 |
|
|
- Preamble |
1367 |
|
|
- |
1368 |
|
|
- The licenses for most software are designed to take away your |
1369 |
|
|
-freedom to share and change it. By contrast, the GNU General Public |
1370 |
|
|
-License is intended to guarantee your freedom to share and change free |
1371 |
|
|
-software--to make sure the software is free for all its users. This |
1372 |
|
|
-General Public License applies to most of the Free Software |
1373 |
|
|
-Foundation's software and to any other program whose authors commit to |
1374 |
|
|
-using it. (Some other Free Software Foundation software is covered by |
1375 |
|
|
-the GNU Library General Public License instead.) You can apply it to |
1376 |
|
|
-your programs, too. |
1377 |
|
|
- |
1378 |
|
|
- When we speak of free software, we are referring to freedom, not |
1379 |
|
|
-price. Our General Public Licenses are designed to make sure that you |
1380 |
|
|
-have the freedom to distribute copies of free software (and charge for |
1381 |
|
|
-this service if you wish), that you receive source code or can get it |
1382 |
|
|
-if you want it, that you can change the software or use pieces of it |
1383 |
|
|
-in new free programs; and that you know you can do these things. |
1384 |
|
|
- |
1385 |
|
|
- To protect your rights, we need to make restrictions that forbid |
1386 |
|
|
-anyone to deny you these rights or to ask you to surrender the rights. |
1387 |
|
|
-These restrictions translate to certain responsibilities for you if you |
1388 |
|
|
-distribute copies of the software, or if you modify it. |
1389 |
|
|
- |
1390 |
|
|
- For example, if you distribute copies of such a program, whether |
1391 |
|
|
-gratis or for a fee, you must give the recipients all the rights that |
1392 |
|
|
-you have. You must make sure that they, too, receive or can get the |
1393 |
|
|
-source code. And you must show them these terms so they know their |
1394 |
|
|
-rights. |
1395 |
|
|
- |
1396 |
|
|
- We protect your rights with two steps: (1) copyright the software, and |
1397 |
|
|
-(2) offer you this license which gives you legal permission to copy, |
1398 |
|
|
-distribute and/or modify the software. |
1399 |
|
|
- |
1400 |
|
|
- Also, for each author's protection and ours, we want to make certain |
1401 |
|
|
-that everyone understands that there is no warranty for this free |
1402 |
|
|
-software. If the software is modified by someone else and passed on, we |
1403 |
|
|
-want its recipients to know that what they have is not the original, so |
1404 |
|
|
-that any problems introduced by others will not reflect on the original |
1405 |
|
|
-authors' reputations. |
1406 |
|
|
- |
1407 |
|
|
- Finally, any free program is threatened constantly by software |
1408 |
|
|
-patents. We wish to avoid the danger that redistributors of a free |
1409 |
|
|
-program will individually obtain patent licenses, in effect making the |
1410 |
|
|
-program proprietary. To prevent this, we have made it clear that any |
1411 |
|
|
-patent must be licensed for everyone's free use or not licensed at all. |
1412 |
|
|
- |
1413 |
|
|
- The precise terms and conditions for copying, distribution and |
1414 |
|
|
-modification follow. |
1415 |
|
|
- |
1416 |
|
|
- GNU GENERAL PUBLIC LICENSE |
1417 |
|
|
- TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION |
1418 |
|
|
- |
1419 |
|
|
- 0. This License applies to any program or other work which contains |
1420 |
|
|
-a notice placed by the copyright holder saying it may be distributed |
1421 |
|
|
-under the terms of this General Public License. The "Program", below, |
1422 |
|
|
-refers to any such program or work, and a "work based on the Program" |
1423 |
|
|
-means either the Program or any derivative work under copyright law: |
1424 |
|
|
-that is to say, a work containing the Program or a portion of it, |
1425 |
|
|
-either verbatim or with modifications and/or translated into another |
1426 |
|
|
-language. (Hereinafter, translation is included without limitation in |
1427 |
|
|
-the term "modification".) Each licensee is addressed as "you". |
1428 |
|
|
- |
1429 |
|
|
-Activities other than copying, distribution and modification are not |
1430 |
|
|
-covered by this License; they are outside its scope. The act of |
1431 |
|
|
-running the Program is not restricted, and the output from the Program |
1432 |
|
|
-is covered only if its contents constitute a work based on the |
1433 |
|
|
-Program (independent of having been made by running the Program). |
1434 |
|
|
-Whether that is true depends on what the Program does. |
1435 |
|
|
- |
1436 |
|
|
- 1. You may copy and distribute verbatim copies of the Program's |
1437 |
|
|
-source code as you receive it, in any medium, provided that you |
1438 |
|
|
-conspicuously and appropriately publish on each copy an appropriate |
1439 |
|
|
-copyright notice and disclaimer of warranty; keep intact all the |
1440 |
|
|
-notices that refer to this License and to the absence of any warranty; |
1441 |
|
|
-and give any other recipients of the Program a copy of this License |
1442 |
|
|
-along with the Program. |
1443 |
|
|
- |
1444 |
|
|
-You may charge a fee for the physical act of transferring a copy, and |
1445 |
|
|
-you may at your option offer warranty protection in exchange for a fee. |
1446 |
|
|
- |
1447 |
|
|
- 2. You may modify your copy or copies of the Program or any portion |
1448 |
|
|
-of it, thus forming a work based on the Program, and copy and |
1449 |
|
|
-distribute such modifications or work under the terms of Section 1 |
1450 |
|
|
-above, provided that you also meet all of these conditions: |
1451 |
|
|
- |
1452 |
|
|
- a) You must cause the modified files to carry prominent notices |
1453 |
|
|
- stating that you changed the files and the date of any change. |
1454 |
|
|
- |
1455 |
|
|
- b) You must cause any work that you distribute or publish, that in |
1456 |
|
|
- whole or in part contains or is derived from the Program or any |
1457 |
|
|
- part thereof, to be licensed as a whole at no charge to all third |
1458 |
|
|
- parties under the terms of this License. |
1459 |
|
|
- |
1460 |
|
|
- c) If the modified program normally reads commands interactively |
1461 |
|
|
- when run, you must cause it, when started running for such |
1462 |
|
|
- interactive use in the most ordinary way, to print or display an |
1463 |
|
|
- announcement including an appropriate copyright notice and a |
1464 |
|
|
- notice that there is no warranty (or else, saying that you provide |
1465 |
|
|
- a warranty) and that users may redistribute the program under |
1466 |
|
|
- these conditions, and telling the user how to view a copy of this |
1467 |
|
|
- License. (Exception: if the Program itself is interactive but |
1468 |
|
|
- does not normally print such an announcement, your work based on |
1469 |
|
|
- the Program is not required to print an announcement.) |
1470 |
|
|
- |
1471 |
|
|
-These requirements apply to the modified work as a whole. If |
1472 |
|
|
-identifiable sections of that work are not derived from the Program, |
1473 |
|
|
-and can be reasonably considered independent and separate works in |
1474 |
|
|
-themselves, then this License, and its terms, do not apply to those |
1475 |
|
|
-sections when you distribute them as separate works. But when you |
1476 |
|
|
-distribute the same sections as part of a whole which is a work based |
1477 |
|
|
-on the Program, the distribution of the whole must be on the terms of |
1478 |
|
|
-this License, whose permissions for other licensees extend to the |
1479 |
|
|
-entire whole, and thus to each and every part regardless of who wrote it. |
1480 |
|
|
- |
1481 |
|
|
-Thus, it is not the intent of this section to claim rights or contest |
1482 |
|
|
-your rights to work written entirely by you; rather, the intent is to |
1483 |
|
|
-exercise the right to control the distribution of derivative or |
1484 |
|
|
-collective works based on the Program. |
1485 |
|
|
- |
1486 |
|
|
-In addition, mere aggregation of another work not based on the Program |
1487 |
|
|
-with the Program (or with a work based on the Program) on a volume of |
1488 |
|
|
-a storage or distribution medium does not bring the other work under |
1489 |
|
|
-the scope of this License. |
1490 |
|
|
- |
1491 |
|
|
- 3. You may copy and distribute the Program (or a work based on it, |
1492 |
|
|
-under Section 2) in object code or executable form under the terms of |
1493 |
|
|
-Sections 1 and 2 above provided that you also do one of the following: |
1494 |
|
|
- |
1495 |
|
|
- a) Accompany it with the complete corresponding machine-readable |
1496 |
|
|
- source code, which must be distributed under the terms of Sections |
1497 |
|
|
- 1 and 2 above on a medium customarily used for software interchange; or, |
1498 |
|
|
- |
1499 |
|
|
- b) Accompany it with a written offer, valid for at least three |
1500 |
|
|
- years, to give any third party, for a charge no more than your |
1501 |
|
|
- cost of physically performing source distribution, a complete |
1502 |
|
|
- machine-readable copy of the corresponding source code, to be |
1503 |
|
|
- distributed under the terms of Sections 1 and 2 above on a medium |
1504 |
|
|
- customarily used for software interchange; or, |
1505 |
|
|
- |
1506 |
|
|
- c) Accompany it with the information you received as to the offer |
1507 |
|
|
- to distribute corresponding source code. (This alternative is |
1508 |
|
|
- allowed only for noncommercial distribution and only if you |
1509 |
|
|
- received the program in object code or executable form with such |
1510 |
|
|
- an offer, in accord with Subsection b above.) |
1511 |
|
|
- |
1512 |
|
|
-The source code for a work means the preferred form of the work for |
1513 |
|
|
-making modifications to it. For an executable work, complete source |
1514 |
|
|
-code means all the source code for all modules it contains, plus any |
1515 |
|
|
-associated interface definition files, plus the scripts used to |
1516 |
|
|
-control compilation and installation of the executable. However, as a |
1517 |
|
|
-special exception, the source code distributed need not include |
1518 |
|
|
-anything that is normally distributed (in either source or binary |
1519 |
|
|
-form) with the major components (compiler, kernel, and so on) of the |
1520 |
|
|
-operating system on which the executable runs, unless that component |
1521 |
|
|
-itself accompanies the executable. |
1522 |
|
|
- |
1523 |
|
|
-If distribution of executable or object code is made by offering |
1524 |
|
|
-access to copy from a designated place, then offering equivalent |
1525 |
|
|
-access to copy the source code from the same place counts as |
1526 |
|
|
-distribution of the source code, even though third parties are not |
1527 |
|
|
-compelled to copy the source along with the object code. |
1528 |
|
|
- |
1529 |
|
|
- 4. You may not copy, modify, sublicense, or distribute the Program |
1530 |
|
|
-except as expressly provided under this License. Any attempt |
1531 |
|
|
-otherwise to copy, modify, sublicense or distribute the Program is |
1532 |
|
|
-void, and will automatically terminate your rights under this License. |
1533 |
|
|
-However, parties who have received copies, or rights, from you under |
1534 |
|
|
-this License will not have their licenses terminated so long as such |
1535 |
|
|
-parties remain in full compliance. |
1536 |
|
|
- |
1537 |
|
|
- 5. You are not required to accept this License, since you have not |
1538 |
|
|
-signed it. However, nothing else grants you permission to modify or |
1539 |
|
|
-distribute the Program or its derivative works. These actions are |
1540 |
|
|
-prohibited by law if you do not accept this License. Therefore, by |
1541 |
|
|
-modifying or distributing the Program (or any work based on the |
1542 |
|
|
-Program), you indicate your acceptance of this License to do so, and |
1543 |
|
|
-all its terms and conditions for copying, distributing or modifying |
1544 |
|
|
-the Program or works based on it. |
1545 |
|
|
- |
1546 |
|
|
- 6. Each time you redistribute the Program (or any work based on the |
1547 |
|
|
-Program), the recipient automatically receives a license from the |
1548 |
|
|
-original licensor to copy, distribute or modify the Program subject to |
1549 |
|
|
-these terms and conditions. You may not impose any further |
1550 |
|
|
-restrictions on the recipients' exercise of the rights granted herein. |
1551 |
|
|
-You are not responsible for enforcing compliance by third parties to |
1552 |
|
|
-this License. |
1553 |
|
|
- |
1554 |
|
|
- 7. If, as a consequence of a court judgment or allegation of patent |
1555 |
|
|
-infringement or for any other reason (not limited to patent issues), |
1556 |
|
|
-conditions are imposed on you (whether by court order, agreement or |
1557 |
|
|
-otherwise) that contradict the conditions of this License, they do not |
1558 |
|
|
-excuse you from the conditions of this License. If you cannot |
1559 |
|
|
-distribute so as to satisfy simultaneously your obligations under this |
1560 |
|
|
-License and any other pertinent obligations, then as a consequence you |
1561 |
|
|
-may not distribute the Program at all. For example, if a patent |
1562 |
|
|
-license would not permit royalty-free redistribution of the Program by |
1563 |
|
|
-all those who receive copies directly or indirectly through you, then |
1564 |
|
|
-the only way you could satisfy both it and this License would be to |
1565 |
|
|
-refrain entirely from distribution of the Program. |
1566 |
|
|
- |
1567 |
|
|
-If any portion of this section is held invalid or unenforceable under |
1568 |
|
|
-any particular circumstance, the balance of the section is intended to |
1569 |
|
|
-apply and the section as a whole is intended to apply in other |
1570 |
|
|
-circumstances. |
1571 |
|
|
- |
1572 |
|
|
-It is not the purpose of this section to induce you to infringe any |
1573 |
|
|
-patents or other property right claims or to contest validity of any |
1574 |
|
|
-such claims; this section has the sole purpose of protecting the |
1575 |
|
|
-integrity of the free software distribution system, which is |
1576 |
|
|
-implemented by public license practices. Many people have made |
1577 |
|
|
-generous contributions to the wide range of software distributed |
1578 |
|
|
-through that system in reliance on consistent application of that |
1579 |
|
|
-system; it is up to the author/donor to decide if he or she is willing |
1580 |
|
|
-to distribute software through any other system and a licensee cannot |
1581 |
|
|
-impose that choice. |
1582 |
|
|
- |
1583 |
|
|
-This section is intended to make thoroughly clear what is believed to |
1584 |
|
|
-be a consequence of the rest of this License. |
1585 |
|
|
- |
1586 |
|
|
- 8. If the distribution and/or use of the Program is restricted in |
1587 |
|
|
-certain countries either by patents or by copyrighted interfaces, the |
1588 |
|
|
-original copyright holder who places the Program under this License |
1589 |
|
|
-may add an explicit geographical distribution limitation excluding |
1590 |
|
|
-those countries, so that distribution is permitted only in or among |
1591 |
|
|
-countries not thus excluded. In such case, this License incorporates |
1592 |
|
|
-the limitation as if written in the body of this License. |
1593 |
|
|
- |
1594 |
|
|
- 9. The Free Software Foundation may publish revised and/or new versions |
1595 |
|
|
-of the General Public License from time to time. Such new versions will |
1596 |
|
|
-be similar in spirit to the present version, but may differ in detail to |
1597 |
|
|
-address new problems or concerns. |
1598 |
|
|
- |
1599 |
|
|
-Each version is given a distinguishing version number. If the Program |
1600 |
|
|
-specifies a version number of this License which applies to it and "any |
1601 |
|
|
-later version", you have the option of following the terms and conditions |
1602 |
|
|
-either of that version or of any later version published by the Free |
1603 |
|
|
-Software Foundation. If the Program does not specify a version number of |
1604 |
|
|
-this License, you may choose any version ever published by the Free Software |
1605 |
|
|
-Foundation. |
1606 |
|
|
- |
1607 |
|
|
- 10. If you wish to incorporate parts of the Program into other free |
1608 |
|
|
-programs whose distribution conditions are different, write to the author |
1609 |
|
|
-to ask for permission. For software which is copyrighted by the Free |
1610 |
|
|
-Software Foundation, write to the Free Software Foundation; we sometimes |
1611 |
|
|
-make exceptions for this. Our decision will be guided by the two goals |
1612 |
|
|
-of preserving the free status of all derivatives of our free software and |
1613 |
|
|
-of promoting the sharing and reuse of software generally. |
1614 |
|
|
- |
1615 |
|
|
- NO WARRANTY |
1616 |
|
|
- |
1617 |
|
|
- 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY |
1618 |
|
|
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN |
1619 |
|
|
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES |
1620 |
|
|
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED |
1621 |
|
|
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
1622 |
|
|
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS |
1623 |
|
|
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE |
1624 |
|
|
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, |
1625 |
|
|
-REPAIR OR CORRECTION. |
1626 |
|
|
- |
1627 |
|
|
- 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
1628 |
|
|
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR |
1629 |
|
|
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, |
1630 |
|
|
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING |
1631 |
|
|
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED |
1632 |
|
|
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY |
1633 |
|
|
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER |
1634 |
|
|
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE |
1635 |
|
|
-POSSIBILITY OF SUCH DAMAGES. |
1636 |
|
|
- |
1637 |
|
|
- END OF TERMS AND CONDITIONS |
1638 |
|
|
- |
1639 |
|
|
- How to Apply These Terms to Your New Programs |
1640 |
|
|
- |
1641 |
|
|
- If you develop a new program, and you want it to be of the greatest |
1642 |
|
|
-possible use to the public, the best way to achieve this is to make it |
1643 |
|
|
-free software which everyone can redistribute and change under these terms. |
1644 |
|
|
- |
1645 |
|
|
- To do so, attach the following notices to the program. It is safest |
1646 |
|
|
-to attach them to the start of each source file to most effectively |
1647 |
|
|
-convey the exclusion of warranty; and each file should have at least |
1648 |
|
|
-the "copyright" line and a pointer to where the full notice is found. |
1649 |
|
|
- |
1650 |
|
|
- <one line to give the program's name and a brief idea of what it does.> |
1651 |
|
|
- Copyright (C) 19yy <name of author> |
1652 |
|
|
- |
1653 |
|
|
- This program is free software; you can redistribute it and/or modify |
1654 |
|
|
- it under the terms of the GNU General Public License as published by |
1655 |
|
|
- the Free Software Foundation; either version 2 of the License, or |
1656 |
|
|
- (at your option) any later version. |
1657 |
|
|
- |
1658 |
|
|
- This program is distributed in the hope that it will be useful, |
1659 |
|
|
- but WITHOUT ANY WARRANTY; without even the implied warranty of |
1660 |
|
|
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
1661 |
|
|
- GNU General Public License for more details. |
1662 |
|
|
- |
1663 |
|
|
- You should have received a copy of the GNU General Public License |
1664 |
|
|
- along with this program; if not, write to the Free Software |
1665 |
|
|
- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
1666 |
|
|
- |
1667 |
|
|
- |
1668 |
|
|
-Also add information on how to contact you by electronic and paper mail. |
1669 |
|
|
- |
1670 |
|
|
-If the program is interactive, make it output a short notice like this |
1671 |
|
|
-when it starts in an interactive mode: |
1672 |
|
|
- |
1673 |
|
|
- Gnomovision version 69, Copyright (C) 19yy name of author |
1674 |
|
|
- Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
1675 |
|
|
- This is free software, and you are welcome to redistribute it |
1676 |
|
|
- under certain conditions; type `show c' for details. |
1677 |
|
|
- |
1678 |
|
|
-The hypothetical commands `show w' and `show c' should show the appropriate |
1679 |
|
|
-parts of the General Public License. Of course, the commands you use may |
1680 |
|
|
-be called something other than `show w' and `show c'; they could even be |
1681 |
|
|
-mouse-clicks or menu items--whatever suits your program. |
1682 |
|
|
- |
1683 |
|
|
-You should also get your employer (if you work as a programmer) or your |
1684 |
|
|
-school, if any, to sign a "copyright disclaimer" for the program, if |
1685 |
|
|
-necessary. Here is a sample; alter the names: |
1686 |
|
|
- |
1687 |
|
|
- Yoyodyne, Inc., hereby disclaims all copyright interest in the program |
1688 |
|
|
- `Gnomovision' (which makes passes at compilers) written by James Hacker. |
1689 |
|
|
- |
1690 |
|
|
- <signature of Ty Coon>, 1 April 1989 |
1691 |
|
|
- Ty Coon, President of Vice |
1692 |
|
|
- |
1693 |
|
|
-This General Public License does not permit incorporating your program into |
1694 |
|
|
-proprietary programs. If your program is a subroutine library, you may |
1695 |
|
|
-consider it more useful to permit linking proprietary applications with the |
1696 |
|
|
-library. If this is what you want to do, use the GNU Library General |
1697 |
|
|
-Public License instead of this License. |
1698 |
|
|
+ GNU GENERAL PUBLIC LICENSE |
1699 |
|
|
+ Version 2, June 1991 |
1700 |
|
|
+ |
1701 |
|
|
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc. |
1702 |
|
|
+ 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
1703 |
|
|
+ Everyone is permitted to copy and distribute verbatim copies |
1704 |
|
|
+ of this license document, but changing it is not allowed. |
1705 |
|
|
+ |
1706 |
|
|
+ Preamble |
1707 |
|
|
+ |
1708 |
|
|
+ The licenses for most software are designed to take away your |
1709 |
|
|
+freedom to share and change it. By contrast, the GNU General Public |
1710 |
|
|
+License is intended to guarantee your freedom to share and change free |
1711 |
|
|
+software--to make sure the software is free for all its users. This |
1712 |
|
|
+General Public License applies to most of the Free Software |
1713 |
|
|
+Foundation's software and to any other program whose authors commit to |
1714 |
|
|
+using it. (Some other Free Software Foundation software is covered by |
1715 |
|
|
+the GNU Library General Public License instead.) You can apply it to |
1716 |
|
|
+your programs, too. |
1717 |
|
|
+ |
1718 |
|
|
+ When we speak of free software, we are referring to freedom, not |
1719 |
|
|
+price. Our General Public Licenses are designed to make sure that you |
1720 |
|
|
+have the freedom to distribute copies of free software (and charge for |
1721 |
|
|
+this service if you wish), that you receive source code or can get it |
1722 |
|
|
+if you want it, that you can change the software or use pieces of it |
1723 |
|
|
+in new free programs; and that you know you can do these things. |
1724 |
|
|
+ |
1725 |
|
|
+ To protect your rights, we need to make restrictions that forbid |
1726 |
|
|
+anyone to deny you these rights or to ask you to surrender the rights. |
1727 |
|
|
+These restrictions translate to certain responsibilities for you if you |
1728 |
|
|
+distribute copies of the software, or if you modify it. |
1729 |
|
|
+ |
1730 |
|
|
+ For example, if you distribute copies of such a program, whether |
1731 |
|
|
+gratis or for a fee, you must give the recipients all the rights that |
1732 |
|
|
+you have. You must make sure that they, too, receive or can get the |
1733 |
|
|
+source code. And you must show them these terms so they know their |
1734 |
|
|
+rights. |
1735 |
|
|
+ |
1736 |
|
|
+ We protect your rights with two steps: (1) copyright the software, and |
1737 |
|
|
+(2) offer you this license which gives you legal permission to copy, |
1738 |
|
|
+distribute and/or modify the software. |
1739 |
|
|
+ |
1740 |
|
|
+ Also, for each author's protection and ours, we want to make certain |
1741 |
|
|
+that everyone understands that there is no warranty for this free |
1742 |
|
|
+software. If the software is modified by someone else and passed on, we |
1743 |
|
|
+want its recipients to know that what they have is not the original, so |
1744 |
|
|
+that any problems introduced by others will not reflect on the original |
1745 |
|
|
+authors' reputations. |
1746 |
|
|
+ |
1747 |
|
|
+ Finally, any free program is threatened constantly by software |
1748 |
|
|
+patents. We wish to avoid the danger that redistributors of a free |
1749 |
|
|
+program will individually obtain patent licenses, in effect making the |
1750 |
|
|
+program proprietary. To prevent this, we have made it clear that any |
1751 |
|
|
+patent must be licensed for everyone's free use or not licensed at all. |
1752 |
|
|
+ |
1753 |
|
|
+ The precise terms and conditions for copying, distribution and |
1754 |
|
|
+modification follow. |
1755 |
|
|
+ |
1756 |
|
|
+ GNU GENERAL PUBLIC LICENSE |
1757 |
|
|
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION |
1758 |
|
|
+ |
1759 |
|
|
+ 0. This License applies to any program or other work which contains |
1760 |
|
|
+a notice placed by the copyright holder saying it may be distributed |
1761 |
|
|
+under the terms of this General Public License. The "Program", below, |
1762 |
|
|
+refers to any such program or work, and a "work based on the Program" |
1763 |
|
|
+means either the Program or any derivative work under copyright law: |
1764 |
|
|
+that is to say, a work containing the Program or a portion of it, |
1765 |
|
|
+either verbatim or with modifications and/or translated into another |
1766 |
|
|
+language. (Hereinafter, translation is included without limitation in |
1767 |
|
|
+the term "modification".) Each licensee is addressed as "you". |
1768 |
|
|
+ |
1769 |
|
|
+Activities other than copying, distribution and modification are not |
1770 |
|
|
+covered by this License; they are outside its scope. The act of |
1771 |
|
|
+running the Program is not restricted, and the output from the Program |
1772 |
|
|
+is covered only if its contents constitute a work based on the |
1773 |
|
|
+Program (independent of having been made by running the Program). |
1774 |
|
|
+Whether that is true depends on what the Program does. |
1775 |
|
|
+ |
1776 |
|
|
+ 1. You may copy and distribute verbatim copies of the Program's |
1777 |
|
|
+source code as you receive it, in any medium, provided that you |
1778 |
|
|
+conspicuously and appropriately publish on each copy an appropriate |
1779 |
|
|
+copyright notice and disclaimer of warranty; keep intact all the |
1780 |
|
|
+notices that refer to this License and to the absence of any warranty; |
1781 |
|
|
+and give any other recipients of the Program a copy of this License |
1782 |
|
|
+along with the Program. |
1783 |
|
|
+ |
1784 |
|
|
+You may charge a fee for the physical act of transferring a copy, and |
1785 |
|
|
+you may at your option offer warranty protection in exchange for a fee. |
1786 |
|
|
+ |
1787 |
|
|
+ 2. You may modify your copy or copies of the Program or any portion |
1788 |
|
|
+of it, thus forming a work based on the Program, and copy and |
1789 |
|
|
+distribute such modifications or work under the terms of Section 1 |
1790 |
|
|
+above, provided that you also meet all of these conditions: |
1791 |
|
|
+ |
1792 |
|
|
+ a) You must cause the modified files to carry prominent notices |
1793 |
|
|
+ stating that you changed the files and the date of any change. |
1794 |
|
|
+ |
1795 |
|
|
+ b) You must cause any work that you distribute or publish, that in |
1796 |
|
|
+ whole or in part contains or is derived from the Program or any |
1797 |
|
|
+ part thereof, to be licensed as a whole at no charge to all third |
1798 |
|
|
+ parties under the terms of this License. |
1799 |
|
|
+ |
1800 |
|
|
+ c) If the modified program normally reads commands interactively |
1801 |
|
|
+ when run, you must cause it, when started running for such |
1802 |
|
|
+ interactive use in the most ordinary way, to print or display an |
1803 |
|
|
+ announcement including an appropriate copyright notice and a |
1804 |
|
|
+ notice that there is no warranty (or else, saying that you provide |
1805 |
|
|
+ a warranty) and that users may redistribute the program under |
1806 |
|
|
+ these conditions, and telling the user how to view a copy of this |
1807 |
|
|
+ License. (Exception: if the Program itself is interactive but |
1808 |
|
|
+ does not normally print such an announcement, your work based on |
1809 |
|
|
+ the Program is not required to print an announcement.) |
1810 |
|
|
+ |
1811 |
|
|
+These requirements apply to the modified work as a whole. If |
1812 |
|
|
+identifiable sections of that work are not derived from the Program, |
1813 |
|
|
+and can be reasonably considered independent and separate works in |
1814 |
|
|
+themselves, then this License, and its terms, do not apply to those |
1815 |
|
|
+sections when you distribute them as separate works. But when you |
1816 |
|
|
+distribute the same sections as part of a whole which is a work based |
1817 |
|
|
+on the Program, the distribution of the whole must be on the terms of |
1818 |
|
|
+this License, whose permissions for other licensees extend to the |
1819 |
|
|
+entire whole, and thus to each and every part regardless of who wrote it. |
1820 |
|
|
+ |
1821 |
|
|
+Thus, it is not the intent of this section to claim rights or contest |
1822 |
|
|
+your rights to work written entirely by you; rather, the intent is to |
1823 |
|
|
+exercise the right to control the distribution of derivative or |
1824 |
|
|
+collective works based on the Program. |
1825 |
|
|
+ |
1826 |
|
|
+In addition, mere aggregation of another work not based on the Program |
1827 |
|
|
+with the Program (or with a work based on the Program) on a volume of |
1828 |
|
|
+a storage or distribution medium does not bring the other work under |
1829 |
|
|
+the scope of this License. |
1830 |
|
|
+ |
1831 |
|
|
+ 3. You may copy and distribute the Program (or a work based on it, |
1832 |
|
|
+under Section 2) in object code or executable form under the terms of |
1833 |
|
|
+Sections 1 and 2 above provided that you also do one of the following: |
1834 |
|
|
+ |
1835 |
|
|
+ a) Accompany it with the complete corresponding machine-readable |
1836 |
|
|
+ source code, which must be distributed under the terms of Sections |
1837 |
|
|
+ 1 and 2 above on a medium customarily used for software interchange; or, |
1838 |
|
|
+ |
1839 |
|
|
+ b) Accompany it with a written offer, valid for at least three |
1840 |
|
|
+ years, to give any third party, for a charge no more than your |
1841 |
|
|
+ cost of physically performing source distribution, a complete |
1842 |
|
|
+ machine-readable copy of the corresponding source code, to be |
1843 |
|
|
+ distributed under the terms of Sections 1 and 2 above on a medium |
1844 |
|
|
+ customarily used for software interchange; or, |
1845 |
|
|
+ |
1846 |
|
|
+ c) Accompany it with the information you received as to the offer |
1847 |
|
|
+ to distribute corresponding source code. (This alternative is |
1848 |
|
|
+ allowed only for noncommercial distribution and only if you |
1849 |
|
|
+ received the program in object code or executable form with such |
1850 |
|
|
+ an offer, in accord with Subsection b above.) |
1851 |
|
|
+ |
1852 |
|
|
+The source code for a work means the preferred form of the work for |
1853 |
|
|
+making modifications to it. For an executable work, complete source |
1854 |
|
|
+code means all the source code for all modules it contains, plus any |
1855 |
|
|
+associated interface definition files, plus the scripts used to |
1856 |
|
|
+control compilation and installation of the executable. However, as a |
1857 |
|
|
+special exception, the source code distributed need not include |
1858 |
|
|
+anything that is normally distributed (in either source or binary |
1859 |
|
|
+form) with the major components (compiler, kernel, and so on) of the |
1860 |
|
|
+operating system on which the executable runs, unless that component |
1861 |
|
|
+itself accompanies the executable. |
1862 |
|
|
+ |
1863 |
|
|
+If distribution of executable or object code is made by offering |
1864 |
|
|
+access to copy from a designated place, then offering equivalent |
1865 |
|
|
+access to copy the source code from the same place counts as |
1866 |
|
|
+distribution of the source code, even though third parties are not |
1867 |
|
|
+compelled to copy the source along with the object code. |
1868 |
|
|
+ |
1869 |
|
|
+ 4. You may not copy, modify, sublicense, or distribute the Program |
1870 |
|
|
+except as expressly provided under this License. Any attempt |
1871 |
|
|
+otherwise to copy, modify, sublicense or distribute the Program is |
1872 |
|
|
+void, and will automatically terminate your rights under this License. |
1873 |
|
|
+However, parties who have received copies, or rights, from you under |
1874 |
|
|
+this License will not have their licenses terminated so long as such |
1875 |
|
|
+parties remain in full compliance. |
1876 |
|
|
+ |
1877 |
|
|
+ 5. You are not required to accept this License, since you have not |
1878 |
|
|
+signed it. However, nothing else grants you permission to modify or |
1879 |
|
|
+distribute the Program or its derivative works. These actions are |
1880 |
|
|
+prohibited by law if you do not accept this License. Therefore, by |
1881 |
|
|
+modifying or distributing the Program (or any work based on the |
1882 |
|
|
+Program), you indicate your acceptance of this License to do so, and |
1883 |
|
|
+all its terms and conditions for copying, distributing or modifying |
1884 |
|
|
+the Program or works based on it. |
1885 |
|
|
+ |
1886 |
|
|
+ 6. Each time you redistribute the Program (or any work based on the |
1887 |
|
|
+Program), the recipient automatically receives a license from the |
1888 |
|
|
+original licensor to copy, distribute or modify the Program subject to |
1889 |
|
|
+these terms and conditions. You may not impose any further |
1890 |
|
|
+restrictions on the recipients' exercise of the rights granted herein. |
1891 |
|
|
+You are not responsible for enforcing compliance by third parties to |
1892 |
|
|
+this License. |
1893 |
|
|
+ |
1894 |
|
|
+ 7. If, as a consequence of a court judgment or allegation of patent |
1895 |
|
|
+infringement or for any other reason (not limited to patent issues), |
1896 |
|
|
+conditions are imposed on you (whether by court order, agreement or |
1897 |
|
|
+otherwise) that contradict the conditions of this License, they do not |
1898 |
|
|
+excuse you from the conditions of this License. If you cannot |
1899 |
|
|
+distribute so as to satisfy simultaneously your obligations under this |
1900 |
|
|
+License and any other pertinent obligations, then as a consequence you |
1901 |
|
|
+may not distribute the Program at all. For example, if a patent |
1902 |
|
|
+license would not permit royalty-free redistribution of the Program by |
1903 |
|
|
+all those who receive copies directly or indirectly through you, then |
1904 |
|
|
+the only way you could satisfy both it and this License would be to |
1905 |
|
|
+refrain entirely from distribution of the Program. |
1906 |
|
|
+ |
1907 |
|
|
+If any portion of this section is held invalid or unenforceable under |
1908 |
|
|
+any particular circumstance, the balance of the section is intended to |
1909 |
|
|
+apply and the section as a whole is intended to apply in other |
1910 |
|
|
+circumstances. |
1911 |
|
|
+ |
1912 |
|
|
+It is not the purpose of this section to induce you to infringe any |
1913 |
|
|
+patents or other property right claims or to contest validity of any |
1914 |
|
|
+such claims; this section has the sole purpose of protecting the |
1915 |
|
|
+integrity of the free software distribution system, which is |
1916 |
|
|
+implemented by public license practices. Many people have made |
1917 |
|
|
+generous contributions to the wide range of software distributed |
1918 |
|
|
+through that system in reliance on consistent application of that |
1919 |
|
|
+system; it is up to the author/donor to decide if he or she is willing |
1920 |
|
|
+to distribute software through any other system and a licensee cannot |
1921 |
|
|
+impose that choice. |
1922 |
|
|
+ |
1923 |
|
|
+This section is intended to make thoroughly clear what is believed to |
1924 |
|
|
+be a consequence of the rest of this License. |
1925 |
|
|
+ |
1926 |
|
|
+ 8. If the distribution and/or use of the Program is restricted in |
1927 |
|
|
+certain countries either by patents or by copyrighted interfaces, the |
1928 |
|
|
+original copyright holder who places the Program under this License |
1929 |
|
|
+may add an explicit geographical distribution limitation excluding |
1930 |
|
|
+those countries, so that distribution is permitted only in or among |
1931 |
|
|
+countries not thus excluded. In such case, this License incorporates |
1932 |
|
|
+the limitation as if written in the body of this License. |
1933 |
|
|
+ |
1934 |
|
|
+ 9. The Free Software Foundation may publish revised and/or new versions |
1935 |
|
|
+of the General Public License from time to time. Such new versions will |
1936 |
|
|
+be similar in spirit to the present version, but may differ in detail to |
1937 |
|
|
+address new problems or concerns. |
1938 |
|
|
+ |
1939 |
|
|
+Each version is given a distinguishing version number. If the Program |
1940 |
|
|
+specifies a version number of this License which applies to it and "any |
1941 |
|
|
+later version", you have the option of following the terms and conditions |
1942 |
|
|
+either of that version or of any later version published by the Free |
1943 |
|
|
+Software Foundation. If the Program does not specify a version number of |
1944 |
|
|
+this License, you may choose any version ever published by the Free Software |
1945 |
|
|
+Foundation. |
1946 |
|
|
+ |
1947 |
|
|
+ 10. If you wish to incorporate parts of the Program into other free |
1948 |
|
|
+programs whose distribution conditions are different, write to the author |
1949 |
|
|
+to ask for permission. For software which is copyrighted by the Free |
1950 |
|
|
+Software Foundation, write to the Free Software Foundation; we sometimes |
1951 |
|
|
+make exceptions for this. Our decision will be guided by the two goals |
1952 |
|
|
+of preserving the free status of all derivatives of our free software and |
1953 |
|
|
+of promoting the sharing and reuse of software generally. |
1954 |
|
|
+ |
1955 |
|
|
+ NO WARRANTY |
1956 |
|
|
+ |
1957 |
|
|
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY |
1958 |
|
|
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN |
1959 |
|
|
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES |
1960 |
|
|
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED |
1961 |
|
|
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
1962 |
|
|
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS |
1963 |
|
|
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE |
1964 |
|
|
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, |
1965 |
|
|
+REPAIR OR CORRECTION. |
1966 |
|
|
+ |
1967 |
|
|
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
1968 |
|
|
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR |
1969 |
|
|
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, |
1970 |
|
|
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING |
1971 |
|
|
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED |
1972 |
|
|
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY |
1973 |
|
|
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER |
1974 |
|
|
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE |
1975 |
|
|
+POSSIBILITY OF SUCH DAMAGES. |
1976 |
|
|
+ |
1977 |
|
|
+ END OF TERMS AND CONDITIONS |
1978 |
|
|
+ |
1979 |
|
|
+ How to Apply These Terms to Your New Programs |
1980 |
|
|
+ |
1981 |
|
|
+ If you develop a new program, and you want it to be of the greatest |
1982 |
|
|
+possible use to the public, the best way to achieve this is to make it |
1983 |
|
|
+free software which everyone can redistribute and change under these terms. |
1984 |
|
|
+ |
1985 |
|
|
+ To do so, attach the following notices to the program. It is safest |
1986 |
|
|
+to attach them to the start of each source file to most effectively |
1987 |
|
|
+convey the exclusion of warranty; and each file should have at least |
1988 |
|
|
+the "copyright" line and a pointer to where the full notice is found. |
1989 |
|
|
+ |
1990 |
|
|
+ <one line to give the program's name and a brief idea of what it does.> |
1991 |
|
|
+ Copyright (C) 19yy <name of author> |
1992 |
|
|
+ |
1993 |
|
|
+ This program is free software; you can redistribute it and/or modify |
1994 |
|
|
+ it under the terms of the GNU General Public License as published by |
1995 |
|
|
+ the Free Software Foundation; either version 2 of the License, or |
1996 |
|
|
+ (at your option) any later version. |
1997 |
|
|
+ |
1998 |
|
|
+ This program is distributed in the hope that it will be useful, |
1999 |
|
|
+ but WITHOUT ANY WARRANTY; without even the implied warranty of |
2000 |
|
|
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
2001 |
|
|
+ GNU General Public License for more details. |
2002 |
|
|
+ |
2003 |
|
|
+ You should have received a copy of the GNU General Public License |
2004 |
|
|
+ along with this program; if not, write to the Free Software |
2005 |
|
|
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
2006 |
|
|
+ |
2007 |
|
|
+ |
2008 |
|
|
+Also add information on how to contact you by electronic and paper mail. |
2009 |
|
|
+ |
2010 |
|
|
+If the program is interactive, make it output a short notice like this |
2011 |
|
|
+when it starts in an interactive mode: |
2012 |
|
|
+ |
2013 |
|
|
+ Gnomovision version 69, Copyright (C) 19yy name of author |
2014 |
|
|
+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
2015 |
|
|
+ This is free software, and you are welcome to redistribute it |
2016 |
|
|
+ under certain conditions; type `show c' for details. |
2017 |
|
|
+ |
2018 |
|
|
+The hypothetical commands `show w' and `show c' should show the appropriate |
2019 |
|
|
+parts of the General Public License. Of course, the commands you use may |
2020 |
|
|
+be called something other than `show w' and `show c'; they could even be |
2021 |
|
|
+mouse-clicks or menu items--whatever suits your program. |
2022 |
|
|
+ |
2023 |
|
|
+You should also get your employer (if you work as a programmer) or your |
2024 |
|
|
+school, if any, to sign a "copyright disclaimer" for the program, if |
2025 |
|
|
+necessary. Here is a sample; alter the names: |
2026 |
|
|
+ |
2027 |
|
|
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program |
2028 |
|
|
+ `Gnomovision' (which makes passes at compilers) written by James Hacker. |
2029 |
|
|
+ |
2030 |
|
|
+ <signature of Ty Coon>, 1 April 1989 |
2031 |
|
|
+ Ty Coon, President of Vice |
2032 |
|
|
+ |
2033 |
|
|
+This General Public License does not permit incorporating your program into |
2034 |
|
|
+proprietary programs. If your program is a subroutine library, you may |
2035 |
|
|
+consider it more useful to permit linking proprietary applications with the |
2036 |
|
|
+library. If this is what you want to do, use the GNU Library General |
2037 |
|
|
+Public License instead of this License. |