]> CyberLeo.Net >> Repos - FreeBSD/releng/10.0.git/blob - share/man/man5/periodic.conf.5
- Copy stable/10 (r259064) to releng/10.0 as part of the
[FreeBSD/releng/10.0.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$
27 .\"
28 .Dd May 30, 2012
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 .El
137 .Pp
138 The following variables are used by the standard scripts that reside in
139 .Pa /etc/periodic/daily :
140 .Bl -tag -offset 4n -width 2n
141 .It Va daily_clean_disks_enable
142 .Pq Vt bool
143 Set to
144 .Dq Li YES
145 if you want to remove all files matching
146 .Va daily_clean_disks_files
147 daily.
148 .It Va daily_clean_disks_files
149 .Pq Vt str
150 Set to a list of file names to match.
151 Wild cards are permitted.
152 .It Va daily_clean_disks_days
153 .Pq Vt num
154 When
155 .Va daily_clean_disks_enable
156 is set to
157 .Dq Li YES ,
158 this must also be set to the number of days old that a file's access
159 and modification times must be before it is deleted.
160 .It Va daily_clean_disks_verbose
161 .Pq Vt bool
162 Set to
163 .Dq Li YES
164 if you want the removed files to be reported in your daily output.
165 .It Va daily_clean_tmps_enable
166 .Pq Vt bool
167 Set to
168 .Dq Li YES
169 if you want to clear temporary directories daily.
170 .It Va daily_clean_tmps_dirs
171 .Pq Vt str
172 Set to the list of directories to clear if
173 .Va daily_clean_tmps_enable
174 is set to
175 .Dq Li YES .
176 .It Va daily_clean_tmps_days
177 .Pq Vt num
178 When
179 .Va daily_clean_tmps_enable
180 is set, this must also be set to the number of days old that a file's access
181 and modification times must be before it is deleted.
182 .It Va daily_clean_tmps_ignore
183 .Pq Vt str
184 Set to the list of files that should not be deleted when
185 .Va daily_clean_tmps_enable
186 is set to
187 .Dq Li YES .
188 Wild card characters are permitted.
189 .It Va daily_clean_tmps_verbose
190 .Pq Vt bool
191 Set to
192 .Dq Li YES
193 if you want the removed files to be reported in your daily output.
194 .It Va daily_clean_preserve_enable
195 .Pq Vt bool
196 Set to
197 .Dq Li YES
198 if you wish to remove old files from
199 .Pa /var/preserve .
200 .It Va daily_clean_preserve_days
201 .Pq Vt num
202 Set to the number of days that files must not have been modified before
203 they are deleted.
204 .It Va daily_clean_preserve_verbose
205 .Pq Vt bool
206 Set to
207 .Dq Li YES
208 if you want the removed files to be reported in your daily output.
209 .It Va daily_clean_msgs_enable
210 .Pq Vt bool
211 Set to
212 .Dq Li YES
213 if you wish old system messages to be purged.
214 .It Va daily_clean_msgs_days
215 .Pq Vt num
216 Set to the number of days that files must not have been modified before
217 they are deleted.
218 If this variable is left blank, the
219 .Xr msgs 1
220 default is used.
221 .It Va daily_clean_rwho_enable
222 .Pq Vt bool
223 Set to
224 .Dq Li YES
225 if you wish old files in
226 .Pa /var/who
227 to be purged.
228 .It Va daily_clean_rwho_days
229 .Pq Vt num
230 Set to the number of days that files must not have been modified before
231 they are deleted.
232 .It Va daily_clean_rwho_verbose
233 .Pq Vt bool
234 Set to
235 .Dq Li YES
236 if you want the removed files to be reported in your daily output.
237 .It Va daily_clean_hoststat_enable
238 .Pq Vt bool
239 Set to
240 .Dq Li YES
241 to run
242 .Nm sendmail Fl bH
243 to automatically purge stale entries from
244 .Xr sendmail 8 Ns 's
245 host status cache.
246 Files will be deleted using the same criteria as
247 .Xr sendmail 8
248 would normally use when determining whether to believe the cached information,
249 as configured in
250 .Pa /etc/mail/sendmail.cf .
251 .It Va daily_backup_passwd_enable
252 .Pq Vt bool
253 Set to
254 .Dq Li YES
255 if you want the
256 .Pa /etc/master.passwd
257 and
258 .Pa /etc/group
259 files backed up and reported on.
260 Reporting consists of checking both files for modifications and running
261 .Xr chkgrp 8
262 on the
263 .Pa group
264 file.
265 .It Va daily_backup_aliases_enable
266 .Pq Vt bool
267 Set to
268 .Dq Li YES
269 if you want the
270 .Pa /etc/mail/aliases
271 file backed up and modifications to be displayed in your daily output.
272 .It Va daily_calendar_enable
273 .Pq Vt bool
274 Set to
275 .Dq Li YES
276 if you want to run
277 .Nm calendar Fl a
278 daily.
279 .It Va daily_accounting_enable
280 .Pq Vt bool
281 Set to
282 .Dq Li YES
283 if you want to rotate your daily accounting files.
284 No rotations are necessary unless
285 .Va accounting_enable
286 is enabled in
287 .Xr rc.conf 5 .
288 .It Va daily_accounting_compress
289 .Pq Vt bool
290 Set to
291 .Dq Li YES
292 if you want your daily accounting files to be compressed using
293 .Xr gzip 1 .
294 .It Va daily_accounting_save
295 .Pq Vt num
296 When
297 .Va daily_accounting_enable
298 is set, this may also be set to the number of daily accounting files that are
299 to be saved.
300 The default is
301 .Dq Li 3 .
302 .It Va daily_accounting_flags
303 .Pq Vt str
304 Set to the arguments to pass to the
305 .Xr sa 8
306 utility (in addition to
307 .Fl s )
308 when
309 .Va daily_accounting_enable
310 is set to
311 .Dq Li YES .
312 The default is
313 .Fl q .
314 .It Va daily_news_expire_enable
315 .Pq Vt bool
316 Set to
317 .Dq Li YES
318 if you want to run
319 .Pa /etc/news.expire .
320 .It Va daily_status_disks_enable
321 .Pq Vt bool
322 Set to
323 .Dq Li YES
324 if you want to run
325 .Xr df 1
326 (with the arguments supplied in
327 .Va daily_status_disks_df_flags )
328 and
329 .Nm dump Fl W .
330 .It Va daily_status_disks_df_flags
331 .Pq Vt str
332 Set to the arguments for the
333 .Xr df 1
334 utility when
335 .Va daily_status_disks_enable
336 is set to
337 .Dq Li YES .
338 .It Va daily_status_zfs_enable
339 .Pq Vt bool
340 Set to
341 .Dq Li YES
342 if you want to run
343 .Nm zpool Cm status
344 on your
345 .Xr zfs 8
346 pools.
347 .It Va daily_status_zfs_zpool_list_enable
348 .Pq Vt bool
349 Set to
350 .Dq Li YES
351 if you want to run
352 .Nm zpool Cm list
353 on your
354 .Xr zfs 8
355 pools.
356 Requires
357 .Va daily_status_zfs_enable
358 to be set to
359 .Li YES .
360 .It Va daily_status_gmirror_enable
361 .Pq Vt bool
362 Set to
363 .Dq Li YES
364 if you want to run
365 .Nm gmirror Cm status
366 on your
367 .Xr gmirror 8
368 devices.
369 .It Va daily_status_graid3_enable
370 .Pq Vt bool
371 Set to
372 .Dq Li YES
373 if you want to run
374 .Nm graid3 Cm status
375 on your
376 .Xr graid3 8
377 devices.
378 .It Va daily_status_gstripe_enable
379 .Pq Vt bool
380 Set to
381 .Dq Li YES
382 if you want to run
383 .Nm gstripe Cm status
384 on your
385 .Xr gstripe 8
386 devices.
387 .It Va daily_status_gconcat_enable
388 .Pq Vt bool
389 Set to
390 .Dq Li YES
391 if you want to run
392 .Nm gconcat Cm status
393 on your
394 .Xr gconcat 8
395 devices.
396 .It Va daily_status_network_enable
397 .Pq Vt bool
398 Set to
399 .Dq Li YES
400 if you want to run
401 .Nm netstat Fl i .
402 .It Va daily_status_network_usedns
403 .Pq Vt bool
404 Set to
405 .Dq Li YES
406 if you want to run
407 .Xr netstat 1
408 without the
409 .Fl n
410 option (to do DNS lookups).
411 .It Va daily_status_rwho_enable
412 .Pq Vt bool
413 Set to
414 .Dq Li YES
415 if you want to run
416 .Xr uptime 1
417 (or
418 .Xr ruptime 1
419 if
420 .Va rwhod_enable
421 is set to
422 .Dq Li YES
423 in
424 .Pa /etc/rc.conf ) .
425 .It Va daily_status_mailq_enable
426 .Pq Vt bool
427 Set to
428 .Dq Li YES
429 if you want to run
430 .Xr mailq 1 .
431 .It Va daily_status_mailq_shorten
432 .Pq Vt bool
433 Set to
434 .Dq Li YES
435 if you want to shorten the
436 .Xr mailq 1
437 output when
438 .Va daily_status_mailq_enable
439 is set to
440 .Dq Li YES .
441 .It Va daily_status_include_submit_mailq
442 .Pq Vt bool
443 Set to
444 .Dq Li YES
445 if you also want to run
446 .Xr mailq 1
447 on the submit mail queue when
448 .Va daily_status_mailq_enable
449 is set to
450 .Dq Li YES .
451 This may not work with MTAs other than
452 .Xr sendmail 8 .
453 .It Va daily_status_security_enable
454 .Pq Vt bool
455 Set to
456 .Dq Li YES
457 if you want to run the security check.
458 The security check is another set of
459 .Xr periodic 8
460 scripts.
461 The system defaults are in
462 .Pa /etc/periodic/security .
463 Local scripts should be placed in
464 .Pa /usr/local/etc/periodic/security .
465 See the
466 .Xr periodic 8
467 manual page for more information.
468 .It Va daily_status_security_inline
469 .Pq Vt bool
470 Set to
471 .Dq Li YES
472 if you want the security check output inline.
473 The default is to either mail or log the output according to the value of
474 .Va daily_status_security_output .
475 .It Va daily_status_security_output
476 .Pq Vt str
477 Where to send the output of the security check if
478 .Va daily_status_security_inline
479 is set to
480 .Dq Li NO .
481 This variable behaves in the same way as the
482 .Va *_output
483 variables above, namely it can be set either to one or more email addresses
484 or to an absolute file name.
485 .It Va daily_status_mail_rejects_enable
486 .Pq Vt bool
487 Set to
488 .Dq Li YES
489 if you want to summarise mail rejections logged to
490 .Pa /var/log/maillog
491 for the previous day.
492 .It Va daily_status_mail_rejects_logs
493 .Pq Vt num
494 Set to the number of maillog files that should be checked
495 for yesterday's mail rejects.
496 .It Va daily_status_named_enable
497 .Pq Vt bool
498 Set to
499 .Dq Li YES
500 if you want to summarise denied zone transfers (AXFR and IXFR)
501 for the previous day.
502 .It Va daily_status_named_usedns
503 .Pq Vt bool
504 Set to
505 .Dq Li YES
506 if you want to enable reverse DNS lookups.
507 .It Va daily_status_ntpd
508 .Pq Vt bool
509 Set to
510 .Dq Li YES
511 if you want to enable NTP status check.
512 .It Va daily_queuerun_enable
513 .Pq Vt bool
514 Set to
515 .Dq Li YES
516 if you want to manually run the mail queue at least once a day.
517 .It Va daily_submit_queuerun
518 .Pq Vt bool
519 Set to
520 .Dq Li YES
521 if you also want to manually run the submit mail queue at least once a day
522 when
523 .Va daily_queuerun_enable
524 is set to
525 .Dq Li YES .
526 .It Va daily_scrub_zfs_enable
527 .Pq Vt bool
528 Set to
529 .Dq Li YES
530 if you want to run a zfs scrub periodically.
531 .It Va daily_scrub_zfs_pools
532 .Pq Vt str
533 A space separated list of names of zfs pools to scrub.
534 If the list is empty or not set, all zfs pools are scrubbed.
535 .It Va daily_scrub_zfs_default_threshold
536 .Pq Vt int
537 Number of days between a scrub if no pool-specific threshold is set.
538 If not set, the default value is 35, corresponding to 5 weeks.
539 .It Va daily_scrub_zfs_ Ns Ao Ar poolname Ac Ns Va _threshold
540 .Pq Vt int
541 The same as
542 .Va daily_scrub_zfs_default_threshold
543 but specific to the pool
544 .Ao Ar poolname Ac Ns .
545 .It Va daily_local
546 .Pq Vt str
547 Set to a list of extra scripts that should be run after all other
548 daily scripts.
549 All scripts must be absolute path names.
550 .El
551 .Pp
552 The following variables are used by the standard scripts that reside in
553 .Pa /etc/periodic/weekly :
554 .Bl -tag -offset 4n -width 2n
555 .It Va weekly_locate_enable
556 .Pq Vt bool
557 Set to
558 .Dq Li YES
559 if you want to run
560 .Pa /usr/libexec/locate.updatedb .
561 This script is run using
562 .Nm nice Fl 5
563 as user
564 .Dq Li nobody ,
565 and generates the table used by the
566 .Xr locate 1
567 command.
568 .It Va weekly_whatis_enable
569 .Pq Vt bool
570 Set to
571 .Dq Li YES
572 if you want to run
573 .Pa /usr/libexec/makewhatis.local .
574 This script regenerates the database used by the
575 .Xr apropos 1
576 command.
577 .It Va weekly_catman_enable
578 .Pq Vt bool
579 Set to
580 .Dq Li YES
581 if you want to run
582 .Pa /usr/libexec/catman.local .
583 This script processes all out of date manual pages, speeding up the
584 .Xr man 1
585 command at the expense of disk space.
586 .It Va weekly_noid_enable
587 .Pq Vt bool
588 Set to
589 .Dq Li YES
590 if you want to locate orphaned files on the system.
591 An orphaned file is one with an invalid owner or group.
592 .It Va weekly_noid_dirs
593 .Pq Vt str
594 A list of directories under which orphaned files are searched for.
595 This would usually be set to
596 .Pa / .
597 .It Va weekly_status_security_enable
598 .Pq Vt bool
599 Weekly counterpart of
600 .Va daily_status_securiy_enable .
601 .It Va weekly_status_security_inline
602 .Pq Vt bool
603 Weekly counterpart of
604 .Va daily_status_securiy_inline .
605 .It Va weekly_status_security_output
606 .Pq Vt str
607 Weekly counterpart of
608 .Va daily_status_securiy_output .
609 .It Va weekly_status_pkg_enable
610 .Pq Vt bool
611 Set to
612 .Dq Li YES
613 if you want to use
614 .Xr pkg_version 1
615 to list installed packages which are out of date.
616 .It Va pkg_version
617 .Pq Vt str
618 When
619 .Va weekly_status_pkg_enable
620 is set to
621 .Dq Li YES ,
622 this variable specifies the program that is used to determine the out of
623 date packages.
624 If unset, the
625 .Xr pkg_version 1
626 program is used.
627 As an example, this variable might be set to
628 .Dq Li portversion
629 if the
630 .Pa ports/sysutils/portupgrade
631 port has been installed.
632 .It Va pkg_version_index
633 .Pq Vt str
634 This variable specifies the
635 .Pa INDEX
636 file from
637 .Pa /usr/ports
638 that should be used by
639 .Xr pkg_version 1 .
640 Because the dependency tree may be substantially different between versions of
641 .Fx ,
642 there may be more than one
643 .Pa INDEX
644 file in
645 .Pa /usr/ports .
646 .Pp
647 Note, if the
648 .Va pkg_version
649 variable is set to
650 .Dq Li portversion ,
651 it will also be necessary to arrange that the correct
652 .Pa INDEX
653 file is specified
654 using environment variables and that
655 .Va pkg_version_index
656 is cleared in
657 .Pa /etc/periodic.conf
658 .Pq Dq Li pkg_version_index= .
659 .It Va weekly_local
660 .Pq Vt str
661 Set to a list of extra scripts that should be run after all other
662 weekly scripts.
663 All scripts must be absolute path names.
664 .El
665 .Pp
666 The following variables are used by the standard scripts that reside in
667 .Pa /etc/periodic/monthly :
668 .Bl -tag -offset 4n -width 2n
669 .It Va monthly_accounting_enable
670 .Pq Vt bool
671 Set to
672 .Dq Li YES
673 if you want to do login accounting using the
674 .Xr ac 8
675 command.
676 .It Va monthly_status_security_enable
677 .Pq Vt bool
678 Monthly counterpart of
679 .Va daily_status_securiy_enable .
680 .It Va monthly_status_security_inline
681 .Pq Vt bool
682 Monthly counterpart of
683 .Va daily_status_securiy_inline .
684 .It Va monthly_status_security_output
685 .Pq Vt str
686 Monthly counterpart of
687 .Va daily_status_securiy_output .
688 .It Va monthly_local
689 .Pq Vt str
690 Set to a list of extra scripts that should be run after all other
691 monthly scripts.
692 All scripts must be absolute path names.
693 .El
694 .Pp
695 The following variables are used by the standard scripts that reside in
696 .Pa /etc/periodic/security .
697 Those scripts are usually run from daily
698 .Pq Va daily_status_security_enable ,
699 weekly
700 .Pq Va weekly_status_security_enable ,
701 and monthly
702 .Pq Va monthly_status_security_enable
703 periodic hooks.
704 The
705 .Va ..._period
706 of each script can be configured as
707 .Dq daily ,
708 .Dq weekly ,
709 .Dq monthly
710 or
711 .Dq NO .
712 Note that when periodic security scripts are run from
713 .Xr crontab 5 ,
714 they will be always run unless their
715 .Va ..._enable
716 or
717 .Va ..._period
718 variable is set to
719 .Dq No .
720 .Bl -tag -offset 4n -width 2n
721 .It Va security_status_diff_flags
722 .Pq Vt str
723 Set to the arguments to pass to the
724 .Xr diff 1
725 utility when generating differences.
726 The default is
727 .Fl b u .
728 .It Va security_status_chksetuid_enable
729 .Pq Vt bool
730 Set to
731 .Dq Li YES
732 to compare the modes and modification times of setuid executables with
733 the previous day's values.
734 .It Va security_status_chksetuid_period
735 .Pq Vt str
736 Set to either
737 .Dq Li daily ,
738 .Dq Li weekly ,
739 .Dq Li monthly
740 or
741 .Dq Li NO .
742 .It Va security_status_chkportsum_enable
743 .Pq Vt bool
744 Set to
745 .Dq Li YES
746 to verify checksums of all installed packages against the known checksums in
747 .Pa /var/db/pkg .
748 .It Va security_status_chkportsum_period
749 .Pq Vt str
750 Set to either
751 .Dq Li daily ,
752 .Dq Li weekly ,
753 .Dq Li monthly
754 or
755 .Dq Li NO .
756 .It Va security_status_neggrpperm_enable
757 .Pq Vt bool
758 Set to
759 .Dq Li YES
760 to check for files where the group of a file has less permissions than
761 the world at large.
762 When users are in more than 14 supplemental groups these negative
763 permissions may not be enforced via NFS shares.
764 .It Va security_status_neggrpperm_period
765 .Pq Vt str
766 Set to either
767 .Dq Li daily ,
768 .Dq Li weekly ,
769 .Dq Li monthly
770 or
771 .Dq Li NO .
772 .It Va security_status_chkmounts_enable
773 .Pq Vt bool
774 Set to
775 .Dq Li YES
776 to check for changes mounted file systems to the previous day's values.
777 .It Va security_status_chkmounts_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_noamd
786 .Pq Vt bool
787 Set to
788 .Dq Li YES
789 if you want to ignore
790 .Xr amd 8
791 mounts when comparing against yesterday's file system mounts in the
792 .Va security_status_chkmounts_enable
793 check.
794 .It Va security_status_chkuid0_enable
795 .Pq Vt bool
796 Set to
797 .Dq Li YES
798 to check
799 .Pa /etc/master.passwd
800 for accounts with UID 0.
801 .It Va security_status_chkuid0_period
802 .Pq Vt str
803 Set to either
804 .Dq Li daily ,
805 .Dq Li weekly ,
806 .Dq Li monthly
807 or
808 .Dq Li NO .
809 .It Va security_status_passwdless_enable
810 .Pq Vt bool
811 Set to
812 .Dq Li YES
813 to check
814 .Pa /etc/master.passwd
815 for accounts with empty passwords.
816 .It Va security_status_passwdless_period
817 .Pq Vt str
818 Set to either
819 .Dq Li daily ,
820 .Dq Li weekly ,
821 .Dq Li monthly
822 or
823 .Dq Li NO .
824 .It Va security_status_logincheck_enable
825 .Pq Vt bool
826 Set to
827 .Dq Li YES
828 to check
829 .Pa /etc/login.conf
830 ownership, see
831 .Xr login.conf 5
832 for more information.
833 .It Va security_status_logincheck_period
834 .Pq Vt str
835 Set to either
836 .Dq Li daily ,
837 .Dq Li weekly ,
838 .Dq Li monthly
839 or
840 .Dq Li NO .
841 .It Va security_status_ipfwdenied_enable
842 .Pq Vt bool
843 Set to
844 .Dq Li YES
845 to show log entries for packets denied by
846 .Xr ipfw 8
847 since yesterday's check.
848 .It Va security_status_ipfwdenied_period
849 .Pq Vt str
850 Set to either
851 .Dq Li daily ,
852 .Dq Li weekly ,
853 .Dq Li monthly
854 or
855 .Dq Li NO .
856 .It Va security_status_ipfdenied_enable
857 .Pq Vt bool
858 Set to
859 .Dq Li YES
860 to show log entries for packets denied by
861 .Xr ipf 8
862 since yesterday's check.
863 .It Va security_status_ipfdenied_period
864 .Pq Vt str
865 Set to either
866 .Dq Li daily ,
867 .Dq Li weekly ,
868 .Dq Li monthly
869 or
870 .Dq Li NO .
871 .It Va security_status_pfdenied_enable
872 .Pq Vt bool
873 Set to
874 .Dq Li YES
875 to show log entries for packets denied by
876 .Xr pf 4
877 since yesterday's check.
878 .It Va security_status_pfdenied_period
879 .Pq Vt str
880 Set to either
881 .Dq Li daily ,
882 .Dq Li weekly ,
883 .Dq Li monthly
884 or
885 .Dq Li NO .
886 .It Va security_status_ipfwlimit_enable
887 .Pq Vt bool
888 Set to
889 .Dq Li YES
890 to display
891 .Xr ipfw 8
892 rules that have reached their verbosity limit.
893 .It Va security_status_ipfwlimit_period
894 .Pq Vt str
895 Set to either
896 .Dq Li daily ,
897 .Dq Li weekly ,
898 .Dq Li monthly
899 or
900 .Dq Li NO .
901 .It Va security_status_kernelmsg_enable
902 .Pq Vt bool
903 Set to
904 .Dq Li YES
905 to show new
906 .Xr dmesg 8
907 entries since yesterday's check.
908 .It Va security_status_kernelmsg_period
909 .Pq Vt str
910 Set to either
911 .Dq Li daily ,
912 .Dq Li weekly ,
913 .Dq Li monthly
914 or
915 .Dq Li NO .
916 .It Va security_status_loginfail_enable
917 .Pq Vt bool
918 Set to
919 .Dq Li YES
920 to display failed logins from
921 .Pa /var/log/messages
922 in the previous day.
923 .It Va security_status_loginfail_period
924 .Pq Vt str
925 Set to either
926 .Dq Li daily ,
927 .Dq Li weekly ,
928 .Dq Li monthly
929 or
930 .Dq Li NO .
931 .It Va security_status_tcpwrap_enable
932 .Pq Vt bool
933 Set to
934 .Dq Li YES
935 to display connections denied by tcpwrappers (see
936 .Xr hosts_access 5 )
937 from
938 .Pa /var/log/messages
939 during the previous day.
940 .It Va security_status_tcpwrap_period
941 .Pq Vt str
942 Set to either
943 .Dq Li daily ,
944 .Dq Li weekly ,
945 .Dq Li monthly
946 or
947 .Dq Li NO .
948 .El
949 .Sh FILES
950 .Bl -tag -width ".Pa /etc/defaults/periodic.conf"
951 .It Pa /etc/defaults/periodic.conf
952 The default configuration file.
953 This file contains all default variables and values.
954 .It Pa /etc/periodic.conf
955 The usual system specific variable override file.
956 .It Pa /etc/periodic.conf.local
957 An additional override file, useful when
958 .Pa /etc/periodic.conf
959 is shared or distributed.
960 .El
961 .Sh SEE ALSO
962 .Xr apropos 1 ,
963 .Xr calendar 1 ,
964 .Xr df 1 ,
965 .Xr diff 1 ,
966 .Xr gzip 1 ,
967 .Xr locate 1 ,
968 .Xr man 1 ,
969 .Xr msgs 1 ,
970 .Xr netstat 1 ,
971 .Xr nice 1 ,
972 .Xr pkg_version 1 ,
973 .Xr login.conf 5 ,
974 .Xr rc.conf 5 ,
975 .Xr ac 8 ,
976 .Xr chkgrp 8 ,
977 .Xr dump 8 ,
978 .Xr newsyslog 8 ,
979 .Xr periodic 8 ,
980 .Xr sendmail 8
981 .Sh HISTORY
982 The
983 .Nm
984 file appeared in
985 .Fx 4.1 .
986 .Sh AUTHORS
987 .An Brian Somers Aq brian@Awfulhak.org