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