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