contrib/mtree/mtree.8

   1 .\"     $NetBSD: mtree.8,v 1.69 2013/02/03 19:16:06 christos Exp $
   2 .\"
   3 .\" Copyright (c) 1989, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\" Copyright (c) 2001-2004 The NetBSD Foundation, Inc.
  31 .\" All rights reserved.
  32 .\"
  33 .\" This code is derived from software contributed to The NetBSD Foundation
  34 .\" by Luke Mewburn of Wasabi Systems.
  35 .\"
  36 .\" Redistribution and use in source and binary forms, with or without
  37 .\" modification, are permitted provided that the following conditions
  38 .\" are met:
  39 .\" 1. Redistributions of source code must retain the above copyright
  40 .\"    notice, this list of conditions and the following disclaimer.
  41 .\" 2. Redistributions in binary form must reproduce the above copyright
  42 .\"    notice, this list of conditions and the following disclaimer in the
  43 .\"    documentation and/or other materials provided with the distribution.
  44 .\"
  45 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  46 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  47 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  48 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  49 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  50 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  51 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  52 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  53 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  54 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  55 .\" POSSIBILITY OF SUCH DAMAGE.
  56 .\"
  57 .\"     @(#)mtree.8     8.2 (Berkeley) 12/11/93
  58 .\"
  59 .Dd February 3, 2013
  60 .Dt MTREE 8
  61 .Os
  62 .Sh NAME
  63 .Nm mtree
  64 .Nd map a directory hierarchy
  65 .Sh SYNOPSIS
  66 .Nm
  67 .Op Fl bCcDdejLlMnPqrStUuWx
  68 .Op Fl i | Fl m
  69 .Op Fl E Ar tags
  70 .Op Fl F Ar flavor
  71 .Op Fl f Ar spec
  72 .Op Fl I Ar tags
  73 .Op Fl K Ar keywords
  74 .Op Fl k Ar keywords
  75 .Op Fl N Ar dbdir
  76 .Op Fl O Ar onlyfile
  77 .Op Fl p Ar path
  78 .Op Fl R Ar keywords
  79 .Op Fl s Ar seed
  80 .Op Fl X Ar exclude-file
  81 .Sh DESCRIPTION
  82 The
  83 .Nm
  84 utility compares a file hierarchy against a specification,
  85 creates a specification for a file hierarchy, or modifies
  86 a specification.
  87 .Pp
  88 The default action, if not overridden by command line options,
  89 is to compare the file hierarchy rooted in the current directory
  90 against a specification read from the standard input.
  91 Messages are written to the standard output for any files whose
  92 characteristics do not match the specification, or which are
  93 missing from either the file hierarchy or the specification.
  94 .Pp
  95 The options are as follows:
  96 .Bl -tag -width Xxxexcludexfilexx
  97 .It Fl b
  98 Suppress blank lines before entering and after exiting directories.
  99 .It Fl C
 100 Convert a specification into
 101 a format that's easier to parse with various tools.
 102 The input specification is read from standard input or
 103 from the file given by
 104 .Fl f Ar spec .
 105 In the output, each file or directory is represented using a single line
 106 (which might be very long).
 107 The full path name
 108 (beginning with
 109 .Dq \&./ )
 110 is always printed as the first field;
 111 .Fl K ,
 112 .Fl k ,
 113 and
 114 .Fl R
 115 can be used to control which other keywords are printed;
 116 .Fl E
 117 and
 118 .Fl I
 119 can be used to control which files are printed;
 120 and the
 121 .Fl S
 122 option can be used to sort the output.
 123 .It Fl c
 124 Print a specification for the file hierarchy originating at
 125 the current working directory (or the directory provided by
 126 .Fl p Ar path )
 127 to the standard output.
 128 The output is in a style using relative path names.
 129 .It Fl D
 130 As per
 131 .Fl C ,
 132 except that the path name is always printed as the last field instead of
 133 the first.
 134 .It Fl d
 135 Ignore everything except directory type files.
 136 .It Fl E Ar tags
 137 Add the comma separated tags to the
 138 .Dq exclusion
 139 list.
 140 Non-directories with tags which are in the exclusion list are not printed with
 141 .Fl C
 142 and
 143 .Fl D .
 144 .It Fl e
 145 Don't complain about files that are in the file hierarchy, but not in the
 146 specification.
 147 .It Fl F Ar flavor
 148 Set the compatibility flavor of the
 149 .Nm
 150 utility.
 151 The
 152 .Ar flavor
 153 can be one of
 154 .Sy mtree ,
 155 .Sy freebsd9 ,
 156 or
 157 .Sy netbsd6 .
 158 The default is
 159 .Sy mtree .
 160 The
 161 .Sy freebsd9
 162 and
 163 .Sy netbsd6
 164 flavors attempt to preserve output compatiblity and command line option
 165 backward compatibility with
 166 .Fx 9.0
 167 and
 168 .Nx 6.0
 169 respectively.
 170 .It Fl f Ar spec
 171 Read the specification from
 172 .Ar file  ,
 173 instead of from the standard input.
 174 .Pp
 175 If this option is specified twice, the two specifications are compared
 176 to each other rather than to the file hierarchy.
 177 The specifications will be sorted like output generated using
 178 .Fl c .
 179 The output format in this case is somewhat reminiscent of
 180 .Xr comm 1 ,
 181 having "in first spec only", "in second spec only", and "different"
 182 columns, prefixed by zero, one and two TAB characters respectively.
 183 Each entry in the "different" column occupies two lines, one from each
 184 specification.
 185 .It Fl I Ar tags
 186 Add the comma separated tags to the
 187 .Dq inclusion
 188 list.
 189 Non-directories with tags which are in the inclusion list are printed with
 190 .Fl C
 191 and
 192 .Fl D .
 193 If no inclusion list is provided, the default is to display all files.
 194 .It Fl i
 195 If specified, set the schg and/or sappnd flags.
 196 .It Fl j
 197 Indent the output 4 spaces each time a directory level is descended when
 198 creating a specification with the
 199 .Fl c
 200 option.
 201 This does not affect either the /set statements or the comment before each
 202 directory.
 203 It does however affect the comment before the close of each directory.
 204 This is the equivalent of the
 205 .Fl i
 206 option in the
 207 .Fx
 208 version of
 209 .Nm .
 210 .It Fl K Ar keywords
 211 Add the specified (whitespace or comma separated) keywords to the current
 212 set of keywords.
 213 If
 214 .Ql all
 215 is specified, add all of the other keywords.
 216 .It Fl k Ar keywords
 217 Use the
 218 .Sy type
 219 keyword plus the specified (whitespace or comma separated)
 220 keywords instead of the current set of keywords.
 221 If
 222 .Ql all
 223 is specified, use all of the other keywords.
 224 If the
 225 .Sy type
 226 keyword is not desired, suppress it with
 227 .Fl R Ar type .
 228 .It Fl L
 229 Follow all symbolic links in the file hierarchy.
 230 .It Fl l
 231 Do
 232 .Dq loose
 233 permissions checks, in which more stringent permissions
 234 will match less stringent ones.
 235 For example, a file marked mode 0444
 236 will pass a check for mode 0644.
 237 .Dq Loose
 238 checks apply only to read, write and execute permissions -- in
 239 particular, if other bits like the sticky bit or suid/sgid bits are
 240 set either in the specification or the file, exact checking will be
 241 performed.
 242 This option may not be set at the same time as the
 243 .Fl U
 244 or
 245 .Fl u
 246 option.
 247 .It Fl M
 248 Permit merging of specification entries with different types,
 249 with the last entry taking precedence.
 250 .It Fl m
 251 If the schg and/or sappnd flags are specified, reset these flags.
 252 Note that this is only possible with securelevel less than 1 (i.e.,
 253 in single user mode or while the system is running in insecure
 254 mode).
 255 See
 256 .Xr init 8
 257 for information on security levels.
 258 .It Fl n
 259 Do not emit pathname comments when creating a specification.
 260 Normally
 261 a comment is emitted before each directory and before the close of that
 262 directory when using the
 263 .Fl c
 264 option.
 265 .It Fl N Ar dbdir
 266 Use the user database text file
 267 .Pa master.passwd
 268 and group database text file
 269 .Pa group
 270 from
 271 .Ar dbdir ,
 272 rather than using the results from the system's
 273 .Xr getpwnam 3
 274 and
 275 .Xr getgrnam 3
 276 (and related) library calls.
 277 .It Fl O Ar onlypaths
 278 Only include files included in this list of pathnames.
 279 .It Fl P
 280 Don't follow symbolic links in the file hierarchy, instead consider
 281 the symbolic link itself in any comparisons.
 282 This is the default.
 283 .It Fl p Ar path
 284 Use the file hierarchy rooted in
 285 .Ar path  ,
 286 instead of the current directory.
 287 .It Fl q
 288 Quiet mode.
 289 Do not complain when a
 290 .Dq missing
 291 directory cannot be created because it already exists.
 292 This occurs when the directory is a symbolic link.
 293 .It Fl R Ar keywords
 294 Remove the specified (whitespace or comma separated) keywords from the current
 295 set of keywords.
 296 If
 297 .Ql all
 298 is specified, remove all of the other keywords.
 299 .It Fl r
 300 Remove any files in the file hierarchy that are not described in the
 301 specification.
 302 .It Fl S
 303 When reading a specification into an internal data structure,
 304 sort the entries.
 305 Sorting will affect the order of the output produced by the
 306 .Fl C
 307 or
 308 .Fl D
 309 options, and will also affect the order in which
 310 missing entries are created or reported when a directory tree is checked
 311 against a specification.
 312 .Pp
 313 The sort order is the same as that used by the
 314 .Fl c
 315 option, which is that entries within the same directory are
 316 sorted in the order used by
 317 .Xr strcmp 3 ,
 318 except that entries for subdirectories sort after other entries.
 319 By default, if the
 320 .Fl S
 321 option is not used, entries within the same directory are collected
 322 together (separated from entries for other directories), but not sorted.
 323 .It Fl s Ar seed
 324 Display a single checksum to the standard error output that represents all
 325 of the files for which the keyword
 326 .Sy cksum
 327 was specified.
 328 The checksum is seeded with the specified value.
 329 .It Fl t
 330 Modify the modified time of existing files, the device type of devices, and
 331 symbolic link targets, to match the specification.
 332 .It Fl U
 333 Same as
 334 .Fl u
 335 except that a mismatch is not considered to be an error if it was corrected.
 336 .It Fl u
 337 Modify the owner, group, permissions, and flags of existing files,
 338 the device type of devices, and symbolic link targets,
 339 to match the specification.
 340 Create any missing directories, devices or symbolic links.
 341 User, group, and permissions must all be specified for missing directories
 342 to be created.
 343 Note that unless the
 344 .Fl i
 345 option is given, the schg and sappnd flags will not be set, even if
 346 specified.
 347 If
 348 .Fl m
 349 is given, these flags will be reset.
 350 Exit with a status of 0 on success,
 351 2 if the file hierarchy did not match the specification, and
 352 1 if any other error occurred.
 353 .It Fl W
 354 Don't attempt to set various file attributes such as the
 355 ownership, mode, flags, or time
 356 when creating new directories or changing existing entries.
 357 This option will be most useful when used in conjunction with
 358 .Fl U
 359 or
 360 .Fl u .
 361 .It Fl X Ar exclude-file
 362 The specified file contains
 363 .Xr fnmatch 3
 364 patterns matching files to be excluded from
 365 the specification, one to a line.
 366 If the pattern contains a
 367 .Ql \&/
 368 character, it will be matched against entire pathnames (relative to
 369 the starting directory); otherwise,
 370 it will be matched against basenames only.
 371 Comments are permitted in
 372 the
 373 .Ar exclude-list
 374 file.
 375 .It Fl x
 376 Don't descend below mount points in the file hierarchy.
 377 .El
 378 .Pp
 379 Specifications are mostly composed of
 380 .Dq keywords ,
 381 i.e. strings that
 382 that specify values relating to files.
 383 No keywords have default values, and if a keyword has no value set, no
 384 checks based on it are performed.
 385 .Pp
 386 Currently supported keywords are as follows:
 387 .Bl -tag -width sha384digestxx
 388 .It Sy cksum
 389 The checksum of the file using the default algorithm specified by
 390 the
 391 .Xr cksum 1
 392 utility.
 393 .It Sy device
 394 The device number to use for
 395 .Sy block
 396 or
 397 .Sy char
 398 file types.
 399 The argument must be one of the following forms:
 400 .Bl -tag -width 4n
 401 .It Ar format , Ns Ar major , Ns Ar minor
 402 A device with
 403 .Ar major
 404 and
 405 .Ar minor
 406 fields, for an operating system specified with
 407 .Ar format .
 408 See below for valid formats.
 409 .It Ar format , Ns Ar major , Ns Ar unit , Ns Ar subunit
 410 A device with
 411 .Ar major ,
 412 .Ar unit ,
 413 and
 414 .Ar subunit
 415 fields, for an operating system specified with
 416 .Ar format .
 417 (Currently this is only supported by the
 418 .Sy bsdos
 419 format.)
 420 .It Ar number
 421 Opaque number (as stored on the file system).
 422 .El
 423 .Pp
 424 The following values for
 425 .Ar format
 426 are recognized:
 427 .Sy native ,
 428 .Sy 386bsd ,
 429 .Sy 4bsd ,
 430 .Sy bsdos ,
 431 .Sy freebsd ,
 432 .Sy hpux ,
 433 .Sy isc ,
 434 .Sy linux ,
 435 .Sy netbsd ,
 436 .Sy osf1 ,
 437 .Sy sco ,
 438 .Sy solaris ,
 439 .Sy sunos ,
 440 .Sy svr3 ,
 441 .Sy svr4 ,
 442 and
 443 .Sy ultrix .
 444 .Pp
 445 See
 446 .Xr mknod 8
 447 for more details.
 448 .It Sy flags
 449 The file flags as a symbolic name.
 450 See
 451 .Xr chflags 1
 452 for information on these names.
 453 If no flags are to be set the string
 454 .Ql none
 455 may be used to override the current default.
 456 Note that the schg and sappnd flags are treated specially (see the
 457 .Fl i
 458 and
 459 .Fl m
 460 options).
 461 .It Sy ignore
 462 Ignore any file hierarchy below this file.
 463 .It Sy gid
 464 The file group as a numeric value.
 465 .It Sy gname
 466 The file group as a symbolic name.
 467 .It Sy link
 468 The file the symbolic link is expected to reference.
 469 .It Sy md5
 470 The
 471 .Tn MD5
 472 cryptographic message digest of the file.
 473 .It Sy md5digest
 474 Synonym for
 475 .Sy md5 .
 476 .It Sy mode
 477 The current file's permissions as a numeric (octal) or symbolic
 478 value.
 479 .It Sy nlink
 480 The number of hard links the file is expected to have.
 481 .It Sy nochange
 482 Make sure this file or directory exists but otherwise ignore all attributes.
 483 .It Sy optional
 484 The file is optional; don't complain about the file if it's
 485 not in the file hierarchy.
 486 .It Sy ripemd160digest
 487 Synonym for
 488 .Sy rmd160 .
 489 .It Sy rmd160
 490 The
 491 .Tn RMD-160
 492 cryptographic message digest of the file.
 493 .It Sy rmd160digest
 494 Synonym for
 495 .Sy rmd160 .
 496 .It Sy sha1
 497 The
 498 .Tn SHA-1
 499 cryptographic message digest of the file.
 500 .It Sy sha1digest
 501 Synonym for
 502 .Sy sha1 .
 503 .It Sy sha256
 504 The 256-bits
 505 .Tn SHA-2
 506 cryptographic message digest of the file.
 507 .It Sy sha256digest
 508 Synonym for
 509 .Sy sha256 .
 510 .It Sy sha384
 511 The 384-bits
 512 .Tn SHA-2
 513 cryptographic message digest of the file.
 514 .It Sy sha384digest
 515 Synonym for
 516 .Sy sha384 .
 517 .It Sy sha512
 518 The 512-bits
 519 .Tn SHA-2
 520 cryptographic message digest of the file.
 521 .It Sy sha512digest
 522 Synonym for
 523 .Sy sha512 .
 524 .It Sy size
 525 The size, in bytes, of the file.
 526 .It Sy tags
 527 Comma delimited tags to be matched with
 528 .Fl E
 529 and
 530 .Fl I .
 531 These may be specified without leading or trailing commas, but will be
 532 stored internally with them.
 533 .It Sy time
 534 The last modification time of the file,
 535 in second and nanoseconds.
 536 The value should include a period character and exactly nine digits after
 537 the period.
 538 .It Sy type
 539 The type of the file; may be set to any one of the following:
 540 .Pp
 541 .Bl -tag -width Sy -compact
 542 .It Sy block
 543 block special device
 544 .It Sy char
 545 character special device
 546 .It Sy dir
 547 directory
 548 .It Sy fifo
 549 fifo
 550 .It Sy file
 551 regular file
 552 .It Sy link
 553 symbolic link
 554 .It Sy socket
 555 socket
 556 .El
 557 .It Sy uid
 558 The file owner as a numeric value.
 559 .It Sy uname
 560 The file owner as a symbolic name.
 561 .El
 562 .Pp
 563 The default set of keywords are
 564 .Sy flags ,
 565 .Sy gid ,
 566 .Sy link ,
 567 .Sy mode ,
 568 .Sy nlink ,
 569 .Sy size ,
 570 .Sy time ,
 571 .Sy type ,
 572 and
 573 .Sy uid .
 574 .Pp
 575 There are four types of lines in a specification:
 576 .Bl -enum
 577 .It
 578 Set global values for a keyword.
 579 This consists of the string
 580 .Ql /set
 581 followed by whitespace, followed by sets of keyword/value
 582 pairs, separated by whitespace.
 583 Keyword/value pairs consist of a keyword, followed by an equals sign
 584 .Pq Ql = ,
 585 followed by a value, without whitespace characters.
 586 Once a keyword has been set, its value remains unchanged until either
 587 reset or unset.
 588 .It
 589 Unset global values for a keyword.
 590 This consists of the string
 591 .Ql /unset ,
 592 followed by whitespace, followed by one or more keywords,
 593 separated by whitespace.
 594 If
 595 .Ql all
 596 is specified, unset all of the keywords.
 597 .It
 598 A file specification, consisting of a path name, followed by whitespace,
 599 followed by zero or more whitespace separated keyword/value pairs.
 600 .Pp
 601 The path name may be preceded by whitespace characters.
 602 The path name may contain any of the standard path name matching
 603 characters
 604 .Po
 605 .Ql \&[ ,
 606 .Ql \&] ,
 607 .Ql \&?
 608 or
 609 .Ql *
 610 .Pc ,
 611 in which case files
 612 in the hierarchy will be associated with the first pattern that
 613 they match.
 614 .Nm
 615 uses
 616 .Xr strsvis 3
 617 (in VIS_CSTYLE format) to encode path names containing
 618 non-printable characters.
 619 Whitespace characters are encoded as
 620 .Ql \es
 621 (space),
 622 .Ql \et
 623 (tab), and
 624 .Ql \en
 625 (new line).
 626 .Ql #
 627 characters in path names are escaped by a preceding backslash
 628 .Ql \e
 629 to distinguish them from comments.
 630 .Pp
 631 Each of the keyword/value pairs consist of a keyword, followed by an
 632 equals sign
 633 .Pq Ql = ,
 634 followed by the keyword's value, without
 635 whitespace characters.
 636 These values override, without changing, the global value of the
 637 corresponding keyword.
 638 .Pp
 639 The first path name entry listed must be a directory named
 640 .Ql \&. ,
 641 as this ensures that intermixing full and relative path names will
 642 work consistently and correctly.
 643 Multiple entries for a directory named
 644 .Ql \&.
 645 are permitted; the settings for the last such entry override those
 646 of the existing entry.
 647 .Pp
 648 A path name that contains a slash
 649 .Pq Ql /
 650 that is not the first character will be treated as a full path
 651 (relative to the root of the tree).
 652 All parent directories referenced in the path name must exist.
 653 The current directory path used by relative path names will be updated
 654 appropriately.
 655 Multiple entries for the same full path are permitted if the types
 656 are the same (unless
 657 .Fl M
 658 is given, in which case the types may differ);
 659 in this case the settings for the last entry take precedence.
 660 .Pp
 661 A path name that does not contain a slash will be treated as a relative path.
 662 Specifying a directory will cause subsequent files to be searched
 663 for in that directory hierarchy.
 664 .It
 665 A line containing only the string
 666 .Ql \&..
 667 which causes the current directory path (used by relative paths)
 668 to ascend one level.
 669 .El
 670 .Pp
 671 Empty lines and lines whose first non-whitespace character is a hash
 672 mark
 673 .Pq Ql #
 674 are ignored.
 675 .Pp
 676 The
 677 .Nm
 678 utility exits with a status of 0 on success, 1 if any error occurred,
 679 and 2 if the file hierarchy did not match the specification.
 680 .Sh FILES
 681 .Bl -tag -width /etc/mtree -compact
 682 .It Pa /etc/mtree
 683 system specification directory
 684 .El
 685 .Sh EXAMPLES
 686 To detect system binaries that have been
 687 .Dq trojan horsed ,
 688 it is recommended that
 689 .Nm
 690 be run on the file systems, and a copy of the results stored on a different
 691 machine, or, at least, in encrypted form.
 692 The seed for the
 693 .Fl s
 694 option should not be an obvious value and the final checksum should not be
 695 stored on-line under any circumstances!
 696 Then, periodically,
 697 .Nm
 698 should be run against the on-line specifications and the final checksum
 699 compared with the previous value.
 700 While it is possible for the bad guys to change the on-line specifications
 701 to conform to their modified binaries, it shouldn't be possible for them
 702 to make it produce the same final checksum value.
 703 If the final checksum value changes, the off-line copies of the specification
 704 can be used to detect which of the binaries have actually been modified.
 705 .Pp
 706 The
 707 .Fl d
 708 option can be used in combination with
 709 .Fl U
 710 or
 711 .Fl u
 712 to create directory hierarchies for, for example, distributions.
 713 .Sh COMPATIBILITY
 714 The compatibility shims provided by the
 715 .Fl F
 716 option are incomplete by design.
 717 Known limitations are described below.
 718 .Pp
 719 The
 720 .Sy freebsd9
 721 flavor retains the default handling of lookup failures for the
 722 .Sy uname
 723 and
 724 .Sy group
 725 keywords by replacing them with appropriate
 726 .Sy uid
 727 and
 728 .Sy gid
 729 keywords rather than failing and reporting an error.
 730 The related
 731 .Fl w
 732 flag is a no-op rather than causing a warning to be printed and no
 733 keyword to be emitted.
 734 The latter behavior is not emulated as it is potentially dangerous in
 735 the face of /set statements.
 736 .Pp
 737 The
 738 .Sy netbsd6
 739 flavor does not replicate the historical bug that reported time as
 740 seconds.nanoseconds without zero padding nanosecond values less than
 741 100000000.
 742 .Sh SEE ALSO
 743 .Xr chflags 1 ,
 744 .Xr chgrp 1 ,
 745 .Xr chmod 1 ,
 746 .Xr cksum 1 ,
 747 .Xr stat 2 ,
 748 .Xr fnmatch 3 ,
 749 .Xr fts 3 ,
 750 .Xr strsvis 3 ,
 751 .Xr chown 8 ,
 752 .Xr mknod 8
 753 .Sh HISTORY
 754 The
 755 .Nm
 756 utility appeared in
 757 .Bx 4.3 Reno .
 758 The
 759 .Sy optional
 760 keyword appeared in
 761 .Nx 1.2 .
 762 The
 763 .Fl U
 764 option appeared in
 765 .Nx 1.3 .
 766 The
 767 .Sy flags
 768 and
 769 .Sy md5
 770 keywords, and
 771 .Fl i
 772 and
 773 .Fl m
 774 options
 775 appeared in
 776 .Nx 1.4 .
 777 The
 778 .Sy device ,
 779 .Sy rmd160 ,
 780 .Sy sha1 ,
 781 .Sy tags ,
 782 and
 783 .Sy all
 784 keywords,
 785 .Fl D ,
 786 .Fl E ,
 787 .Fl I ,
 788 .Fl L ,
 789 .Fl l ,
 790 .Fl N ,
 791 .Fl P ,
 792 .Fl R ,
 793 .Fl W ,
 794 and
 795 .Fl X
 796 options, and support for full paths appeared in
 797 .Nx 1.6 .
 798 The
 799 .Sy sha256 ,
 800 .Sy sha384 ,
 801 and
 802 .Sy sha512
 803 keywords appeared in
 804 .Nx 3.0 .
 805 The
 806 .Fl S
 807 option appeared in
 808 .Nx 6.0 .