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