X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fsnapshot.texi;h=656fd18372a60ffebd11d5571fe950cfd0bc3b2d;hb=338add8d10a787aafb6fd57aeae497a79a8d5855;hp=33664025a6907932dec2fe6e019e11827fb9bd34;hpb=46b07a52f9dcd3f0a298dfaf85fc0cf502d019dc;p=chaz%2Ftar diff --git a/doc/snapshot.texi b/doc/snapshot.texi index 3366402..656fd18 100644 --- a/doc/snapshot.texi +++ b/doc/snapshot.texi @@ -23,14 +23,14 @@ snapshots only in format 2. This appendix describes all three formats in detail. @enumerate 0 -@cindex format 0, snapshot file +@cindex format 0, snapshot file @cindex snapshot file, format 0 -@item +@item @samp{Format 0} snapshot file begins with a line containing a decimal number that represents a @acronym{UNIX} timestamp of the beginning of the last archivation. This line is followed by directory metadata descriptions, one per line. Each description has the -following format: +following format: @smallexample @var{nfs}@var{dev} @var{inode} @var{name} @@ -55,9 +55,9 @@ Name of the directory. Any special characters (white-space, backslashes, etc.) are quoted. @end table -@cindex format 1, snapshot file +@cindex format 1, snapshot file @cindex snapshot file, format 1 -@item +@item @samp{Format 1} snapshot file begins with a line specifying the format of the file. This line has the following structure: @@ -69,7 +69,7 @@ format of the file. This line has the following structure: where @var{tar-version} is the version number of @GNUTAR{} implementation that created this snapshot, and @var{incr-format-version} is the version number of the snapshot format -(in this case @samp{1}). +(in this case @samp{1}). Next line contains two decimal numbers, representing the time of the last backup. First number is the number of seconds, the @@ -89,11 +89,11 @@ modification time of this directory with nanosecond precision; @var{nfs}, @var{dev}, @var{inode} and @var{name} have the same meaning as with @samp{format 0}. -@cindex format 2, snapshot file +@cindex format 2, snapshot file @cindex snapshot file, format 2 -@item @FIXME{} - A snapshot file begins with a format identifier, as described for +@item + @samp{Format 2} snapshot file begins with a format identifier, as described for version 1, e.g.: @smallexample @@ -109,7 +109,7 @@ snapshot is a binary file. time of the last backup. First number is the number of seconds, the second one is the number of nanoseconds, since the beginning of the epoch. These are followed by arbitrary number of directory records. - + Each @dfn{directory record} contains a set of metadata describing a particular directory. Parts of a directory record are delimited with @acronym{ASCII} 0 characters. The following table describes each @@ -124,11 +124,11 @@ an @acronym{NFS}-mounted partition, or @samp{0} otherwise; @item mtime-nano @tab Number @tab Modification time, nanoseconds; @item dev-no @tab Number @tab Device number; @item i-no @tab Number @tab I-node number; -@item name @tab String @tab Directory name; In contrast to the -previous versions it is not quoted. +@item name @tab String @tab Directory name; in contrast to the +previous versions it is not quoted; @item contents @tab Dumpdir @tab Contents of the directory; @xref{Dumpdir}, for a description of its format. -@item +@item @end multitable Dumpdirs stored in snapshot files contain only records of types @@ -138,4 +138,3 @@ previous versions it is not quoted. @c End of snapshot.texi -