sys/man/1/derp

   1 .TH DERP 1
   2 .SH NAME
   3 derp \- directory-examining recursive compare
   4 .SH SYNOPSIS
   5 .B derp
   6 [
   7 .B -qcutDL
   8 ] [
   9 .B -p
  10 .I perms
  11 ]
  12 .I myfile
  13 .I oldfile
  14 .I yourfile
  15 .SH DESCRIPTION
  16 .I Derp
  17 recursively compares the two directories
  18 .I myfile
  19 and
  20 .I yourfile
  21 using a third common backup directory
  22 .I oldfile
  23 as reference. The changes found are printed
  24 to standard output, one per line, with the file
  25 status describing either sides actions followed
  26 by tabulator and the relative file path which might
  27 be empty in case when the changed files refers to the
  28 ones given at program arguments.
  29 .LP
  30 The possible status codes:
  31 .TP
  32 .B an
  33 File added in
  34 .I myfile
  35 .TP
  36 .B na
  37 File added in
  38 .I yourfile
  39 .TP
  40 .B aa!
  41 Both sides added different files with the
  42 same name
  43 .TP
  44 .B mn
  45 File was modified in
  46 .I myfile
  47 .TP
  48 .B nm
  49 File was modified in
  50 .I yourfile
  51 .TP
  52 .B mm!
  53 File was changed differently in
  54 .I myfile
  55 and
  56 .I yourfile
  57 .TP
  58 .B dn
  59 File was deleted in
  60 .I myfile
  61 .TP
  62 .B nd
  63 File was deleted in
  64 .I yourfile
  65 .TP
  66 .B md!
  67 File was modified in
  68 .I myfile
  69 but deleted in
  70 .I yourfile
  71 .TP
  72 .B dm!
  73 File was modified in
  74 .I yourfile
  75 but deleted in
  76 .I myfile
  77 .LP
  78 Errors are printed to standard error unless
  79 .B -q
  80 option is specified. The program is terminated
  81 when errors are encountered unless the
  82 .B -c
  83 option is given. This can be useful if files
  84 are not accessible due to file permission or
  85 media corruption.
  86 .PP
  87 The
  88 .B -u
  89 option will consider changes of file owner and group.
  90 When omitted, file ownership is ignored.
  91 .PP
  92 The
  93 .B -p
  94 option sets the octal mask
  95 .I perms
  96 of bits to check in the file permissions. The default
  97 ignores file permissions.
  98 .PP
  99 When modification times are comparable then the
 100 .B -t
 101 option can be used to quickly find changes. If specified,
 102 files are considered unchanged if the name, file size and
 103 the modification time matches. This is useful when
 104 comparing /n/dump archives on the same fileserver.
 105 .PP
 106 Files are considered the same if they are from the
 107 same mount and their
 108 .B qid
 109 (see
 110 .IR stat (5))
 111 matches. For directories, the access time is also
 112 compared. If the access time was disabled on the
 113 fileserver, then all directories need to be compared
 114 using the
 115 .B -D
 116 option.
 117 .PP
 118 Some filesystems like
 119 .IR hgfs (4)
 120 do not always return exact file size in stat, so
 121 the length check can be disabled with the
 122 .B -L
 123 option.
 124 .SH SOURCE
 125 .B /sys/src/cmd/derp.c
 126 .SH "SEE ALSO"
 127 .IR cmp (1),
 128 .IR diff (1),
 129 .IR history (1),
 130 .IR fs (4),
 131 .IR hgfs (4)
 132 .SH DIAGNOSTICS
 133 The exit status is set to 'errors' when
 134 errors were encountered.
 135 .SH HISTORY
 136 .I Derp
 137 first appeared in 9front (November, 2012).