mirrors/tar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix description of the CACHEDIR.TAG file.

Browse Source
This commit is contained in:
Sergey Poznyakoff
2024-01-15 22:26:06 +02:00
parent f622c07108
commit 7b65ae35ab
2 changed files with 22 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
doc/tar.1
View File

@@ -13,7 +13,7 @@
.\" .\"
.\" You should have received a copy of the GNU General Public License .\" You should have received a copy of the GNU General Public License
.\" along with this program. If not, see <http://www.gnu.org/licenses/>. .\" along with this program. If not, see <http://www.gnu.org/licenses/>.
.TH TAR 1 "July 11, 2022" "TAR" "GNU TAR Manual" .TH TAR 1 "January 15, 2024" "TAR" "GNU TAR Manual"
.SH NAME .SH NAME
tar \- an archiving utility tar \- an archiving utility
.SH SYNOPSIS .SH SYNOPSIS
@@ -876,7 +876,14 @@ Exclude backup and lock files.
.TP .TP
\fB\-\-exclude\-caches\fR \fB\-\-exclude\-caches\fR
Exclude contents of directories containing file \fBCACHEDIR.TAG\fR, Exclude contents of directories containing file \fBCACHEDIR.TAG\fR,
except for the tag file itself. except for the tag file itself. The \fBCACHEDIR.TAG\fR file must be
a regular file whose content begins with the following 43 characters:
.IP
.RS
.EX
Signature: 8a477f597d28d172789f06886806bc55
.EE
.RE
.TP .TP
\fB\-\-exclude\-caches\-all\fR \fB\-\-exclude\-caches\-all\fR
Exclude directories containing file \fBCACHEDIR.TAG\fR and the file itself. Exclude directories containing file \fBCACHEDIR.TAG\fR and the file itself.

16
doc/tar.texi
View File

@@ -8218,9 +8218,19 @@ that match the following shell globbing patterns:
@findex exclude-caches @findex exclude-caches
When creating an archive, the @option{--exclude-caches} option family When creating an archive, the @option{--exclude-caches} option family
causes @command{tar} to exclude all directories that contain a @dfn{cache causes @command{tar} to exclude all directories that contain a @dfn{cache
directory tag}. A cache directory tag is a short file with the directory tag}. A cache directory tag is a regular file with the
well-known name @file{CACHEDIR.TAG} and having a standard header well-known name @file{CACHEDIR.TAG} whose first 43 octets
specified in @url{http://www.brynosaurus.com/cachedir/spec.html}. consist of the following ASCII header string:
@example
Signature: 8a477f597d28d172789f06886806bc55
@end example
Any remaining bytes are not relevant, in particular the signature
string does not have to be followed by an LF or CR/LF pair@footnote{The
cache directory tagging specification is set forth in
@url{https://bford.info/cachedir/}}.
Various applications write cache directory tags into directories they Various applications write cache directory tags into directories they
use to hold regenerable, non-precious data, so that such data can be use to hold regenerable, non-precious data, so that such data can be
more easily excluded from backups. more easily excluded from backups.