share/man/man5/periodic.conf.5

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