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 March 13, 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_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_catman_enable
 560 .Pq Vt bool
 561 Set to
 562 .Dq YES
 563 if you want to run
 564 .Pa /usr/libexec/catman.local .
 565 This script processes all out of date man pages, speeding up the
 566 .Xr man 1
 567 command at the expense of disk space.
 568 .It Va weekly_noid_enable
 569 .Pq Vt bool
 570 Set to
 571 .Dq Li YES
 572 if you want to locate orphaned files on the system.
 573 An orphaned file is one with an invalid owner or group.
 574 .It Va weekly_noid_dirs
 575 .Pq Vt str
 576 A list of directories under which orphaned files are searched for.
 577 This would usually be set to
 578 .Pa / .
 579 .It Va weekly_status_security_enable
 580 .Pq Vt bool
 581 Weekly counterpart of
 582 .Va daily_status_security_enable .
 583 .It Va weekly_status_security_inline
 584 .Pq Vt bool
 585 Weekly counterpart of
 586 .Va daily_status_security_inline .
 587 .It Va weekly_status_security_output
 588 .Pq Vt str
 589 Weekly counterpart of
 590 .Va daily_status_security_output .
 591 .It Va weekly_local
 592 .Pq Vt str
 593 Set to a list of extra scripts that should be run after all other
 594 weekly scripts.
 595 All scripts must be absolute path names.
 596 .El
 597 .Pp
 598 The following variables are used by the standard scripts that reside in
 599 .Pa /etc/periodic/monthly :
 600 .Bl -tag -offset 4n -width 2n
 601 .It Va monthly_accounting_enable
 602 .Pq Vt bool
 603 Set to
 604 .Dq Li YES
 605 if you want to do login accounting using the
 606 .Xr ac 8
 607 command.
 608 .It Va monthly_status_security_enable
 609 .Pq Vt bool
 610 Monthly counterpart of
 611 .Va daily_status_security_enable .
 612 .It Va monthly_status_security_inline
 613 .Pq Vt bool
 614 Monthly counterpart of
 615 .Va daily_status_security_inline .
 616 .It Va monthly_status_security_output
 617 .Pq Vt str
 618 Monthly counterpart of
 619 .Va daily_status_security_output .
 620 .It Va monthly_local
 621 .Pq Vt str
 622 Set to a list of extra scripts that should be run after all other
 623 monthly scripts.
 624 All scripts must be absolute path names.
 625 .El
 626 .Pp
 627 The following variables are used by the standard scripts that reside in
 628 .Pa /etc/periodic/security .
 629 Those scripts are usually run from daily
 630 .Pq Va daily_status_security_enable ,
 631 weekly
 632 .Pq Va weekly_status_security_enable ,
 633 and monthly
 634 .Pq Va monthly_status_security_enable
 635 periodic hooks.
 636 The
 637 .Va ..._period
 638 of each script can be configured as
 639 .Dq daily ,
 640 .Dq weekly ,
 641 .Dq monthly
 642 or
 643 .Dq NO .
 644 Note that when periodic security scripts are run from
 645 .Xr crontab 5 ,
 646 they will be always run unless their
 647 .Va ..._enable
 648 or
 649 .Va ..._period
 650 variable is set to
 651 .Dq NO .
 652 .Bl -tag -offset 4n -width 2n
 653 .It Va security_status_logdir
 654 .Pq Vt str
 655 The directory where the security scripts expect the system's log files.
 656 The default is
 657 .Pa /var/log .
 658 .It Va security_status_diff_flags
 659 .Pq Vt str
 660 Set to the arguments to pass to the
 661 .Xr diff 1
 662 utility when generating differences.
 663 The default is
 664 .Fl b u .
 665 .It Va security_status_chksetuid_enable
 666 .Pq Vt bool
 667 Set to
 668 .Dq Li YES
 669 to compare the modes and modification times of setuid executables with
 670 the previous day's values.
 671 .It Va security_status_chksetuid_period
 672 .Pq Vt str
 673 Set to either
 674 .Dq Li daily ,
 675 .Dq Li weekly ,
 676 .Dq Li monthly
 677 or
 678 .Dq Li NO .
 679 .It Va security_status_neggrpperm_enable
 680 .Pq Vt bool
 681 Set to
 682 .Dq Li YES
 683 to check for files where the group of a file has less permissions than
 684 the world at large.
 685 When users are in more than 14 supplemental groups these negative
 686 permissions may not be enforced via NFS shares.
 687 .It Va security_status_neggrpperm_period
 688 .Pq Vt str
 689 Set to either
 690 .Dq Li daily ,
 691 .Dq Li weekly ,
 692 .Dq Li monthly
 693 or
 694 .Dq Li NO .
 695 .It Va security_status_chkmounts_enable
 696 .Pq Vt bool
 697 Set to
 698 .Dq Li YES
 699 to check for changes mounted file systems to the previous day's values.
 700 .It Va security_status_chkmounts_period
 701 .Pq Vt str
 702 Set to either
 703 .Dq Li daily ,
 704 .Dq Li weekly ,
 705 .Dq Li monthly
 706 or
 707 .Dq Li NO .
 708 .It Va security_status_nomfs
 709 .Pq Vt bool
 710 Set to
 711 .Dq Li YES
 712 if you want to ignore
 713 .Xr mfs 8
 714 mounts when comparing against yesterday's file system mounts in the
 715 .Va security_status_chkmounts_enable
 716 check.
 717 .It Va security_status_chkuid0_enable
 718 .Pq Vt bool
 719 Set to
 720 .Dq Li YES
 721 to check
 722 .Pa /etc/master.passwd
 723 for accounts with UID 0.
 724 .It Va security_status_chkuid0_period
 725 .Pq Vt str
 726 Set to either
 727 .Dq Li daily ,
 728 .Dq Li weekly ,
 729 .Dq Li monthly
 730 or
 731 .Dq Li NO .
 732 .It Va security_status_passwdless_enable
 733 .Pq Vt bool
 734 Set to
 735 .Dq Li YES
 736 to check
 737 .Pa /etc/master.passwd
 738 for accounts with empty passwords.
 739 .It Va security_status_passwdless_period
 740 .Pq Vt str
 741 Set to either
 742 .Dq Li daily ,
 743 .Dq Li weekly ,
 744 .Dq Li monthly
 745 or
 746 .Dq Li NO .
 747 .It Va security_status_logincheck_enable
 748 .Pq Vt bool
 749 Set to
 750 .Dq Li YES
 751 to check
 752 .Pa /etc/login.conf
 753 ownership, see
 754 .Xr login.conf 5
 755 for more information.
 756 .It Va security_status_logincheck_period
 757 .Pq Vt str
 758 Set to either
 759 .Dq Li daily ,
 760 .Dq Li weekly ,
 761 .Dq Li monthly
 762 or
 763 .Dq Li NO .
 764 .It Va security_status_ipfwdenied_enable
 765 .Pq Vt bool
 766 Set to
 767 .Dq Li YES
 768 to show log entries for packets denied by
 769 .Xr ipfw 8
 770 since yesterday's check.
 771 .It Va security_status_ipfwdenied_period
 772 .Pq Vt str
 773 Set to either
 774 .Dq Li daily ,
 775 .Dq Li weekly ,
 776 .Dq Li monthly
 777 or
 778 .Dq Li NO .
 779 .It Va security_status_pfdenied_enable
 780 .Pq Vt bool
 781 Set to
 782 .Dq Li YES
 783 to show log entries for packets denied by
 784 .Xr pf 4
 785 since yesterday's check.
 786 .It Va security_status_pfdenied_period
 787 .Pq Vt str
 788 Set to either
 789 .Dq Li daily ,
 790 .Dq Li weekly ,
 791 .Dq Li monthly
 792 or
 793 .Dq Li NO .
 794 .It Va security_status_ipfwlimit_enable
 795 .Pq Vt bool
 796 Set to
 797 .Dq Li YES
 798 to display
 799 .Xr ipfw 8
 800 rules that have reached their verbosity limit.
 801 .It Va security_status_ipfwlimit_period
 802 .Pq Vt str
 803 Set to either
 804 .Dq Li daily ,
 805 .Dq Li weekly ,
 806 .Dq Li monthly
 807 or
 808 .Dq Li NO .
 809 .It Va security_status_ip6fwdenied_enable
 810 .Pq Vt bool
 811 Set to
 812 .Dq Li YES
 813 to show log entries for packets denied by
 814 .Xr ip6fw 8
 815 since yesterday's check.
 816 .It Va security_status_ip6fwdenied_period
 817 .Pq Vt str
 818 Set to either
 819 .Dq Li daily ,
 820 .Dq Li weekly ,
 821 .Dq Li monthly
 822 or
 823 .Dq Li NO .
 824 .It Va security_status_ip6fwlimit_enable
 825 .Pq Vt bool
 826 Set to
 827 .Dq Li YES
 828 to display
 829 .Xr ip6fw 8
 830 rules that have reached their verbosity limit.
 831 .It Va security_status_ip6fwlimit_period
 832 .Pq Vt str
 833 Set to either
 834 .Dq Li daily ,
 835 .Dq Li weekly ,
 836 .Dq Li monthly
 837 or
 838 .Dq Li NO .
 839 .It Va security_status_kernelmsg_enable
 840 .Pq Vt bool
 841 Set to
 842 .Dq Li YES
 843 to show new
 844 .Xr dmesg 8
 845 entries since yesterday's check.
 846 .It Va security_status_kernelmsg_period
 847 .Pq Vt str
 848 Set to either
 849 .Dq Li daily ,
 850 .Dq Li weekly ,
 851 .Dq Li monthly
 852 or
 853 .Dq Li NO .
 854 .It Va security_status_loginfail_enable
 855 .Pq Vt bool
 856 Set to
 857 .Dq Li YES
 858 to display failed logins from
 859 .Pa /var/log/messages
 860 in the previous day.
 861 .It Va security_status_loginfail_period
 862 .Pq Vt str
 863 Set to either
 864 .Dq Li daily ,
 865 .Dq Li weekly ,
 866 .Dq Li monthly
 867 or
 868 .Dq Li NO .
 869 .It Va security_status_tcpwrap_enable
 870 .Pq Vt bool
 871 Set to
 872 .Dq Li YES
 873 to display connections denied by tcpwrappers (see
 874 .Xr hosts_access 5 )
 875 from
 876 .Pa /var/log/messages
 877 during the previous day.
 878 .It Va security_status_tcpwrap_period
 879 .Pq Vt str
 880 Set to either
 881 .Dq Li daily ,
 882 .Dq Li weekly ,
 883 .Dq Li monthly
 884 or
 885 .Dq Li NO .
 886 .El
 887 .Sh FILES
 888 .Bl -tag -width ".Pa /etc/defaults/periodic.conf"
 889 .It Pa /etc/defaults/periodic.conf
 890 The default configuration file.
 891 This file contains all default variables and values.
 892 .It Pa /etc/periodic.conf
 893 The usual system specific variable override file.
 894 .It Pa /etc/periodic.conf.local
 895 An additional override file, useful when
 896 .Pa /etc/periodic.conf
 897 is shared or distributed.
 898 .El
 899 .Sh SEE ALSO
 900 .Xr apropos 1 ,
 901 .Xr calendar 1 ,
 902 .Xr df 1 ,
 903 .Xr diff 1 ,
 904 .Xr gzip 1 ,
 905 .Xr locate 1 ,
 906 .Xr man 1 ,
 907 .Xr msgs 1 ,
 908 .Xr netstat 1 ,
 909 .Xr nice 1 ,
 910 .Xr HAMMER 5 ,
 911 .Xr login.conf 5 ,
 912 .Xr rc.conf 5 ,
 913 .Xr ac 8 ,
 914 .Xr chkgrp 8 ,
 915 .Xr dump 8 ,
 916 .Xr hammer 8 ,
 917 .Xr hammer2 8 ,
 918 .Xr mfs 8 ,
 919 .Xr newsyslog 8 ,
 920 .Xr periodic 8 ,
 921 .Xr sendmail 8
 922 .Sh HISTORY
 923 The
 924 .Nm
 925 file appeared in
 926 .Fx 4.1 .
 927 .Sh AUTHORS
 928 .An Brian Somers Aq Mt brian@Awfulhak.org