81f97d69cef756444e1b58f35f41fedc65b46461
[dragonfly.git] / share / man / man5 / periodic.conf.5
1 .\"-
2 .\" Copyright (c) 2000 Brian Somers <brian@Awfulhak.org>
3 .\" All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\"    notice, this list of conditions and the following disclaimer in the
12 .\"    documentation and/or other materials provided with the distribution.
13 .\"
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 .\" SUCH DAMAGE.
25 .\"
26 .\" $FreeBSD: head/share/man/man5/periodic.conf.5 323550 2017-09-13 16:35:16Z gordon $
27 .\"
28 .Dd April 21, 2019
29 .Dt PERIODIC.CONF 5
30 .Os
31 .Sh NAME
32 .Nm periodic.conf
33 .Nd periodic job configuration information
34 .Sh DESCRIPTION
35 The file
36 .Nm
37 contains a description of how daily, weekly and monthly system maintenance
38 jobs should run.
39 It resides in the
40 .Pa /etc/defaults
41 directory and parts may be overridden by a file of the same name in
42 .Pa /etc ,
43 which itself may be overridden by the
44 .Pa /etc/periodic.conf.local
45 file.
46 .Pp
47 The
48 .Nm
49 file
50 is actually sourced as a shell script from each of the periodic scripts
51 and is intended to simply provide default configuration variables.
52 .Pp
53 The following variables are used by
54 .Xr periodic 8
55 itself:
56 .Bl -tag -offset 4n -width 2n
57 .It Va local_periodic
58 .Pq Vt str
59 List of directories to search for periodic scripts.
60 This list is always prefixed with
61 .Pa /etc/periodic ,
62 and is only used when an argument to
63 .Xr periodic 8
64 is not an absolute directory name.
65 .It Ao Ar dir Ac Ns Va _output
66 .Pq Vt path No or Vt list
67 What to do with the output of the scripts executed from
68 the directory
69 .Ar dir .
70 If this variable is set to an absolute path name, output is logged to
71 that file, otherwise it is taken as one or more space separated email
72 addresses and mailed to those users.
73 If this variable is not set or is empty, output is sent to standard output.
74 .Pp
75 For an unattended machine, suitable values for
76 .Va daily_output ,
77 .Va weekly_output ,
78 and
79 .Va monthly_output
80 might be
81 .Dq Li /var/log/daily.log ,
82 .Dq Li /var/log/weekly.log ,
83 and
84 .Dq Li /var/log/monthly.log
85 respectively, as
86 .Xr newsyslog 8
87 will rotate these files (if they exists) at the appropriate times.
88 .It Ao Ar dir Ac Ns Va _show_success
89 .It Ao Ar dir Ac Ns Va _show_info
90 .It Ao Ar dir Ac Ns Va _show_badconfig
91 .Pq Vt bool
92 These variables control whether
93 .Xr periodic 8
94 will mask the output of the executed scripts based on their return code
95 (where
96 .Ar dir
97 is the base directory name in which each script resides).
98 If the return code of a script is
99 .Sq 0
100 and
101 .Ao Ar dir Ac Ns Va _show_success
102 is set to
103 .Dq Li NO ,
104 .Xr periodic 8
105 will mask the script's output.
106 If the return code of a script is
107 .Sq 1
108 and
109 .Ao Ar dir Ac Ns Va _show_info
110 is set to
111 .Dq Li NO ,
112 .Xr periodic 8
113 will mask the script's output.
114 If the return code of a script is
115 .Sq 2
116 and
117 .Ao Ar dir Ac Ns Va _show_badconfig
118 is set to
119 .Dq Li NO ,
120 .Xr periodic 8
121 will mask the script's output.
122 If these variables are set to neither
123 .Dq Li YES
124 nor
125 .Dq Li NO ,
126 they default to
127 .Dq Li YES ,
128 .Dq Li YES
129 and
130 .Dq Li NO
131 respectively.
132 .Pp
133 Refer to the
134 .Xr periodic 8
135 manual page for how script return codes are interpreted.
136 .It Va anticongestion_sleeptime
137 .Pq Vt int
138 The maximum number of seconds to randomly sleep in order to smooth bursty loads
139 on a shared resource, such as a download mirror.
140 .El
141 .Pp
142 The following variables are used by the standard scripts that reside in
143 .Pa /etc/periodic/daily :
144 .Bl -tag -offset 4n -width 2n
145 .It Va daily_clean_disks_enable
146 .Pq Vt bool
147 Set to
148 .Dq Li YES
149 if you want to remove all files matching
150 .Va daily_clean_disks_files
151 daily.
152 .It Va daily_clean_disks_files
153 .Pq Vt str
154 Set to a list of file names to match.
155 Wild cards are permitted.
156 .It Va daily_clean_disks_days
157 .Pq Vt num
158 When
159 .Va daily_clean_disks_enable
160 is set to
161 .Dq Li YES ,
162 this must also be set to the number of days old that a file's access
163 and modification times must be before it is deleted.
164 .It Va daily_clean_disks_verbose
165 .Pq Vt bool
166 Set to
167 .Dq Li YES
168 if you want the removed files to be reported in your daily output.
169 .It Va daily_clean_tmps_enable
170 .Pq Vt bool
171 Set to
172 .Dq Li YES
173 if you want to clear temporary directories daily.
174 .It Va daily_clean_tmps_dirs
175 .Pq Vt str
176 Set to the list of directories to clear if
177 .Va daily_clean_tmps_enable
178 is set to
179 .Dq Li YES .
180 .It Va daily_clean_tmps_days
181 .Pq Vt num
182 When
183 .Va daily_clean_tmps_enable
184 is set, this must also be set to the number of days old that a file's access
185 and modification times must be before it is deleted.
186 .It Va daily_clean_tmps_ignore
187 .Pq Vt str
188 Set to the list of files that should not be deleted when
189 .Va daily_clean_tmps_enable
190 is set to
191 .Dq Li YES .
192 Wild card characters are permitted.
193 .It Va daily_clean_tmps_verbose
194 .Pq Vt bool
195 Set to
196 .Dq Li YES
197 if you want the removed files to be reported in your daily output.
198 .It Va daily_clean_preserve_enable
199 .Pq Vt bool
200 Set to
201 .Dq Li YES
202 if you wish to remove old files from
203 .Pa /var/preserve .
204 .It Va daily_clean_preserve_days
205 .Pq Vt num
206 Set to the number of days that files must not have been modified before
207 they are deleted.
208 .It Va daily_clean_preserve_verbose
209 .Pq Vt bool
210 Set to
211 .Dq Li YES
212 if you want the removed files to be reported in your daily output.
213 .It Va daily_clean_msgs_enable
214 .Pq Vt bool
215 Set to
216 .Dq Li YES
217 if you wish old system messages to be purged.
218 .It Va daily_clean_msgs_days
219 .Pq Vt num
220 Set to the number of days that files must not have been modified before
221 they are deleted.
222 If this variable is left blank, the
223 .Xr msgs 1
224 default is used.
225 .It Va daily_clean_rwho_enable
226 .Pq Vt bool
227 Set to
228 .Dq Li YES
229 if you wish old files in
230 .Pa /var/who
231 to be purged.
232 .It Va daily_clean_rwho_days
233 .Pq Vt num
234 Set to the number of days that files must not have been modified before
235 they are deleted.
236 .It Va daily_clean_rwho_verbose
237 .Pq Vt bool
238 Set to
239 .Dq Li YES
240 if you want the removed files to be reported in your daily output.
241 .It Va daily_clean_hoststat_enable
242 .Pq Vt bool
243 Set to
244 .Dq Li YES
245 to run
246 .Nm sendmail Fl bH
247 to automatically purge stale entries from
248 .Xr sendmail 8 Ns 's
249 host status cache.
250 Files will be deleted using the same criteria as
251 .Xr sendmail 8
252 would normally use when determining whether to believe the cached information,
253 as configured in
254 .Pa /etc/mail/sendmail.cf .
255 .It Va daily_clean_hammer_enable
256 .Pq Vt bool
257 Set to
258 .Dq Li YES
259 if you want
260 .Xr HAMMER 5
261 file systems to be snapshot, pruned and reblocked.
262 .It Va daily_clean_hammer_verbose
263 .Pq Vt bool
264 Set to
265 .Dq Li YES
266 if you wish more verbose output.
267 .It Va daily_clean_hammer_pfslist
268 .Pq Vt str
269 Set to a list of
270 .Xr HAMMER 5
271 filesystems and pseudo-filesystems to clean.
272 If this variable is left blank, the default
273 .Xr hammer 8
274 .Ic cleanup
275 actions occur.
276 .It Va daily_clean_hammer2_enable
277 .Pq Vt bool
278 Set to
279 .Dq Li YES
280 if you want
281 to run
282 .Xr hammer2 8
283 .Cm cleanup .
284 This will e.g.\&
285 .Ic bulkfree
286 .Xr hammer2 8
287 file systems.
288 .It Va daily_clean_hammer2_verbose
289 .Pq Vt bool
290 Set to
291 .Dq Li YES
292 if you wish more verbose output.
293 .It Va daily_clean_hammer2_pfslist
294 .Pq Vt str
295 Set to a list of
296 .Xr hammer2 8
297 filesystems and pseudo-filesystems to clean.
298 If this variable is left blank, the default
299 .Xr hammer2 8
300 .Ic cleanup
301 actions occur.
302 .It Va daily_backup_passwd_enable
303 .Pq Vt bool
304 Set to
305 .Dq Li YES
306 if you want the
307 .Pa /etc/master.passwd
308 and
309 .Pa /etc/group
310 files backed up and reported on.
311 Reporting consists of checking both files for modifications and running
312 .Xr chkgrp 8
313 on the
314 .Pa group
315 file.
316 .It Va daily_backup_aliases_enable
317 .Pq Vt bool
318 Set to
319 .Dq Li YES
320 if you want the
321 .Pa /etc/mail/aliases
322 file backed up and modifications to be displayed in your daily output.
323 .It Va daily_calendar_enable
324 .Pq Vt bool
325 Set to
326 .Dq Li YES
327 if you want to run
328 .Nm calendar Fl a
329 daily.
330 .It Va daily_accounting_enable
331 .Pq Vt bool
332 Set to
333 .Dq Li YES
334 if you want to rotate your daily accounting files.
335 No rotations are necessary unless
336 .Va accounting_enable
337 is enabled in
338 .Xr rc.conf 5 .
339 .It Va daily_accounting_compress
340 .Pq Vt bool
341 Set to
342 .Dq Li YES
343 if you want your daily accounting files to be compressed using
344 .Xr gzip 1 .
345 .It Va daily_accounting_save
346 .Pq Vt num
347 When
348 .Va daily_accounting_enable
349 is set, this may also be set to the number of daily accounting files that are
350 to be saved.
351 The default is
352 .Dq Li 3 .
353 .It Va daily_accounting_flags
354 .Pq Vt str
355 Set to the arguments to pass to the
356 .Xr sa 8
357 utility (in addition to
358 .Fl s )
359 when
360 .Va daily_accounting_enable
361 is set to
362 .Dq Li YES .
363 The default is
364 .Fl q .
365 .It Va daily_news_expire_enable
366 .Pq Vt bool
367 Set to
368 .Dq Li YES
369 if you want to run
370 .Pa /etc/news.expire .
371 .It Va daily_status_disks_enable
372 .Pq Vt bool
373 Set to
374 .Dq Li YES
375 if you want to run
376 .Xr df 1
377 (with the arguments supplied in
378 .Va daily_status_disks_df_flags )
379 and
380 .Nm dump Fl W .
381 .It Va daily_status_disks_df_flags
382 .Pq Vt str
383 Set to the arguments for the
384 .Xr df 1
385 utility when
386 .Va daily_status_disks_enable
387 is set to
388 .Dq Li YES .
389 .It Va daily_status_mfi_enable
390 .Pq Vt bool
391 Set to
392 .Dq Li YES
393 if you want to run
394 .Nm mfiutil Cm status
395 on your
396 .Xr mfi 4
397 devices.
398 .It Va daily_status_network_enable
399 .Pq Vt bool
400 Set to
401 .Dq Li YES
402 if you want to run
403 .Nm netstat Fl i .
404 .It Va daily_status_network_netstat_flags
405 .Pq Vt str
406 Set to additional arguments for the
407 .Xr netstat 1
408 utility when
409 .Va daily_status_network_enable
410 is set to
411 .Dq Li YES .
412 The default is
413 .Fl d .
414 .It Va daily_status_network_usedns
415 .Pq Vt bool
416 Set to
417 .Dq Li YES
418 if you want to run
419 .Xr netstat 1
420 without the
421 .Fl n
422 option (to do DNS lookups).
423 .It Va daily_status_uptime_enable
424 .Pq Vt bool
425 Set to
426 .Dq Li YES
427 if you want to run
428 .Xr uptime 1
429 (or
430 .Xr ruptime 1
431 if
432 .Va rwhod_enable
433 is set to
434 .Dq Li YES
435 in
436 .Pa /etc/rc.conf ) .
437 .It Va daily_status_mailq_enable
438 .Pq Vt bool
439 Set to
440 .Dq Li YES
441 if you want to run
442 .Xr mailq 1 .
443 .It Va daily_status_mailq_shorten
444 .Pq Vt bool
445 Set to
446 .Dq Li YES
447 if you want to shorten the
448 .Xr mailq 1
449 output when
450 .Va daily_status_mailq_enable
451 is set to
452 .Dq Li YES .
453 .It Va daily_status_include_submit_mailq
454 .Pq Vt bool
455 Set to
456 .Dq Li YES
457 if you also want to run
458 .Xr mailq 1
459 on the submit mail queue when
460 .Va daily_status_mailq_enable
461 is set to
462 .Dq Li YES .
463 This may not work with MTAs other than
464 .Xr sendmail 8 .
465 .It Va daily_status_security_enable
466 .Pq Vt bool
467 Set to
468 .Dq Li YES
469 if you want to run the security check.
470 The security check is another set of
471 .Xr periodic 8
472 scripts.
473 The system defaults are in
474 .Pa /etc/periodic/security .
475 Local scripts should be placed in
476 .Pa /usr/local/etc/periodic/security .
477 See the
478 .Xr periodic 8
479 manual page for more information.
480 .It Va daily_status_security_inline
481 .Pq Vt bool
482 Set to
483 .Dq Li YES
484 if you want the security check output inline.
485 The default is to either mail or log the output according to the value of
486 .Va daily_status_security_output .
487 .It Va daily_status_security_output
488 .Pq Vt str
489 Where to send the output of the security check if
490 .Va daily_status_security_inline
491 is set to
492 .Dq Li NO .
493 This variable behaves in the same way as the
494 .Va *_output
495 variables above, namely it can be set either to one or more email addresses
496 or to an absolute file name.
497 .It Va daily_status_mail_rejects_enable
498 .Pq Vt bool
499 Set to
500 .Dq Li YES
501 if you want to summarise mail rejections logged to
502 .Pa /var/log/maillog
503 for the previous day.
504 .It Va daily_status_mail_rejects_logs
505 .Pq Vt num
506 Set to the number of maillog files that should be checked
507 for yesterday's mail rejects.
508 .It Va daily_status_mail_rejects_shorten
509 .Pq Vt bool
510 Set to
511 .Dq Li YES
512 if you want to shorten the mail rejections output.
513 .It Va daily_queuerun_enable
514 .Pq Vt bool
515 Set to
516 .Dq Li YES
517 if you want to manually run the mail queue at least once a day.
518 .It Va daily_submit_queuerun
519 .Pq Vt bool
520 Set to
521 .Dq Li YES
522 if you also want to manually run the submit mail queue at least once a day
523 when
524 .Va daily_queuerun_enable
525 is set to
526 .Dq Li YES .
527 .It Va daily_local
528 .Pq Vt str
529 Set to a list of extra scripts that should be run after all other
530 daily scripts.
531 All scripts must be absolute path names.
532 .El
533 .Pp
534 The following variables are used by the standard scripts that reside in
535 .Pa /etc/periodic/weekly :
536 .Bl -tag -offset 4n -width 2n
537 .It Va weekly_locate_enable
538 .Pq Vt bool
539 Set to
540 .Dq Li YES
541 if you want to run
542 .Pa /usr/libexec/locate.updatedb .
543 This script is run using
544 .Nm nice Fl 5
545 as user
546 .Dq Li nobody ,
547 and generates the table used by the
548 .Xr locate 1
549 command.
550 .It Va weekly_whatis_enable
551 .Pq Vt bool
552 Set to
553 .Dq Li YES
554 if you want to run
555 .Pa /usr/libexec/makewhatis.local .
556 This script regenerates the database used by the
557 .Xr apropos 1
558 command.
559 .It Va weekly_noid_enable
560 .Pq Vt bool
561 Set to
562 .Dq Li YES
563 if you want to locate orphaned files on the system.
564 An orphaned file is one with an invalid owner or group.
565 .It Va weekly_noid_dirs
566 .Pq Vt str
567 A list of directories under which orphaned files are searched for.
568 This would usually be set to
569 .Pa / .
570 .It Va weekly_status_security_enable
571 .Pq Vt bool
572 Weekly counterpart of
573 .Va daily_status_security_enable .
574 .It Va weekly_status_security_inline
575 .Pq Vt bool
576 Weekly counterpart of
577 .Va daily_status_security_inline .
578 .It Va weekly_status_security_output
579 .Pq Vt str
580 Weekly counterpart of
581 .Va daily_status_security_output .
582 .It Va weekly_local
583 .Pq Vt str
584 Set to a list of extra scripts that should be run after all other
585 weekly scripts.
586 All scripts must be absolute path names.
587 .El
588 .Pp
589 The following variables are used by the standard scripts that reside in
590 .Pa /etc/periodic/monthly :
591 .Bl -tag -offset 4n -width 2n
592 .It Va monthly_accounting_enable
593 .Pq Vt bool
594 Set to
595 .Dq Li YES
596 if you want to do login accounting using the
597 .Xr ac 8
598 command.
599 .It Va monthly_status_security_enable
600 .Pq Vt bool
601 Monthly counterpart of
602 .Va daily_status_security_enable .
603 .It Va monthly_status_security_inline
604 .Pq Vt bool
605 Monthly counterpart of
606 .Va daily_status_security_inline .
607 .It Va monthly_status_security_output
608 .Pq Vt str
609 Monthly counterpart of
610 .Va daily_status_security_output .
611 .It Va monthly_local
612 .Pq Vt str
613 Set to a list of extra scripts that should be run after all other
614 monthly scripts.
615 All scripts must be absolute path names.
616 .El
617 .Pp
618 The following variables are used by the standard scripts that reside in
619 .Pa /etc/periodic/security .
620 Those scripts are usually run from daily
621 .Pq Va daily_status_security_enable ,
622 weekly
623 .Pq Va weekly_status_security_enable ,
624 and monthly
625 .Pq Va monthly_status_security_enable
626 periodic hooks.
627 The
628 .Va ..._period
629 of each script can be configured as
630 .Dq daily ,
631 .Dq weekly ,
632 .Dq monthly
633 or
634 .Dq NO .
635 Note that when periodic security scripts are run from
636 .Xr crontab 5 ,
637 they will be always run unless their
638 .Va ..._enable
639 or
640 .Va ..._period
641 variable is set to
642 .Dq NO .
643 .Bl -tag -offset 4n -width 2n
644 .It Va security_status_logdir
645 .Pq Vt str
646 The directory where the security scripts expect the system's log files.
647 The default is
648 .Pa /var/log .
649 .It Va security_status_diff_flags
650 .Pq Vt str
651 Set to the arguments to pass to the
652 .Xr diff 1
653 utility when generating differences.
654 The default is
655 .Fl b u .
656 .It Va security_status_chksetuid_enable
657 .Pq Vt bool
658 Set to
659 .Dq Li YES
660 to compare the modes and modification times of setuid executables with
661 the previous day's values.
662 .It Va security_status_chksetuid_period
663 .Pq Vt str
664 Set to either
665 .Dq Li daily ,
666 .Dq Li weekly ,
667 .Dq Li monthly
668 or
669 .Dq Li NO .
670 .It Va security_status_neggrpperm_enable
671 .Pq Vt bool
672 Set to
673 .Dq Li YES
674 to check for files where the group of a file has less permissions than
675 the world at large.
676 When users are in more than 14 supplemental groups these negative
677 permissions may not be enforced via NFS shares.
678 .It Va security_status_neggrpperm_period
679 .Pq Vt str
680 Set to either
681 .Dq Li daily ,
682 .Dq Li weekly ,
683 .Dq Li monthly
684 or
685 .Dq Li NO .
686 .It Va security_status_chkmounts_enable
687 .Pq Vt bool
688 Set to
689 .Dq Li YES
690 to check for changes mounted file systems to the previous day's values.
691 .It Va security_status_chkmounts_period
692 .Pq Vt str
693 Set to either
694 .Dq Li daily ,
695 .Dq Li weekly ,
696 .Dq Li monthly
697 or
698 .Dq Li NO .
699 .It Va security_status_nomfs
700 .Pq Vt bool
701 Set to
702 .Dq Li YES
703 if you want to ignore
704 .Xr mfs 8
705 mounts when comparing against yesterday's file system mounts in the
706 .Va security_status_chkmounts_enable
707 check.
708 .It Va security_status_chkuid0_enable
709 .Pq Vt bool
710 Set to
711 .Dq Li YES
712 to check
713 .Pa /etc/master.passwd
714 for accounts with UID 0.
715 .It Va security_status_chkuid0_period
716 .Pq Vt str
717 Set to either
718 .Dq Li daily ,
719 .Dq Li weekly ,
720 .Dq Li monthly
721 or
722 .Dq Li NO .
723 .It Va security_status_passwdless_enable
724 .Pq Vt bool
725 Set to
726 .Dq Li YES
727 to check
728 .Pa /etc/master.passwd
729 for accounts with empty passwords.
730 .It Va security_status_passwdless_period
731 .Pq Vt str
732 Set to either
733 .Dq Li daily ,
734 .Dq Li weekly ,
735 .Dq Li monthly
736 or
737 .Dq Li NO .
738 .It Va security_status_logincheck_enable
739 .Pq Vt bool
740 Set to
741 .Dq Li YES
742 to check
743 .Pa /etc/login.conf
744 ownership, see
745 .Xr login.conf 5
746 for more information.
747 .It Va security_status_logincheck_period
748 .Pq Vt str
749 Set to either
750 .Dq Li daily ,
751 .Dq Li weekly ,
752 .Dq Li monthly
753 or
754 .Dq Li NO .
755 .It Va security_status_ipfwdenied_enable
756 .Pq Vt bool
757 Set to
758 .Dq Li YES
759 to show log entries for packets denied by
760 .Xr ipfw 8
761 since yesterday's check.
762 .It Va security_status_ipfwdenied_period
763 .Pq Vt str
764 Set to either
765 .Dq Li daily ,
766 .Dq Li weekly ,
767 .Dq Li monthly
768 or
769 .Dq Li NO .
770 .It Va security_status_pfdenied_enable
771 .Pq Vt bool
772 Set to
773 .Dq Li YES
774 to show log entries for packets denied by
775 .Xr pf 4
776 since yesterday's check.
777 .It Va security_status_pfdenied_period
778 .Pq Vt str
779 Set to either
780 .Dq Li daily ,
781 .Dq Li weekly ,
782 .Dq Li monthly
783 or
784 .Dq Li NO .
785 .It Va security_status_ipfwlimit_enable
786 .Pq Vt bool
787 Set to
788 .Dq Li YES
789 to display
790 .Xr ipfw 8
791 rules that have reached their verbosity limit.
792 .It Va security_status_ipfwlimit_period
793 .Pq Vt str
794 Set to either
795 .Dq Li daily ,
796 .Dq Li weekly ,
797 .Dq Li monthly
798 or
799 .Dq Li NO .
800 .It Va security_status_ip6fwdenied_enable
801 .Pq Vt bool
802 Set to
803 .Dq Li YES
804 to show log entries for packets denied by
805 .Xr ip6fw 8
806 since yesterday's check.
807 .It Va security_status_ip6fwdenied_period
808 .Pq Vt str
809 Set to either
810 .Dq Li daily ,
811 .Dq Li weekly ,
812 .Dq Li monthly
813 or
814 .Dq Li NO .
815 .It Va security_status_ip6fwlimit_enable
816 .Pq Vt bool
817 Set to
818 .Dq Li YES
819 to display
820 .Xr ip6fw 8
821 rules that have reached their verbosity limit.
822 .It Va security_status_ip6fwlimit_period
823 .Pq Vt str
824 Set to either
825 .Dq Li daily ,
826 .Dq Li weekly ,
827 .Dq Li monthly
828 or
829 .Dq Li NO .
830 .It Va security_status_kernelmsg_enable
831 .Pq Vt bool
832 Set to
833 .Dq Li YES
834 to show new
835 .Xr dmesg 8
836 entries since yesterday's check.
837 .It Va security_status_kernelmsg_period
838 .Pq Vt str
839 Set to either
840 .Dq Li daily ,
841 .Dq Li weekly ,
842 .Dq Li monthly
843 or
844 .Dq Li NO .
845 .It Va security_status_loginfail_enable
846 .Pq Vt bool
847 Set to
848 .Dq Li YES
849 to display failed logins from
850 .Pa /var/log/messages
851 in the previous day.
852 .It Va security_status_loginfail_period
853 .Pq Vt str
854 Set to either
855 .Dq Li daily ,
856 .Dq Li weekly ,
857 .Dq Li monthly
858 or
859 .Dq Li NO .
860 .It Va security_status_tcpwrap_enable
861 .Pq Vt bool
862 Set to
863 .Dq Li YES
864 to display connections denied by tcpwrappers (see
865 .Xr hosts_access 5 )
866 from
867 .Pa /var/log/messages
868 during the previous day.
869 .It Va security_status_tcpwrap_period
870 .Pq Vt str
871 Set to either
872 .Dq Li daily ,
873 .Dq Li weekly ,
874 .Dq Li monthly
875 or
876 .Dq Li NO .
877 .El
878 .Sh FILES
879 .Bl -tag -width ".Pa /etc/defaults/periodic.conf"
880 .It Pa /etc/defaults/periodic.conf
881 The default configuration file.
882 This file contains all default variables and values.
883 .It Pa /etc/periodic.conf
884 The usual system specific variable override file.
885 .It Pa /etc/periodic.conf.local
886 An additional override file, useful when
887 .Pa /etc/periodic.conf
888 is shared or distributed.
889 .El
890 .Sh SEE ALSO
891 .Xr apropos 1 ,
892 .Xr calendar 1 ,
893 .Xr df 1 ,
894 .Xr diff 1 ,
895 .Xr gzip 1 ,
896 .Xr locate 1 ,
897 .Xr man 1 ,
898 .Xr msgs 1 ,
899 .Xr netstat 1 ,
900 .Xr nice 1 ,
901 .Xr HAMMER 5 ,
902 .Xr login.conf 5 ,
903 .Xr rc.conf 5 ,
904 .Xr ac 8 ,
905 .Xr chkgrp 8 ,
906 .Xr dump 8 ,
907 .Xr hammer 8 ,
908 .Xr hammer2 8 ,
909 .Xr mfs 8 ,
910 .Xr newsyslog 8 ,
911 .Xr periodic 8 ,
912 .Xr sendmail 8
913 .Sh HISTORY
914 The
915 .Nm
916 file appeared in
917 .Fx 4.1 .
918 .Sh AUTHORS
919 .An Brian Somers Aq Mt brian@Awfulhak.org