modules/samhain/files/common/samhainrc

   1 ##
   2 ## THIS FILE IS UNDER PUPPET CONTROL. DON'T EDIT IT HERE.
   3 ## USE: git clone git+ssh://$USER@puppet.debian.org/srv/puppet.debian.org/git/dsa-puppet.git
   4 ##
   5
   6 #####################################################################
   7 #
   8 # Configuration file template for samhain.
   9 #
  10 #####################################################################
  11 #
  12 # -- empty lines and lines starting with '#', ';' or '//' are ignored
  13 # -- boolean options can be Yes/No or True/False or 1/0
  14 # -- you can PGP clearsign this file -- samhain will check (if compiled
  15 #    with support) or otherwise ignore the signature
  16 # -- CHECK mail address
  17 #
  18 # To each log facility, you can assign a threshold severity. Only
  19 # reports with at least the threshold severity will be logged
  20 # to the respective facility (even further below).
  21 #
  22 #####################################################################
  23 #
  24 # SETUP for file system checking:
  25 #
  26 # (i)   There are several policies, each has its own section. Put files
  27 #       into the section for the appropriate policy (see below).
  28 # (ii)  Section [EventSeverity]:
  29 #       To each policy, you can assign a severity (further below).
  30 # (iii) Section [Log]:
  31 #       To each log facility, you can assign a threshold severity. Only
  32 #       reports with at least the threshold severity will be logged
  33 #       to the respective facility (even further below).
  34 #
  35 #####################################################################
  36
  37 #####################################################################
  38 #
  39 # Files are defined with: file = /absolute/path
  40 #
  41 # Directories are defined with:                  dir = /absolute/path
  42 # or with an optional recursion depth (N <= 99): dir = N/absolute/path
  43 #
  44 # Directory inodes are checked. If you only want to check files
  45 # in a directory, but not the directory inode itself, use (e.g.):
  46 #
  47 # [ReadOnly]
  48 # dir = /some/directory
  49 # [IgnoreAll]
  50 # file = /some/directory
  51 #
  52 # You can use shell-style globbing patterns, like: file = /path/foo*
  53 #
  54 ######################################################################
  55
  56 [Misc]
  57 ##
  58 ## Add or subtract tests from the policies
  59 ## - if you want to change their definitions,
  60 ##   you need to do that before using the policies
  61 ##
  62 # RedefReadOnly = (no default)
  63 # RedefAttributes=(no default)
  64 # RedefLogFiles=(no default)
  65 # RedefGrowingLogFiles=(no default)
  66 # RedefIgnoreAll=(no default)
  67 # RedefIgnoreNone=(no default)
  68 # RedefUser0=(no default)
  69 # RedefUser1=(no default)
  70
  71 [Attributes]
  72 ##
  73 ## for these files, only changes in permissions and ownership are checked
  74 ##
  75 file=/etc/mtab
  76 file=/etc/ssh_random_seed
  77 file=/etc/asound.conf
  78 file=/etc/resolv.conf
  79 file=/etc/localtime
  80 file=/etc/ioctl.save
  81 file=/etc/passwd.backup
  82 file=/etc/shadow.backup
  83 file=/etc/postfix/prng_exch
  84 file=/etc/adjtime
  85 file=/etc/lvm/.cache
  86 file=/etc/lvm/cache
  87 file=/etc/lvm/cache/.cache
  88 file=/etc/network/run/ifstate
  89 file=/var/state/samhain/samhain_file
  90 file=/etc/bind/db.debian.net
  91 file=/etc/exim4/bsmtp
  92
  93
  94 #
  95 # There are files in /etc that might change, thus changing the directory
  96 # timestamps. Put it here as 'file', and in the ReadOnly section as 'dir'.
  97 #
  98 file=/etc
  99 file=/etc/ssh
 100 file=/etc/network/run
 101 file=/etc/bind
 102
 103 # These are the directories for the files we handle with puppet
 104 file=/etc/samhain
 105 file=/etc/munin
 106 file=/etc/exim4
 107 file=/etc/apt
 108 file=/etc/apt/apt.conf.d
 109 file=/etc/apt/sources.list.d
 110 file=/etc/puppet
 111 file=/etc/default
 112 file=/etc/logrotate.d
 113 file=/etc/nagios
 114 file=/etc/cron.d
 115 file=/usr/lib/nagios/plugins
 116 file=/usr/sbin
 117
 118 [LogFiles]
 119 ##
 120 ## for these files, changes in signature, timestamps, and size are ignored
 121 ##
 122 file=/var/run/utmp
 123 file=/etc/motd
 124
 125
 126
 127 #####################################################################
 128 #
 129 # This would be the proper syntax for parts that should only be
 130 #    included for certain hosts.
 131 # You may enclose anything in a @HOSTNAME/@end bracket, as long as the
 132 #    result still has the proper syntax for the config file.
 133 # You may have any number of @HOSTNAME/@end brackets.
 134 # HOSTNAME should be the fully qualified 'official' name
 135 #    (e.g. 'nixon.watergate.com', not 'nixon'), no aliases.
 136 #    No IP number - except if samhain cannot determine the
 137 #    fully qualified hostname.
 138 #
 139 # @HOSTNAME
 140 # file=/foo/bar
 141 # @end
 142 #
 143 # These are two examples for conditional inclusion/exclusion
 144 # of a machine based on the output from 'uname -srm'
 145 #
 146 # $Linux:2.*.7:i666
 147 # file=/foo/bar3
 148 # $end
 149 #
 150 # !$Linux:2.*.7:i686
 151 # file=/foo/bar2
 152 # $end
 153 #
 154 #####################################################################
 155
 156 [GrowingLogFiles]
 157 ##
 158 ## for these files, changes in signature, timestamps, and increase in size
 159 ##                  are ignored
 160 ##
 161 file=/var/log/warn
 162 file=/var/log/messages
 163 file=/var/log/wtmp
 164 file=/var/log/faillog
 165 file=/var/log/auth.log
 166 file=/var/log/daemon.log
 167 file=/var/log/user.log
 168 file=/var/log/kern.log
 169 file=/var/log/syslog
 170
 171
 172 [IgnoreAll]
 173 ##
 174 ## for these files, no modifications are reported
 175 ##
 176 ## This file might be created or removed by the system sometimes.
 177 ##
 178 file=/etc/resolv.conf.pcmcia.save
 179 file=/etc/nologin
 180 file=/etc/postfix/debian.db
 181 file=/etc/postfix/debian
 182 file=/etc/ssh/ssh_known_hosts
 183 file=/etc/ssh/ssh-rsa-shadow
 184 file=/var/lib/misc/ssh-rsa-shadow
 185 file=/etc/.da-backup.trace
 186 file=/etc/postfix/debianhosts
 187 file=/etc/postfix/debianhosts.db
 188
 189 # We handle these files with puppet - please to not be bothering us
 190 file=/etc/samhain/samhainrc
 191 file=/etc/munin/munin-node.conf
 192 file=/etc/exim4/blacklist
 193 file=/etc/exim4/callout_users
 194 file=/etc/exim4/exim4.conf
 195 file=/etc/exim4/grey_users
 196 file=/etc/exim4/helo-check
 197 file=/etc/exim4/locals
 198 file=/etc/exim4/localusers
 199 file=/etc/exim4/rbllist
 200 file=/etc/exim4/rcpthosts
 201 file=/etc/exim4/rhsbllist
 202 file=/etc/exim4/virtualdomains
 203 file=/etc/exim4/whitelist
 204 file=/etc/exim4/local-auto.conf
 205 file=/etc/apt/preferences
 206 file=/etc/apt/sources.list.d/volatile.list
 207 file=/etc/apt/sources.list.d/security.list
 208 file=/etc/apt/sources.list.d/debian.org.list
 209 file=/etc/apt/sources.list.d/debian.restricted.list
 210 file=/etc/apt/sources.list.d/debian.list
 211 file=/etc/apt/sources.list.d/backports.org.list
 212 file=/etc/apt/apt.conf.d/local-recommends
 213 file=/etc/apt/apt.conf.d/local-pdiffs
 214 file=/etc/puppet/puppet.conf
 215 file=/etc/default/puppet
 216 file=/etc/logrotate.d/exim4-paniclog
 217 file=/etc/logrotate.d/exim4-base
 218 file=/usr/sbin/dsa-update-apt-status
 219 file=/usr/sbin/dsa-update-samhain-status
 220 file=/etc/nagios/nrpe_dsa.cfg
 221 file=/etc/cron.d/dsa-nagios-nrpe-config
 222 file=/usr/lib/nagios/plugins/dsa-check-packages
 223 file=/usr/lib/nagios/plugins/dsa-check-soas
 224 file=/usr/lib/nagios/plugins/dsa-check-mirrorsync
 225 file=/usr/lib/nagios/plugins/dsa-check-samhain
 226 file=/usr/lib/nagios/plugins/dsa-check-statusfile
 227 file=/usr/lib/nagios/plugins/dsa-check-dabackup-server
 228 file=/usr/lib/nagios/plugins/dsa-check-config
 229 file=/usr/lib/nagios/plugins/dsa-check-hpacucli
 230 file=/usr/lib/nagios/plugins/dsa-check-raid-mpt
 231 file=/usr/lib/nagios/plugins/dsa-check-puppet
 232 file=/usr/lib/nagios/plugins/dsa-check-running-kernel
 233 file=/usr/lib/nagios/plugins/dsa-check-raid-3ware
 234 file=/usr/lib/nagios/plugins/dsa-check-dabackup
 235 file=/usr/lib/nagios/plugins/dsa-check-raid-dac960
 236 file=/usr/lib/nagios/plugins/dsa-check-udldap-freshness
 237 file=/usr/lib/nagios/plugins/dsa-check-raid-areca
 238 file=/usr/lib/nagios/plugins/dsa-check-raid-sw
 239 file=/usr/lib/nagios/plugins/dsa-update-samhain-status
 240
 241 [IgnoreNone]
 242 ##
 243 ## for these files, all modifications (even access time) are reported
 244 ##    - you may create some interesting-looking file (like /etc/safe_passwd),
 245 ##      just to watch whether someone will access it ...
 246 ##
 247
 248 [Prelink]
 249 ##
 250 ## Use for prelinked files or directories holding them
 251 ##
 252
 253
 254 [ReadOnly]
 255 ##
 256 ## for these files, only access time is ignored
 257 ##
 258 dir=/usr/bin
 259 dir=/bin
 260 dir=/boot
 261 #
 262 # SuSE (old) has the boot init scripts in /sbin/init.d/*,
 263 # so we go 3 levels deep
 264 #
 265 dir=3/sbin
 266 dir=/usr/sbin
 267 dir=/lib
 268 dir=3/usr/lib
 269 #
 270 # RedHat and Debian have the bootinit scripts in /etc/init.d/* or /etc/rc.d/*,
 271 #        so we go 3 levels deep there too
 272 #
 273 dir=3/etc
 274
 275 # Various directories / files that may include / be SUID/SGID binaries
 276 #
 277 #
 278 file=/usr/lib/pt_chown
 279 # X11, in Debian X7 this is now a symlink
 280 #dir=/usr/X11R6/bin
 281 #dir=/usr/X11R6/lib/X11/xmcd/bin
 282 # Apache:
 283 #file=/usr/lib/apache/suexec
 284 #file=/usr/lib/apache/suexec.disabled
 285 # Extra directories:
 286 #dir=/opt/gnome/bin
 287 #dir=/opt/kde/bin
 288
 289 [User0]
 290 [User1]
 291 ## User0 and User1 are sections for files/dirs with user-definable checking
 292 ## (see the manual)
 293
 294
 295 [EventSeverity]
 296 ##
 297 ## Here you can assign severities to policy violations.
 298 ## If this severity exceeds the treshold of a log facility (see below),
 299 ## a policy violation will be logged to that facility.
 300 ##
 301 ## Severity for verification failures.
 302 ##
 303 # SeverityReadOnly=crit
 304 # SeverityLogFiles=crit
 305 # SeverityGrowingLogs=crit
 306 # SeverityIgnoreNone=crit
 307 # SeverityAttributes=crit
 308 # SeverityUser0=crit
 309 # SeverityUser1=crit
 310
 311 # Default behaviour
 312 SeverityReadOnly=crit
 313 SeverityLogFiles=crit
 314 SeverityGrowingLogs=warn
 315 SeverityIgnoreNone=crit
 316 SeverityAttributes=crit
 317
 318
 319 ##
 320 ## We have a file in IgnoreAll that might or might not be present.
 321 ## Setting the severity to 'info' prevents messages about deleted/new file.
 322 ##
 323 # SeverityIgnoreAll=crit
 324 SeverityIgnoreAll=info
 325
 326 ## Files : file access problems
 327 # SeverityFiles=crit
 328
 329 ## Dirs  : directory access problems
 330 # SeverityDirs=crit
 331
 332 ## Names : suspect (non-printable) characters in a pathname
 333 # SeverityNames=crit
 334
 335 # Default behaviour
 336 SeverityFiles=crit
 337 SeverityDirs=crit
 338 SeverityNames=warn
 339
 340
 341 [Log]
 342 ##
 343 ## Switch on/OFF log facilities and set their threshold severity
 344 ##
 345 ## Values: debug, info, notice, warn, mark, err, crit, alert, none.
 346 ## 'mark' is used for timestamps.
 347 ##
 348 ##
 349 ## Use 'none' to SWITCH OFF a log facility
 350 ##
 351 ## By default, everything equal to and above the threshold is logged.
 352 ## The specifiers '*', '!', and '=' are interpreted as
 353 ## 'all', 'all but', and 'only', respectively (like syslogd(8) does,
 354 ## at least on Linux). Examples:
 355 ## MailSeverity=*
 356 ## MailSeverity=!warn
 357 ## MailSeverity==crit
 358
 359 ## E-mail
 360 ##
 361 # MailSeverity=none
 362
 363 ## Console
 364 ##
 365 # PrintSeverity=info
 366
 367 ## Logfile
 368 ##
 369 # LogSeverity=mark
 370
 371 ## Syslog
 372 ##
 373 # SyslogSeverity=none
 374
 375 ## Remote server (yule)
 376 ##
 377 # ExportSeverity=none
 378
 379 ## External script or program
 380 ##
 381 # ExternalSeverity = none
 382
 383 ## Logging to a database
 384 ##
 385 # DatabaseSeverity = none
 386
 387 # Default behaviour
 388 MailSeverity=crit
 389 PrintSeverity=none
 390 LogSeverity=info
 391 SyslogSeverity=alert
 392 ExportSeverity=none
 393
 394
 395
 396
 397
 398 #####################################################
 399 #
 400 # Optional modules
 401 #
 402 #####################################################
 403
 404 # [SuidCheck]
 405 ##
 406 ## --- Check the filesystem for SUID/SGID binaries
 407 ##
 408
 409 ## Switch on
 410 #
 411 # SuidCheckActive = yes
 412
 413 ## Interval for check (seconds)
 414 #
 415 # SuidCheckInterval = 7200
 416
 417 ## Alternative: crontab-like schedule
 418 #
 419 # SuidCheckSchedule = NULL
 420
 421 ## Directory to exclude
 422 #
 423 # SuidCheckExclude = NULL
 424
 425 ## Limit on files per second (0 == no limit)
 426 #
 427 # SuidCheckFps = 0
 428
 429 ## Alternative: yield after every file
 430 #
 431 # SuidCheckYield = no
 432
 433 ## Severity of a detection
 434 #
 435 # SeveritySuidCheck = crit
 436
 437 ## Quarantine SUID/SGID files if found
 438 #
 439 # SuidCheckQuarantineFiles = yes
 440
 441 ## Method for Quarantining files:
 442 #  0 - Delete or truncate the file.
 443 #  1 - Remove SUID/SGID permissions from file.
 444 #  2 - Move SUID/SGID file to quarantine dir.
 445 #
 446 # SuidCheckQuarantineMethod = 0
 447
 448 ## For method 1 and 3, really delete instead of truncating
 449 #
 450 # SuidCheckQuarantineDelete = yes
 451
 452 # [Kernel]
 453 ##
 454 ## --- Check for loadable kernel module rootkits (Linux/FreeBSD only)
 455 ##
 456
 457 ## Switch on/off
 458 #
 459 KernelCheckActive = True
 460
 461 ## Check interval (seconds); btw., the check is VERY fast
 462 #
 463 # KernelCheckInterval = 300
 464
 465 ## Severity
 466 #
 467 # SeverityKernel = crit
 468
 469
 470 # [Utmp]
 471 ##
 472 ## --- Logging of login/logout events
 473 ##
 474
 475 ## Switch on/off
 476 #
 477 LoginCheckActive = True
 478
 479 ## Severity for logins, multiple logins, logouts
 480 #
 481 # SeverityLogin=info
 482 # SeverityLoginMulti=warn
 483 # SeverityLogout=info
 484
 485 ## Interval for login/logout checks
 486 #
 487 # LoginCheckInterval = 300
 488
 489
 490 # [Database]
 491 ##
 492 ## --- Logging to a relational database
 493 ##
 494
 495 ## Database name
 496 #
 497 # SetDBName = samhain
 498
 499 ## Database table
 500 #
 501 # SetDBTable = log
 502
 503 ## Database user
 504 #
 505 # SetDBUser = samhain
 506
 507 ## Database password
 508 #
 509 # SetDBPassword = (default: none)
 510
 511 ## Database host
 512 #
 513 # SetDBHost = localhost
 514
 515 ## Log the server timestamp for received messages
 516 #
 517 # SetDBServerTstamp = True
 518
 519 ## Use a persistent connection
 520 #
 521 # UsePersistent = True
 522
 523 # [External]
 524 ##
 525 ## Interface to call external scripts/programs for logging
 526 ##
 527
 528 ## The absolute path to the command
 529 ## - Each invocation of this directive will end the definition of the
 530 ##   preceding command, and start the definition of
 531 ##   an additional, new command
 532 #
 533 # OpenCommand = (no default)
 534
 535 ## Type (log or rv)
 536 ## - log for log messages, srv for messages received by the server
 537 #
 538 # SetType = log
 539
 540 ## The command (full command line) to execute
 541 #
 542 # SetCommandLine = (no default)
 543
 544 ## The environment (KEY=value; repeat for more)
 545 #
 546 # SetEnviron = TZ=(your timezone)
 547
 548 ## The TIGER192 checksum (optional)
 549 #
 550 # SetChecksum = (no default)
 551
 552 ## User who runs the command
 553 #
 554 # SetCredentials = (default: samhain process uid)
 555
 556 ## Words not allowed in message
 557 #
 558 # SetFilterNot = (none)
 559
 560 ## Words required (ALL of them)
 561 #
 562 # SetFilterAnd = (none)
 563
 564 ## Words required (at least one)
 565 #
 566 # SetFilterOr = (none)
 567
 568 ## Deadtime between consecutive calls
 569 #
 570 # SetDeadtime = 0
 571
 572 ## Add default environment (HOME, PATH, SHELL)
 573 #
 574 # SetDefault = no
 575
 576
 577 #####################################################
 578 #
 579 # Miscellaneous configuration options
 580 #
 581 #####################################################
 582
 583 [Misc]
 584
 585 ## whether to become a daemon process
 586 ## (this is not honoured on database initialisation)
 587 #
 588 # Daemon = no
 589 Daemon = yes
 590
 591 ## whether to test signature of files (init/check/none)
 592 ## - if 'none', then we have to decide this on the command line -
 593 #
 594 # ChecksumTest = none
 595 ChecksumTest=check
 596
 597 ## whether to drop linux capabilities that are not required
 598 ## - will make a root process a 'mere mortal' in many respects
 599 #
 600 # UseCaps = yes
 601
 602 ## Set nice level (-19 to 19, see 'man nice'),
 603 ## and I/O limit (kilobytes per second; 0 == off)
 604 ## to reduce load on host.
 605 #
 606 # SetNiceLevel = 0
 607 # SetIOLimit = 0
 608
 609 ## The version string to embed in file signature databases
 610 #
 611 # VersionString = NULL
 612
 613 ## Interval between time stamp messages
 614 #
 615 # SetLoopTime = 60
 616 SetLoopTime = 600
 617
 618 ## Interval between file checks
 619 #
 620 # SetFileCheckTime = 600
 621 SetFileCheckTime = 7200
 622
 623 ## Alternative: crontab-like schedule
 624 #
 625 # FileCheckScheduleOne = NULL
 626
 627 ## Alternative: crontab-like schedule(2)
 628 #
 629 # FileCheckScheduleTwo = NULL
 630
 631 ## Report only once on modified fles
 632 ## Setting this to 'FALSE' will generate a report for any policy
 633 ## violation (old and new ones) each time the daemon checks the file system.
 634 #
 635 # ReportOnlyOnce = True
 636
 637 ## Report in full detail
 638 #
 639 # ReportFullDetail = False
 640
 641 ## Report file timestamps in local time rather than GMT
 642 #
 643 # UseLocalTime = No
 644
 645 ## The console device (can also be a file or named pipe)
 646 ## - There are two console devices. Accordingly, you can use
 647 ##   this directive a second time to set the second console device.
 648 ##   If you have not defined the second device at compile time,
 649 ##   and you don't want to use it, then:
 650 ##   setting it to /dev/null is less effective than just leaving
 651 ##   it alone (setting to /dev/null will waste time by opening
 652 ##   /dev/null and writing to it)
 653 #
 654 # SetConsole = /dev/console
 655
 656 ## Activate the SysV IPC message queue
 657 #
 658 # MessageQueueActive = False
 659
 660
 661 ## If false, skip reverse lookup when connecting to a host known
 662 ## by name rather than IP address (i.e. trust the DNS)
 663 #
 664 # SetReverseLookup = True
 665
 666 ## --- E-Mail ---
 667
 668 # Only highest-level (alert) reports will be mailed immediately,
 669 # others will be queued. Here you can define, when the queue will
 670 # be flushed (Note: the queue is automatically flushed after
 671 # completing a file check).
 672 #
 673 SetMailTime = 86400
 674
 675 ## Maximum number of mails to queue
 676 #
 677 SetMailNum = 10
 678
 679 ## Recipient (max. 8)
 680 #
 681 SetMailAddress=samhain-reports@debian.org
 682
 683 ## Mail relay (IP address)
 684 #
 685 SetMailRelay = master.debian.org
 686
 687 ## Custom subject format
 688 #
 689 MailSubject = [Samhain at %H] %T: %S
 690
 691 ## --- end E-Mail ---
 692
 693 ## Path to the prelink executable
 694 #
 695 # SetPrelinkPath = /usr/sbin/prelink
 696
 697 ## TIGER192 checksum of the prelink executable
 698 #
 699 # SetPrelinkChecksum = (no default)
 700
 701
 702 ## Path to the executable. If set, will be checksummed after startup
 703 ## and before exit.
 704 #
 705 # SamhainPath = (no default)
 706
 707
 708 ## The IP address of the log server
 709 #
 710 # SetLogServer = (default: compiled-in)
 711
 712 ## The IP address of the time server
 713 #
 714 # SetTimeServer = (default: compiled-in)
 715
 716 ## Trusted Users (comma delimited list of user names)
 717 #
 718 # TrustedUser = (no default; this adds to the compiled-in list)
 719
 720 ## Path to the file signature database
 721 #
 722 # SetDatabasePath = (default: compiled-in)
 723
 724 ## Path to the log file
 725 #
 726 # SetLogfilePath = (default: compiled-in)
 727
 728 ## Path to the PID file
 729 #
 730 # SetLockPath = (default: compiled-in)
 731
 732
 733 ## The digest/checksum/hash algorithm
 734 #
 735 # DigestAlgo = TIGER192
 736
 737
 738 ## Custom format for message header.
 739 ## CAREFUL if you use XML logfile format.
 740 ##
 741 ## %S severity
 742 ## %T timestamp
 743 ## %C class
 744 ##
 745 ## %F source file
 746 ## %L source line
 747 #
 748 # MessageHeader="%S %T "
 749
 750
 751 ## Don't log path to config/database file on startup
 752 #
 753 # HideSetup = False
 754
 755 ## The syslog facility, if you log to syslog
 756 #
 757 # SyslogFacility = LOG_AUTHPRIV
 758 SyslogFacility=LOG_LOCAL2
 759
 760 ## The message authentication method
 761 ## - If you change this, you *must* change it
 762 ##   on client *and* server
 763 #
 764 # MACType = HMAC-TIGER
 765
 766
 767 ## everything below is ignored
 768 [EOF]
 769
 770 #####################################################################
 771 # This would be the proper syntax for parts that should only be
 772 #    included for certain hosts.
 773 # You may enclose anything in a @HOSTNAME/@end bracket, as long as the
 774 #    result still has the proper syntax for the config file.
 775 # You may have any number of @HOSTNAME/@end brackets.
 776 # HOSTNAME should be the fully qualified 'official' name
 777 #    (e.g. 'nixon.watergate.com', not 'nixon'), no aliases.
 778 #    No IP number - except if samhain cannot determine the
 779 #    fully qualified hostname.
 780 #
 781 # @HOSTNAME
 782 # file=/foo/bar
 783 # @end
 784 #
 785 # These are two examples for conditional inclusion/exclusion
 786 # of a machine based on the output from 'uname -srm'
 787 # $Linux:2.*.7:i666
 788 # file=/foo/bar3
 789 # $end
 790 #
 791 # !$Linux:2.*.7:i686
 792 # file=/foo/bar2
 793 # $end
 794 #
 795 #####################################################################