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 |
-.\" $Id: vacation.1,v 1.3 1999/01/04 04:28:02 psamuel Exp $ |
6 |
-.\" |
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 |
+.\" $Id: vacation.1,v 1.3 1999/01/04 04:28:02 psamuel Exp $ |
591 |
+.\" |
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. |