Dogcows Code - chaz/tar/blob - doc/value.texi

   1 @c This is part of GNU tar manual.
   2 @c Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
   3 @c 2003, 2004 Free Software Foundation, Inc.
   4 @c See file tar.texi for copying conditions.
   5
   6 @macro GNUTAR
   7 @acronym{GNU} @command{tar}
   8 @end macro
   9
  10 @set op-absolute-names @option{--absolute-names} (@option{-P})
  11 @set ref-absolute-names @ref{absolute}
  12 @set xref-absolute-names @xref{absolute}
  13 @set pxref-absolute-names @pxref{absolute}
  14
  15 @set op-after-date @option{--after-date=@var{date}} (@option{--newer=@var{date}}, @option{-N @var{date}})
  16 @set ref-after-date @ref{after}
  17 @set xref-after-date @xref{after}
  18 @set pxref-after-date @pxref{after}
  19
  20 @set op-append @option{--append} (@option{-r})
  21 @set ref-append @ref{add}
  22 @set xref-append @xref{add}
  23 @set pxref-append @pxref{add}
  24
  25 @set op-atime-preserve @option{--atime-preserve[=METHOD]}
  26 @set op-atime-preserve-replace @option{--atime-preserve=replace}
  27 @set op-atime-preserve-system @option{--atime-preserve=system}
  28 @set ref-atime-preserve @ref{Attributes}
  29 @set xref-atime-preserve @xref{Attributes}
  30 @set pxref-atime-preserve @pxref{Attributes}
  31
  32 @set op-backup @option{--backup}
  33 @set ref-backup @ref{Backup options}
  34 @set xref-backup @xref{Backup options}
  35 @set pxref-backup @pxref{Backup options}
  36
  37 @set op-block-number @option{--block-number} (@option{-R})
  38 @set ref-block-number @ref{verbose}
  39 @set xref-block-number @xref{verbose}
  40 @set pxref-block-number @pxref{verbose}
  41
  42 @set op-blocking-factor @option{--blocking-factor=@var{512-size}} (@option{-b @var{512-size}})
  43 @set ref-blocking-factor @ref{Blocking Factor}
  44 @set xref-blocking-factor @xref{Blocking Factor}
  45 @set pxref-blocking-factor @pxref{Blocking Factor}
  46
  47 @set op-bzip2 @option{--bzip2} (@option{-j})
  48 @set ref-bzip2 @ref{gzip}
  49 @set xref-bzip2 @xref{gzip}
  50 @set pxref-bzip2 @pxref{gzip}
  51
  52 @set op-check-links @option{--check-links} (@option{-l})
  53 @set ref-check-links @ref{--check-links}
  54 @set xref-check-links @xref{--check-links}
  55 @set pxref-check-links @pxref{--check-links}
  56
  57 @set op-checkpoint @option{--checkpoint}
  58 @set ref-checkpoint @ref{verbose}
  59 @set xref-checkpoint @xref{verbose}
  60 @set pxref-checkpoint @pxref{verbose}
  61
  62 @set op-check-links @option{--check-links}
  63
  64 @set op-compare @option{--compare} (@option{--diff}, @option{-d})
  65 @set ref-compare @ref{compare}
  66 @set xref-compare @xref{compare}
  67 @set pxref-compare @pxref{compare}
  68
  69 @set op-compress @option{--compress} (@option{--uncompress}, @option{-Z})
  70 @set ref-compress @ref{gzip}
  71 @set xref-compress @xref{gzip}
  72 @set pxref-compress @pxref{gzip}
  73
  74 @set op-concatenate @option{--concatenate} (@option{--catenate}, @option{-A})
  75 @set ref-concatenate @ref{concatenate}
  76 @set xref-concatenate @xref{concatenate}
  77 @set pxref-concatenate @pxref{concatenate}
  78
  79 @set op-create @option{--create} (@option{-c})
  80 @set ref-create @ref{create}
  81 @set xref-create @xref{create}
  82 @set pxref-create @pxref{create}
  83
  84 @set op-delete @option{--delete}
  85 @set ref-delete @ref{delete}
  86 @set xref-delete @xref{delete}
  87 @set pxref-delete @pxref{delete}
  88
  89 @set op-dereference @option{--dereference} (@option{-h})
  90 @set ref-dereference @ref{dereference}
  91 @set xref-dereference @xref{dereference}
  92 @set pxref-dereference @pxref{dereference}
  93
  94 @set op-directory @option{--directory=@var{directory}} (@option{-C @var{directory}})
  95 @set ref-directory @ref{directory}
  96 @set xref-directory @xref{directory}
  97 @set pxref-directory @pxref{directory}
  98
  99 @set op-exclude @option{--exclude=@var{pattern}}
 100 @set ref-exclude @ref{exclude}
 101 @set xref-exclude @xref{exclude}
 102 @set pxref-exclude @pxref{exclude}
 103
 104 @set op-exclude-from @option{--exclude-from=@var{file-of-patterns}} (@option{-X @var{file-of-patterns}})
 105 @set ref-exclude-from @ref{exclude}
 106 @set xref-exclude-from @xref{exclude}
 107 @set pxref-exclude-from @pxref{exclude}
 108
 109 @set op-exclude-caches @option{--exclude-caches}
 110 @set ref-exclude-from @ref{exclude-caches}
 111 @set xref-exclude-from @xref{exclude-caches}
 112 @set pxref-exclude-from @pxref{exclude-caches}
 113
 114 @set op-extract @option{--extract} (@option{--get}, @option{-x})
 115 @set ref-extract @ref{extract}
 116 @set xref-extract @xref{extract}
 117 @set pxref-extract @pxref{extract}
 118
 119 @set op-file @option{--file=@var{archive-name}} (@option{-f @var{archive-name}})
 120 @set ref-file @ref{file}
 121 @set xref-file @xref{file}
 122 @set pxref-file @pxref{file}
 123
 124 @set op-files-from @option{--files-from=@var{file-of-names}} (@option{-T @var{file-of-names}})
 125 @set ref-files-from @ref{files}
 126 @set xref-files-from @xref{files}
 127 @set pxref-files-from @pxref{files}
 128
 129 @set op-force-local @option{--force-local}
 130 @set ref-force-local @ref{file}
 131 @set xref-force-local @xref{file}
 132 @set pxref-force-local @pxref{file}
 133
 134 @set op-group @option{--group=@var{group}}
 135 @set ref-group @ref{Option Summary}
 136 @set xref-group @xref{Option Summary}
 137 @set pxref-group @pxref{Option Summary}
 138
 139 @set op-gzip @option{--gzip} (@option{--gunzip}, @option{--ungzip}, @option{-z})
 140 @set ref-gzip @ref{gzip}
 141 @set xref-gzip @xref{gzip}
 142 @set pxref-gzip @pxref{gzip}
 143
 144 @set op-help @option{--help}
 145 @set ref-help @ref{help}
 146 @set xref-help @xref{help}
 147 @set pxref-help @pxref{help}
 148
 149 @set op-ignore-failed-read @option{--ignore-failed-read}
 150 @set ref-ignore-failed-read @ref{create options}
 151 @set xref-ignore-failed-read @xref{create options}
 152 @set pxref-ignore-failed-read @pxref{create options}
 153
 154 @set op-ignore-zeros @option{--ignore-zeros} (@option{-i})
 155 @set ref-ignore-zeros @ref{Reading}
 156 @set xref-ignore-zeros @xref{Reading}
 157 @set pxref-ignore-zeros @pxref{Reading}
 158
 159 @set op-incremental @option{--incremental} (@option{-G})
 160 @set ref-incremental @ref{Incremental Dumps}
 161 @set xref-incremental @xref{Incremental Dumps}
 162 @set pxref-incremental @pxref{Incremental Dumps}
 163
 164 @set op-info-script @option{--info-script=@var{script-name}} (@option{--new-volume-script=@var{script-name}}, @option{-F @var{script-name}})
 165 @set ref-info-script @ref{Multi-Volume Archives}
 166 @set xref-info-script @xref{Multi-Volume Archives}
 167 @set pxref-info-script @pxref{Multi-Volume Archives}
 168
 169 @set op-interactive @option{--interactive} (@option{-w})
 170 @set ref-interactive @ref{interactive}
 171 @set xref-interactive @xref{interactive}
 172 @set pxref-interactive @pxref{interactive}
 173
 174 @set op-keep-old-files @option{--keep-old-files} (@option{-k})
 175 @set ref-keep-old-files @ref{Keep Old Files}
 176 @set xref-keep-old-files @xref{Keep Old Files}
 177 @set pxref-keep-old-files @pxref{Keep Old Files}
 178
 179 @set op-keep-newer-files @option{--keep-old-files}
 180 @set ref-keep-newer-files @ref{Keep Newer Files}
 181 @set xref-keep-newer-files @xref{Keep Newer Files}
 182 @set pxref-keep-newer-files @pxref{Keep Newer Files}
 183
 184 @set op-label @option{--label=@var{archive-label}} (@option{-V @var{archive-label}})
 185 @set ref-label @ref{label}
 186 @set xref-label @xref{label}
 187 @set pxref-label @pxref{label}
 188
 189 @set op-list @option{--list} (@option{-t})
 190 @set ref-list @ref{list}
 191 @set xref-list @xref{list}
 192 @set pxref-list @pxref{list}
 193
 194 @set op-listed-incremental @option{--listed-incremental=@var{snapshot-file}} (@option{-g @var{snapshot-file}})
 195 @c No special refs for this option, use {*ref-incremental} instead.
 196
 197 @set op-mode @option{--mode=@var{permissions}}
 198 @set ref-mode @ref{Option Summary}
 199 @set xref-mode @xref{Option Summary}
 200 @set pxref-mode @pxref{Option Summary}
 201
 202 @set op-multi-volume @option{--multi-volume} (@option{-M})
 203 @set ref-multi-volume @ref{Multi-Volume Archives}
 204 @set xref-multi-volume @xref{Multi-Volume Archives}
 205 @set pxref-multi-volume @pxref{Multi-Volume Archives}
 206
 207 @set op-newer-mtime @option{--newer-mtime=@var{date}}
 208 @set ref-newer-mtime @ref{after}
 209 @set xref-newer-mtime @xref{after}
 210 @set pxref-newer-mtime @pxref{after}
 211
 212 @set op-no-recursion @option{--no-recursion}
 213 @set ref-no-recursion @ref{recurse}
 214 @set xref-no-recursion @xref{recurse}
 215 @set pxref-no-recursion @pxref{recurse}
 216
 217 @set op-no-same-owner @option{--no-same-owner} (@option{-o})
 218 @set ref-no-same-owner @ref{Attributes}
 219 @set xref-no-same-owner @xref{Attributes}
 220 @set pxref-no-same-owner @pxref{Attributes}
 221
 222 @set op-no-same-permissions @option{--no-same-permissions}
 223 @set ref-no-same-permissions @ref{Attributes}
 224 @set xref-no-same-permissions @xref{Attributes}
 225 @set pxref-no-same-permissions @pxref{Attributes}
 226
 227 @set op-null @option{--null}
 228 @set ref-null @ref{files}
 229 @set xref-null @xref{files}
 230 @set pxref-null @pxref{files}
 231
 232 @set op-numeric-owner @option{--numeric-owner}
 233 @set ref-numeric-owner @ref{Attributes}
 234 @set xref-numeric-owner @xref{Attributes}
 235 @set pxref-numeric-owner @pxref{Attributes}
 236
 237 @set op-occurrence @option{--occurrence}
 238 @set ref-occurrence @ref{--occurrence}
 239 @set xref-occurrence @xref{--occurrence}
 240 @set pxref-occurrence @pxref{--occurrence}
 241
 242 @set op-old-archive @option{--old-archive} (@option{-o})
 243 @set ref-old-archive @ref{old}
 244 @set xref-old-archive @xref{old}
 245 @set pxref-old-archive @pxref{old}
 246
 247 @set op-one-file-system @option{--one-file-system} (@option{-l})
 248 @set ref-one-file-system @ref{one}
 249 @set xref-one-file-system @xref{one}
 250 @set pxref-one-file-system @pxref{one}
 251
 252 @set op-overwrite @option{--overwrite}
 253 @set ref-overwrite @ref{Overwrite Old Files}
 254 @set xref-overwrite @xref{Overwrite Old Files}
 255 @set pxref-overwrite @pxref{Overwrite Old Files}
 256
 257 @set op-owner @option{--owner=@var{user}}
 258 @set ref-owner @ref{Option Summary}
 259 @set xref-owner @xref{Option Summary}
 260 @set pxref-owner @pxref{Option Summary}
 261
 262 @set op-format @option{--format} (@option{-H})
 263 @set ref-format @ref{format}
 264 @set xref-format @xref{format}
 265 @set pxref-format @pxref{format}
 266
 267 @set op-format-v7 @option{--format=v7}
 268 @set op-format-gnu @option{--format=gnu}
 269 @set op-format-oldgnu @option{--format=oldgnu}
 270 @set op-format-posix @option{--format=posix}
 271 @set op-format-ustar @option{--format=ustar}
 272
 273 @set op-posix @option{--posix}
 274 @set ref-posix @ref{posix}
 275 @set xref-posix @xref{posix}
 276 @set pxref-posix @pxref{posix}
 277
 278 @set op-preserve @option{--preserve}
 279 @set ref-preserve @ref{Attributes}
 280 @set xref-preserve @xref{Attributes}
 281 @set pxref-preserve @pxref{Attributes}
 282
 283 @set op-record-size @option{--record-size=@var{size}}
 284 @set ref-record-size @ref{Blocking}
 285 @set xref-record-size @xref{Blocking}
 286 @set pxref-record-size @pxref{Blocking}
 287
 288 @set op-recursive-unlink @option{--recursive-unlink}
 289 @set ref-recursive-unlink @ref{Writing}
 290 @set xref-recursive-unlink @xref{Writing}
 291 @set pxref-recursive-unlink @pxref{Writing}
 292
 293 @set op-read-full-records @option{--read-full-records} (@option{-B})
 294 @set ref-read-full-records @ref{Blocking}
 295 @set xref-read-full-records @xref{Blocking}
 296 @set pxref-read-full-records @pxref{Blocking}
 297 @c FIXME: or should it be Reading, or Blocking Factor
 298
 299 @set op-remove-files @option{--remove-files}
 300 @set ref-remove-files @ref{Writing}
 301 @set xref-remove-files @xref{Writing}
 302 @set pxref-remove-files @pxref{Writing}
 303
 304 @set op-rmt-command @option{rmt-command=@var{command}}
 305 @set op-rsh-command @option{rsh-command=@var{command}}
 306
 307 @set op-same-order @option{--same-order} (@option{--preserve-order}, @option{-s})
 308 @set ref-same-order @ref{Scarce}
 309 @set xref-same-order @xref{Scarce}
 310 @set pxref-same-order @pxref{Scarce}
 311 @c FIXME: or should it be Reading, or Attributes?
 312
 313 @set op-same-owner @option{--same-owner}
 314 @set ref-same-owner @ref{Attributes}
 315 @set xref-same-owner @xref{Attributes}
 316 @set pxref-same-owner @pxref{Attributes}
 317
 318 @set op-same-permissions @option{--same-permissions} (@option{--preserve-permissions}, @option{-p})
 319 @set ref-same-permissions @ref{Attributes}
 320 @set xref-same-permissions @xref{Attributes}
 321 @set pxref-same-permissions @pxref{Attributes}
 322 @c FIXME: or should it be Writing?
 323
 324 @set op-show-omitted-dirs @option{--show-omitted-dirs}
 325 @set ref-show-omitted-dirs @ref{verbose}
 326 @set xref-show-omitted-dirs @xref{verbose}
 327 @set pxref-show-omitted-dirs @pxref{verbose}
 328
 329 @set op-sparse @option{--sparse} (@option{-S})
 330 @set ref-sparse @ref{sparse}
 331 @set xref-sparse @xref{sparse}
 332 @set pxref-sparse @pxref{sparse}
 333
 334 @set op-starting-file @option{--starting-file=@var{name}} (@option{-K @var{name}})
 335 @set ref-starting-file @ref{Scarce}
 336 @set xref-starting-file @xref{Scarce}
 337 @set pxref-starting-file @pxref{Scarce}
 338
 339 @set op-strip-components @option{--strip-components}
 340 @set ref-strip-components @ref{--strip-components}
 341 @set xref-strip-components @xref{--strip-components}
 342 @set pxref-strip-components @pxref{--strip-components}
 343
 344 @set op-suffix @option{--suffix=@var{suffix}}
 345 @set ref-suffix @ref{Backup options}
 346 @set xref-suffix @xref{Backup options}
 347 @set pxref-suffix @pxref{Backup options}
 348
 349 @set op-tape-length @option{--tape-length=@var{1024-size}} (@option{-L @var{1024-size}})
 350 @set ref-tape-length @ref{Using Multiple Tapes}
 351 @set xref-tape-length @xref{Using Multiple Tapes}
 352 @set pxref-tape-length @pxref{Using Multiple Tapes}
 353
 354 @set op-to-stdout @option{--to-stdout} (@option{-O})
 355 @set ref-to-stdout @ref{Writing}
 356 @set xref-to-stdout @xref{Writing}
 357 @set pxref-to-stdout @pxref{Writing}
 358
 359 @set op-totals @option{--totals}
 360 @set ref-totals @ref{verbose}
 361 @set xref-totals @xref{verbose}
 362 @set pxref-totals @pxref{verbose}
 363
 364 @set op-touch @option{--touch} (@option{-m})
 365 @set ref-touch @ref{Writing}
 366 @set xref-touch @xref{Writing}
 367 @set pxref-touch @pxref{Writing}
 368
 369 @set op-unlink-first @option{--unlink-first} (@option{-U})
 370 @set ref-unlink-first @ref{Writing}
 371 @set xref-unlink-first @xref{Writing}
 372 @set pxref-unlink-first @pxref{Writing}
 373
 374 @set op-update @option{--update} (@option{-u})
 375 @set ref-update @ref{update}
 376 @set xref-update @xref{update}
 377 @set pxref-update @pxref{update}
 378
 379 @set op-use-compress-prog @option{--use-compress-prog=@var{program}}
 380 @set ref-use-compress-prog @ref{gzip}
 381 @set xref-use-compress-prog @xref{gzip}
 382 @set pxref-use-compress-prog @pxref{gzip}
 383
 384 @set op-verbose @option{--verbose} (@option{-v})
 385 @set ref-verbose @ref{verbose}
 386 @set xref-verbose @xref{verbose}
 387 @set pxref-verbose @pxref{verbose}
 388
 389 @set op-verify @option{--verify} (@option{-W})
 390 @set ref-verify @ref{verify}
 391 @set xref-verify @xref{verify}
 392 @set pxref-verify @pxref{verify}
 393
 394 @set op-version @option{--version}
 395 @set ref-version @ref{help}
 396 @set xref-version @xref{help}
 397 @set pxref-version @pxref{help}
 398
 399 @set op-volno-file @option{--volno-file=@var{file-of-number}}
 400 @set ref-volno-file @ref{Using Multiple Tapes}
 401 @set xref-volno-file @xref{Using Multiple Tapes}
 402 @set pxref-volno-file @pxref{Using Multiple Tapes}
 403
 404 @set op-seek @option{--seek}
 405 @set ref-seek @ref{seek}
 406 @set xref-seek @xref{seek}
 407 @set pxref-seek @pxref{seek}