aa976a5170
* configure.ac: Prefer AC_CHECK_HEADERS_ONCE to AC_CHECK_HEADERS. Check for stropts.h and sys/filio.h too, for _FIOSATIME. * doc/tar.texi: Change "modification time" to "data modification time", "change time" to "status change time", and "filesystem" to "file system", so that we use terminology consistent with POSIX. Use American spacing rather than French for sentence ends. "non-dependable" -> "undependable". (Option Summary, Attributes): Explain better the pitfalls of the --atime-preserve option, and suggest read-only mounts,loopback mounts, and noatime mounts for older systems. * doc/value.texi (op-atime-preserve-system): Renamed from op-atime-preserver-system to fix a misspelling. * src/common.h (enum atime_preserve): Use lower case for enum values. * src/compare.c: Don't include utimens.h; no longer needed. (diff_file): Use set_file_atime rather than utimens; avoid closing diff_handle until after this, so that we can set the file time stamp via the file descriptor rather than via its name. * src/create.c: Don't include utimens.h; no longer needed. (dump_regular_finish): Remove. All callers now do its work inline. (dump_dir): New arg FD. All callers changed. Use fdsavedir rather than savedir. (unknown_file_error): Arg is a const pointer now. (dump_file0): 2nd arg is a const pointer now. Treat directories more like files, with respect to --atime-preserve. For example, also warn if a directory changes while we are dumping it. Prefer file descriptors to file names when retrieving/setting file attributes; this saves path-resolution time and allows us to avoid changing mtime/ctime on Solaris when restoring atime as root. Use O_DIRECTORY when opening directories, to avoid some race conditions. Do not reset atime if mtime has changed. Report an error if we cannot reset atime. First cut at adding support for --atime-preserve=system. * doc/tar.texi (Option Summary): First cut at documenting it. All other uses of --atime-preserve changed to --atime-preserve=replace. * doc/value.texi (op-atime-preserve-replace, op-atime-preserver-system): New. (op-atime-preserve): Mention METHOD. * src/common.h (atime_preserve): New enum. (atime_preserve_option): Now of the enum type rather than bool. All uses changed. * src/compare.c (diff_file): Read with O_NOATIME if asked for. * src/create.c (dump_file0): Read regular and CTG files with O_NOATIME if asked for. * src/tar.c (usage): Mention new usage. (parse_opt): Parse new usage.
408 lines
14 KiB
Plaintext
408 lines
14 KiB
Plaintext
@c This is part of GNU tar manual.
|
|
@c Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
|
|
@c 2003, 2004 Free Software Foundation, Inc.
|
|
@c See file tar.texi for copying conditions.
|
|
|
|
@macro GNUTAR
|
|
@acronym{GNU} @command{tar}
|
|
@end macro
|
|
|
|
@set op-absolute-names @option{--absolute-names} (@option{-P})
|
|
@set ref-absolute-names @ref{absolute}
|
|
@set xref-absolute-names @xref{absolute}
|
|
@set pxref-absolute-names @pxref{absolute}
|
|
|
|
@set op-after-date @option{--after-date=@var{date}} (@option{--newer=@var{date}}, @option{-N @var{date}})
|
|
@set ref-after-date @ref{after}
|
|
@set xref-after-date @xref{after}
|
|
@set pxref-after-date @pxref{after}
|
|
|
|
@set op-append @option{--append} (@option{-r})
|
|
@set ref-append @ref{add}
|
|
@set xref-append @xref{add}
|
|
@set pxref-append @pxref{add}
|
|
|
|
@set op-atime-preserve @option{--atime-preserve[=METHOD]}
|
|
@set op-atime-preserve-replace @option{--atime-preserve=replace}
|
|
@set op-atime-preserve-system @option{--atime-preserve=system}
|
|
@set ref-atime-preserve @ref{Attributes}
|
|
@set xref-atime-preserve @xref{Attributes}
|
|
@set pxref-atime-preserve @pxref{Attributes}
|
|
|
|
@set op-backup @option{--backup}
|
|
@set ref-backup @ref{Backup options}
|
|
@set xref-backup @xref{Backup options}
|
|
@set pxref-backup @pxref{Backup options}
|
|
|
|
@set op-block-number @option{--block-number} (@option{-R})
|
|
@set ref-block-number @ref{verbose}
|
|
@set xref-block-number @xref{verbose}
|
|
@set pxref-block-number @pxref{verbose}
|
|
|
|
@set op-blocking-factor @option{--blocking-factor=@var{512-size}} (@option{-b @var{512-size}})
|
|
@set ref-blocking-factor @ref{Blocking Factor}
|
|
@set xref-blocking-factor @xref{Blocking Factor}
|
|
@set pxref-blocking-factor @pxref{Blocking Factor}
|
|
|
|
@set op-bzip2 @option{--bzip2} (@option{-j})
|
|
@set ref-bzip2 @ref{gzip}
|
|
@set xref-bzip2 @xref{gzip}
|
|
@set pxref-bzip2 @pxref{gzip}
|
|
|
|
@set op-check-links @option{--check-links} (@option{-l})
|
|
@set ref-check-links @ref{--check-links}
|
|
@set xref-check-links @xref{--check-links}
|
|
@set pxref-check-links @pxref{--check-links}
|
|
|
|
@set op-checkpoint @option{--checkpoint}
|
|
@set ref-checkpoint @ref{verbose}
|
|
@set xref-checkpoint @xref{verbose}
|
|
@set pxref-checkpoint @pxref{verbose}
|
|
|
|
@set op-check-links @option{--check-links}
|
|
|
|
@set op-compare @option{--compare} (@option{--diff}, @option{-d})
|
|
@set ref-compare @ref{compare}
|
|
@set xref-compare @xref{compare}
|
|
@set pxref-compare @pxref{compare}
|
|
|
|
@set op-compress @option{--compress} (@option{--uncompress}, @option{-Z})
|
|
@set ref-compress @ref{gzip}
|
|
@set xref-compress @xref{gzip}
|
|
@set pxref-compress @pxref{gzip}
|
|
|
|
@set op-concatenate @option{--concatenate} (@option{--catenate}, @option{-A})
|
|
@set ref-concatenate @ref{concatenate}
|
|
@set xref-concatenate @xref{concatenate}
|
|
@set pxref-concatenate @pxref{concatenate}
|
|
|
|
@set op-create @option{--create} (@option{-c})
|
|
@set ref-create @ref{create}
|
|
@set xref-create @xref{create}
|
|
@set pxref-create @pxref{create}
|
|
|
|
@set op-delete @option{--delete}
|
|
@set ref-delete @ref{delete}
|
|
@set xref-delete @xref{delete}
|
|
@set pxref-delete @pxref{delete}
|
|
|
|
@set op-dereference @option{--dereference} (@option{-h})
|
|
@set ref-dereference @ref{dereference}
|
|
@set xref-dereference @xref{dereference}
|
|
@set pxref-dereference @pxref{dereference}
|
|
|
|
@set op-directory @option{--directory=@var{directory}} (@option{-C @var{directory}})
|
|
@set ref-directory @ref{directory}
|
|
@set xref-directory @xref{directory}
|
|
@set pxref-directory @pxref{directory}
|
|
|
|
@set op-exclude @option{--exclude=@var{pattern}}
|
|
@set ref-exclude @ref{exclude}
|
|
@set xref-exclude @xref{exclude}
|
|
@set pxref-exclude @pxref{exclude}
|
|
|
|
@set op-exclude-from @option{--exclude-from=@var{file-of-patterns}} (@option{-X @var{file-of-patterns}})
|
|
@set ref-exclude-from @ref{exclude}
|
|
@set xref-exclude-from @xref{exclude}
|
|
@set pxref-exclude-from @pxref{exclude}
|
|
|
|
@set op-exclude-caches @option{--exclude-caches}
|
|
@set ref-exclude-from @ref{exclude-caches}
|
|
@set xref-exclude-from @xref{exclude-caches}
|
|
@set pxref-exclude-from @pxref{exclude-caches}
|
|
|
|
@set op-extract @option{--extract} (@option{--get}, @option{-x})
|
|
@set ref-extract @ref{extract}
|
|
@set xref-extract @xref{extract}
|
|
@set pxref-extract @pxref{extract}
|
|
|
|
@set op-file @option{--file=@var{archive-name}} (@option{-f @var{archive-name}})
|
|
@set ref-file @ref{file}
|
|
@set xref-file @xref{file}
|
|
@set pxref-file @pxref{file}
|
|
|
|
@set op-files-from @option{--files-from=@var{file-of-names}} (@option{-T @var{file-of-names}})
|
|
@set ref-files-from @ref{files}
|
|
@set xref-files-from @xref{files}
|
|
@set pxref-files-from @pxref{files}
|
|
|
|
@set op-force-local @option{--force-local}
|
|
@set ref-force-local @ref{file}
|
|
@set xref-force-local @xref{file}
|
|
@set pxref-force-local @pxref{file}
|
|
|
|
@set op-group @option{--group=@var{group}}
|
|
@set ref-group @ref{Option Summary}
|
|
@set xref-group @xref{Option Summary}
|
|
@set pxref-group @pxref{Option Summary}
|
|
|
|
@set op-gzip @option{--gzip} (@option{--gunzip}, @option{--ungzip}, @option{-z})
|
|
@set ref-gzip @ref{gzip}
|
|
@set xref-gzip @xref{gzip}
|
|
@set pxref-gzip @pxref{gzip}
|
|
|
|
@set op-help @option{--help}
|
|
@set ref-help @ref{help}
|
|
@set xref-help @xref{help}
|
|
@set pxref-help @pxref{help}
|
|
|
|
@set op-ignore-failed-read @option{--ignore-failed-read}
|
|
@set ref-ignore-failed-read @ref{create options}
|
|
@set xref-ignore-failed-read @xref{create options}
|
|
@set pxref-ignore-failed-read @pxref{create options}
|
|
|
|
@set op-ignore-zeros @option{--ignore-zeros} (@option{-i})
|
|
@set ref-ignore-zeros @ref{Reading}
|
|
@set xref-ignore-zeros @xref{Reading}
|
|
@set pxref-ignore-zeros @pxref{Reading}
|
|
|
|
@set op-incremental @option{--incremental} (@option{-G})
|
|
@set ref-incremental @ref{Incremental Dumps}
|
|
@set xref-incremental @xref{Incremental Dumps}
|
|
@set pxref-incremental @pxref{Incremental Dumps}
|
|
|
|
@set op-info-script @option{--info-script=@var{script-name}} (@option{--new-volume-script=@var{script-name}}, @option{-F @var{script-name}})
|
|
@set ref-info-script @ref{Multi-Volume Archives}
|
|
@set xref-info-script @xref{Multi-Volume Archives}
|
|
@set pxref-info-script @pxref{Multi-Volume Archives}
|
|
|
|
@set op-interactive @option{--interactive} (@option{-w})
|
|
@set ref-interactive @ref{interactive}
|
|
@set xref-interactive @xref{interactive}
|
|
@set pxref-interactive @pxref{interactive}
|
|
|
|
@set op-keep-old-files @option{--keep-old-files} (@option{-k})
|
|
@set ref-keep-old-files @ref{Keep Old Files}
|
|
@set xref-keep-old-files @xref{Keep Old Files}
|
|
@set pxref-keep-old-files @pxref{Keep Old Files}
|
|
|
|
@set op-keep-newer-files @option{--keep-old-files}
|
|
@set ref-keep-newer-files @ref{Keep Newer Files}
|
|
@set xref-keep-newer-files @xref{Keep Newer Files}
|
|
@set pxref-keep-newer-files @pxref{Keep Newer Files}
|
|
|
|
@set op-label @option{--label=@var{archive-label}} (@option{-V @var{archive-label}})
|
|
@set ref-label @ref{label}
|
|
@set xref-label @xref{label}
|
|
@set pxref-label @pxref{label}
|
|
|
|
@set op-list @option{--list} (@option{-t})
|
|
@set ref-list @ref{list}
|
|
@set xref-list @xref{list}
|
|
@set pxref-list @pxref{list}
|
|
|
|
@set op-listed-incremental @option{--listed-incremental=@var{snapshot-file}} (@option{-g @var{snapshot-file}})
|
|
@c No special refs for this option, use {*ref-incremental} instead.
|
|
|
|
@set op-mode @option{--mode=@var{permissions}}
|
|
@set ref-mode @ref{Option Summary}
|
|
@set xref-mode @xref{Option Summary}
|
|
@set pxref-mode @pxref{Option Summary}
|
|
|
|
@set op-multi-volume @option{--multi-volume} (@option{-M})
|
|
@set ref-multi-volume @ref{Multi-Volume Archives}
|
|
@set xref-multi-volume @xref{Multi-Volume Archives}
|
|
@set pxref-multi-volume @pxref{Multi-Volume Archives}
|
|
|
|
@set op-newer-mtime @option{--newer-mtime=@var{date}}
|
|
@set ref-newer-mtime @ref{after}
|
|
@set xref-newer-mtime @xref{after}
|
|
@set pxref-newer-mtime @pxref{after}
|
|
|
|
@set op-no-recursion @option{--no-recursion}
|
|
@set ref-no-recursion @ref{recurse}
|
|
@set xref-no-recursion @xref{recurse}
|
|
@set pxref-no-recursion @pxref{recurse}
|
|
|
|
@set op-no-same-owner @option{--no-same-owner} (@option{-o})
|
|
@set ref-no-same-owner @ref{Attributes}
|
|
@set xref-no-same-owner @xref{Attributes}
|
|
@set pxref-no-same-owner @pxref{Attributes}
|
|
|
|
@set op-no-same-permissions @option{--no-same-permissions}
|
|
@set ref-no-same-permissions @ref{Attributes}
|
|
@set xref-no-same-permissions @xref{Attributes}
|
|
@set pxref-no-same-permissions @pxref{Attributes}
|
|
|
|
@set op-null @option{--null}
|
|
@set ref-null @ref{files}
|
|
@set xref-null @xref{files}
|
|
@set pxref-null @pxref{files}
|
|
|
|
@set op-numeric-owner @option{--numeric-owner}
|
|
@set ref-numeric-owner @ref{Attributes}
|
|
@set xref-numeric-owner @xref{Attributes}
|
|
@set pxref-numeric-owner @pxref{Attributes}
|
|
|
|
@set op-occurrence @option{--occurrence}
|
|
@set ref-occurrence @ref{--occurrence}
|
|
@set xref-occurrence @xref{--occurrence}
|
|
@set pxref-occurrence @pxref{--occurrence}
|
|
|
|
@set op-old-archive @option{--old-archive} (@option{-o})
|
|
@set ref-old-archive @ref{old}
|
|
@set xref-old-archive @xref{old}
|
|
@set pxref-old-archive @pxref{old}
|
|
|
|
@set op-one-file-system @option{--one-file-system} (@option{-l})
|
|
@set ref-one-file-system @ref{one}
|
|
@set xref-one-file-system @xref{one}
|
|
@set pxref-one-file-system @pxref{one}
|
|
|
|
@set op-overwrite @option{--overwrite}
|
|
@set ref-overwrite @ref{Overwrite Old Files}
|
|
@set xref-overwrite @xref{Overwrite Old Files}
|
|
@set pxref-overwrite @pxref{Overwrite Old Files}
|
|
|
|
@set op-owner @option{--owner=@var{user}}
|
|
@set ref-owner @ref{Option Summary}
|
|
@set xref-owner @xref{Option Summary}
|
|
@set pxref-owner @pxref{Option Summary}
|
|
|
|
@set op-format @option{--format} (@option{-H})
|
|
@set ref-format @ref{format}
|
|
@set xref-format @xref{format}
|
|
@set pxref-format @pxref{format}
|
|
|
|
@set op-format-v7 @option{--format=v7}
|
|
@set op-format-gnu @option{--format=gnu}
|
|
@set op-format-oldgnu @option{--format=oldgnu}
|
|
@set op-format-posix @option{--format=posix}
|
|
@set op-format-ustar @option{--format=ustar}
|
|
|
|
@set op-posix @option{--posix}
|
|
@set ref-posix @ref{posix}
|
|
@set xref-posix @xref{posix}
|
|
@set pxref-posix @pxref{posix}
|
|
|
|
@set op-preserve @option{--preserve}
|
|
@set ref-preserve @ref{Attributes}
|
|
@set xref-preserve @xref{Attributes}
|
|
@set pxref-preserve @pxref{Attributes}
|
|
|
|
@set op-record-size @option{--record-size=@var{size}}
|
|
@set ref-record-size @ref{Blocking}
|
|
@set xref-record-size @xref{Blocking}
|
|
@set pxref-record-size @pxref{Blocking}
|
|
|
|
@set op-recursive-unlink @option{--recursive-unlink}
|
|
@set ref-recursive-unlink @ref{Writing}
|
|
@set xref-recursive-unlink @xref{Writing}
|
|
@set pxref-recursive-unlink @pxref{Writing}
|
|
|
|
@set op-read-full-records @option{--read-full-records} (@option{-B})
|
|
@set ref-read-full-records @ref{Blocking}
|
|
@set xref-read-full-records @xref{Blocking}
|
|
@set pxref-read-full-records @pxref{Blocking}
|
|
@c FIXME: or should it be Reading, or Blocking Factor
|
|
|
|
@set op-remove-files @option{--remove-files}
|
|
@set ref-remove-files @ref{Writing}
|
|
@set xref-remove-files @xref{Writing}
|
|
@set pxref-remove-files @pxref{Writing}
|
|
|
|
@set op-rmt-command @option{rmt-command=@var{command}}
|
|
@set op-rsh-command @option{rsh-command=@var{command}}
|
|
|
|
@set op-same-order @option{--same-order} (@option{--preserve-order}, @option{-s})
|
|
@set ref-same-order @ref{Scarce}
|
|
@set xref-same-order @xref{Scarce}
|
|
@set pxref-same-order @pxref{Scarce}
|
|
@c FIXME: or should it be Reading, or Attributes?
|
|
|
|
@set op-same-owner @option{--same-owner}
|
|
@set ref-same-owner @ref{Attributes}
|
|
@set xref-same-owner @xref{Attributes}
|
|
@set pxref-same-owner @pxref{Attributes}
|
|
|
|
@set op-same-permissions @option{--same-permissions} (@option{--preserve-permissions}, @option{-p})
|
|
@set ref-same-permissions @ref{Attributes}
|
|
@set xref-same-permissions @xref{Attributes}
|
|
@set pxref-same-permissions @pxref{Attributes}
|
|
@c FIXME: or should it be Writing?
|
|
|
|
@set op-show-omitted-dirs @option{--show-omitted-dirs}
|
|
@set ref-show-omitted-dirs @ref{verbose}
|
|
@set xref-show-omitted-dirs @xref{verbose}
|
|
@set pxref-show-omitted-dirs @pxref{verbose}
|
|
|
|
@set op-sparse @option{--sparse} (@option{-S})
|
|
@set ref-sparse @ref{sparse}
|
|
@set xref-sparse @xref{sparse}
|
|
@set pxref-sparse @pxref{sparse}
|
|
|
|
@set op-starting-file @option{--starting-file=@var{name}} (@option{-K @var{name}})
|
|
@set ref-starting-file @ref{Scarce}
|
|
@set xref-starting-file @xref{Scarce}
|
|
@set pxref-starting-file @pxref{Scarce}
|
|
|
|
@set op-strip-components @option{--strip-components}
|
|
@set ref-strip-components @ref{--strip-components}
|
|
@set xref-strip-components @xref{--strip-components}
|
|
@set pxref-strip-components @pxref{--strip-components}
|
|
|
|
@set op-suffix @option{--suffix=@var{suffix}}
|
|
@set ref-suffix @ref{Backup options}
|
|
@set xref-suffix @xref{Backup options}
|
|
@set pxref-suffix @pxref{Backup options}
|
|
|
|
@set op-tape-length @option{--tape-length=@var{1024-size}} (@option{-L @var{1024-size}})
|
|
@set ref-tape-length @ref{Using Multiple Tapes}
|
|
@set xref-tape-length @xref{Using Multiple Tapes}
|
|
@set pxref-tape-length @pxref{Using Multiple Tapes}
|
|
|
|
@set op-to-stdout @option{--to-stdout} (@option{-O})
|
|
@set ref-to-stdout @ref{Writing}
|
|
@set xref-to-stdout @xref{Writing}
|
|
@set pxref-to-stdout @pxref{Writing}
|
|
|
|
@set op-totals @option{--totals}
|
|
@set ref-totals @ref{verbose}
|
|
@set xref-totals @xref{verbose}
|
|
@set pxref-totals @pxref{verbose}
|
|
|
|
@set op-touch @option{--touch} (@option{-m})
|
|
@set ref-touch @ref{Writing}
|
|
@set xref-touch @xref{Writing}
|
|
@set pxref-touch @pxref{Writing}
|
|
|
|
@set op-unlink-first @option{--unlink-first} (@option{-U})
|
|
@set ref-unlink-first @ref{Writing}
|
|
@set xref-unlink-first @xref{Writing}
|
|
@set pxref-unlink-first @pxref{Writing}
|
|
|
|
@set op-update @option{--update} (@option{-u})
|
|
@set ref-update @ref{update}
|
|
@set xref-update @xref{update}
|
|
@set pxref-update @pxref{update}
|
|
|
|
@set op-use-compress-prog @option{--use-compress-prog=@var{program}}
|
|
@set ref-use-compress-prog @ref{gzip}
|
|
@set xref-use-compress-prog @xref{gzip}
|
|
@set pxref-use-compress-prog @pxref{gzip}
|
|
|
|
@set op-verbose @option{--verbose} (@option{-v})
|
|
@set ref-verbose @ref{verbose}
|
|
@set xref-verbose @xref{verbose}
|
|
@set pxref-verbose @pxref{verbose}
|
|
|
|
@set op-verify @option{--verify} (@option{-W})
|
|
@set ref-verify @ref{verify}
|
|
@set xref-verify @xref{verify}
|
|
@set pxref-verify @pxref{verify}
|
|
|
|
@set op-version @option{--version}
|
|
@set ref-version @ref{help}
|
|
@set xref-version @xref{help}
|
|
@set pxref-version @pxref{help}
|
|
|
|
@set op-volno-file @option{--volno-file=@var{file-of-number}}
|
|
@set ref-volno-file @ref{Using Multiple Tapes}
|
|
@set xref-volno-file @xref{Using Multiple Tapes}
|
|
@set pxref-volno-file @pxref{Using Multiple Tapes}
|
|
|
|
@set op-seek @option{--seek}
|
|
@set ref-seek @ref{seek}
|
|
@set xref-seek @xref{seek}
|
|
@set pxref-seek @pxref{seek}
|