diff options
author | joerg <joerg@pkgsrc.org> | 2010-03-14 17:55:58 +0000 |
---|---|---|
committer | joerg <joerg@pkgsrc.org> | 2010-03-14 17:55:58 +0000 |
commit | 583f2d4a9e50c049aed99e04018c70d315e9725d (patch) | |
tree | b5ad7017e39e09c337dae167f4f85be0c64d28ce /archivers/libarchive/files/doc/html/mtree.5.html | |
parent | 813e1c65cfea70db0fa02bd006013a08731f470f (diff) | |
download | pkgsrc-583f2d4a9e50c049aed99e04018c70d315e9725d.tar.gz |
libarchive-2.8.2:
- Fix NULL deference for short self-extracting zip archives
- Don't dereference symlinks on Linux when reading ACLs
- Better detection of SHA2 support for old OpenSSL versions
- Fix parsing of input files for bsdtar -T
- Do not leak setup_xattr into the global namespace
- Fix build when an older libarchive is already installed
- Use O_BINARY opening files in bsdtar
- Include missing archive_crc32.h
- Correctly include iconv.h required by libxml2
Diffstat (limited to 'archivers/libarchive/files/doc/html/mtree.5.html')
-rw-r--r-- | archivers/libarchive/files/doc/html/mtree.5.html | 961 |
1 files changed, 622 insertions, 339 deletions
diff --git a/archivers/libarchive/files/doc/html/mtree.5.html b/archivers/libarchive/files/doc/html/mtree.5.html index 674edefe478..76ea8e06084 100644 --- a/archivers/libarchive/files/doc/html/mtree.5.html +++ b/archivers/libarchive/files/doc/html/mtree.5.html @@ -1,339 +1,622 @@ -<!-- Creator : groff version 1.19.2 --> -<!-- CreationDate: Thu Feb 4 20:36:37 2010 --> -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> -<html> -<head> -<meta name="generator" content="groff -Thtml, see www.gnu.org"> -<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> -<meta name="Content-Style" content="text/css"> -<style type="text/css"> - p { margin-top: 0; margin-bottom: 0; } - pre { margin-top: 0; margin-bottom: 0; } - table { margin-top: 0; margin-bottom: 0; } -</style> -<title></title> -</head> -<body> - -<hr> - - -<p valign="top">MTREE(5) FreeBSD File Formats Manual -MTREE(5)</p> - -<p style="margin-top: 1em" valign="top"><b>NAME</b></p> - -<p style="margin-left:8%;"><b>mtree</b> — format of -mtree dir hierarchy files</p> - - -<p style="margin-top: 1em" valign="top"><b>DESCRIPTION</b></p> - -<p style="margin-left:8%;">The <b>mtree</b> format is a -textual format that describes a collection of filesystem -objects. Such files are typically used to create or verify -directory hierarchies.</p> - -<p style="margin-left:8%; margin-top: 1em"><b>General -Format</b> <br> -An <b>mtree</b> file consists of a series of lines, each -providing information about a single filesystem object. -Leading whitespace is always ignored.</p> - -<p style="margin-left:8%; margin-top: 1em">When encoding -file or pathnames, any backslash character or character -outside of the 95 printable ASCII characters must be encoded -as a a backslash followed by three octal digits. When -reading mtree files, any appearance of a backslash followed -by three octal digits should be converted into the -corresponding character.</p> - -<p style="margin-left:8%; margin-top: 1em">Each line is -interpreted independently as one of the following types:</p> - -<p style="margin-top: 1em" valign="top">Signature</p> - -<p style="margin-left:26%; margin-top: 1em">The first line -of any mtree file must begin with -‘‘#mtree’’. If a file contains any -full path entries, the first line should begin with -‘‘#mtree v2.0’’, otherwise, the -first line should begin with ‘‘#mtree -v1.0’’.</p> - -<p style="margin-top: 1em" valign="top">Blank</p> - -<p style="margin-left:26%; margin-top: 1em">Blank lines are -ignored.</p> - -<p style="margin-top: 1em" valign="top">Comment</p> - -<p style="margin-left:26%; margin-top: 1em">Lines beginning -with <b>#</b> are ignored.</p> - -<p style="margin-top: 1em" valign="top">Special</p> - -<p style="margin-left:26%; margin-top: 1em">Lines beginning -with <b>/</b> are special commands that influence the -interpretation of later lines.</p> - -<p style="margin-top: 1em" valign="top">Relative</p> - -<p style="margin-left:26%; margin-top: 1em">If the first -whitespace-delimited word has no <b>/</b> characters, it is -the name of a file in the current directory. Any relative -entry that describes a directory changes the current -directory.</p> - -<p style="margin-top: 1em" valign="top">dot-dot</p> - -<p style="margin-left:26%; margin-top: 1em">As a special -case, a relative entry with the filename <i>..</i> changes -the current directory to the parent directory. Options on -dot-dot entries are always ignored.</p> - -<p style="margin-top: 1em" valign="top">Full</p> - -<p style="margin-left:26%; margin-top: 1em">If the first -whitespace-delimited word has a <b>/</b> character after the -first character, it is the pathname of a file relative to -the starting directory. There can be multiple full entries -describing the same file.</p> - -<p style="margin-left:8%; margin-top: 1em">Some tools that -process <b>mtree</b> files may require that multiple lines -describing the same file occur consecutively. It is not -permitted for the same file to be mentioned using both a -relative and a full file specification.</p> - -<p style="margin-left:8%; margin-top: 1em"><b>Special -commands</b> <br> -Two special commands are currently defined:</p> - -<p style="margin-top: 1em" valign="top"><b>/set</b></p> - -<p style="margin-left:26%; margin-top: 1em">This command -defines default values for one or more keywords. It is -followed on the same line by one or more -whitespace-separated keyword definitions. These definitions -apply to all following files that do not specify a value for -that keyword.</p> - -<p style="margin-top: 1em" valign="top"><b>/unset</b></p> - -<p style="margin-left:26%; margin-top: 1em">This command -removes any default value set by a previous <b>/set</b> -command. It is followed on the same line by one or more -keywords separated by whitespace.</p> - -<p style="margin-left:8%; margin-top: 1em"><b>Keywords</b> -<br> -After the filename, a full or relative entry consists of -zero or more whitespace-separated keyword definitions. Each -such definition consists of a key from the following list -immediately followed by an ’=’ sign and a value. -Software programs reading mtree files should warn about -unrecognized keywords.</p> - -<p style="margin-left:8%; margin-top: 1em">Currently -supported keywords are as follows:</p> - -<p style="margin-top: 1em" valign="top"><b>cksum</b></p> - -<p style="margin-left:26%; margin-top: 1em">The checksum of -the file using the default algorithm specified by the -cksum(1) utility.</p> - - -<p style="margin-top: 1em" valign="top"><b>contents</b></p> - -<p style="margin-left:26%; margin-top: 1em">The full -pathname of a file that holds the contents of this file.</p> - -<p style="margin-top: 1em" valign="top"><b>flags</b></p> - -<p style="margin-left:26%; margin-top: 1em">The file flags -as a symbolic name. See chflags(1) for information on these -names. If no flags are to be set the string -‘‘none’’ may be used to override the -current default.</p> - -<p style="margin-top: 1em" valign="top"><b>gid</b></p> - -<p style="margin-left:26%; margin-top: 1em">The file group -as a numeric value.</p> - -<p style="margin-top: 1em" valign="top"><b>gname</b></p> - -<p style="margin-left:26%; margin-top: 1em">The file group -as a symbolic name.</p> - -<p style="margin-top: 1em" valign="top"><b>ignore</b></p> - -<p style="margin-left:26%; margin-top: 1em">Ignore any file -hierarchy below this file.</p> - -<p style="margin-top: 1em" valign="top"><b>link</b></p> - -<p style="margin-left:26%; margin-top: 1em">The target of -the symbolic link when type=link.</p> - -<p style="margin-top: 1em" valign="top"><b>md5</b></p> - -<p style="margin-left:26%; margin-top: 1em">The MD5 message -digest of the file.</p> - - -<p style="margin-top: 1em" valign="top"><b>md5digest</b></p> - -<p style="margin-left:26%; margin-top: 1em">A synonym for -<b>md5</b>.</p> - -<p style="margin-top: 1em" valign="top"><b>mode</b></p> - -<p style="margin-left:26%; margin-top: 1em">The current -file’s permissions as a numeric (octal) or symbolic -value.</p> - -<p style="margin-top: 1em" valign="top"><b>nlink</b></p> - -<p style="margin-left:26%; margin-top: 1em">The number of -hard links the file is expected to have.</p> - - -<p style="margin-top: 1em" valign="top"><b>nochange</b></p> - -<p style="margin-left:26%; margin-top: 1em">Make sure this -file or directory exists but otherwise ignore all -attributes.</p> - - -<p style="margin-top: 1em" valign="top"><b>ripemd160digest</b></p> - -<p style="margin-left:26%;">The RIPEMD160 message digest of -the file.</p> - -<p style="margin-top: 1em" valign="top"><b>rmd160</b></p> - -<p style="margin-left:26%; margin-top: 1em">A synonym for -<b>ripemd160digest</b>.</p> - - -<p style="margin-top: 1em" valign="top"><b>rmd160digest</b></p> - -<p style="margin-left:26%;">A synonym for -<b>ripemd160digest</b>.</p> - -<p style="margin-top: 1em" valign="top"><b>sha1</b></p> - -<p style="margin-left:26%; margin-top: 1em">The FIPS 160-1 -(‘‘SHA-1’’) message digest of the -file.</p> - - -<p style="margin-top: 1em" valign="top"><b>sha1digest</b></p> - -<p style="margin-left:26%; margin-top: 1em">A synonym for -<b>sha1</b>.</p> - -<p style="margin-top: 1em" valign="top"><b>sha256</b></p> - -<p style="margin-left:26%; margin-top: 1em">The FIPS 180-2 -(‘‘SHA-256’’) message digest of the -file.</p> - - -<p style="margin-top: 1em" valign="top"><b>sha256digest</b></p> - -<p style="margin-left:26%;">A synonym for -<b>sha256</b>.</p> - -<p style="margin-top: 1em" valign="top"><b>size</b></p> - -<p style="margin-left:26%; margin-top: 1em">The size, in -bytes, of the file.</p> - -<p style="margin-top: 1em" valign="top"><b>time</b></p> - -<p style="margin-left:26%; margin-top: 1em">The last -modification time of the file.</p> - -<p style="margin-top: 1em" valign="top"><b>type</b></p> - -<p style="margin-left:26%; margin-top: 1em">The type of the -file; may be set to any one of the following:</p> - -<p style="margin-top: 1em" valign="top"><b>block</b></p> - -<p style="margin-left:45%; margin-top: 1em">block special -device</p> - -<p valign="top"><b>char</b></p> - -<p style="margin-left:45%; margin-top: 1em">character -special device</p> - -<p valign="top"><b>dir</b></p> - -<p style="margin-left:45%; margin-top: 1em">directory</p> - -<p valign="top"><b>fifo</b></p> - -<p style="margin-left:45%; margin-top: 1em">fifo</p> - -<p valign="top"><b>file</b></p> - -<p style="margin-left:45%; margin-top: 1em">regular -file</p> - -<p valign="top"><b>link</b></p> - -<p style="margin-left:45%; margin-top: 1em">symbolic -link</p> - -<p valign="top"><b>socket</b></p> - -<p style="margin-left:45%; margin-top: 1em">socket</p> - -<p style="margin-top: 1em" valign="top"><b>uid</b></p> - -<p style="margin-left:26%; margin-top: 1em">The file owner -as a numeric value.</p> - -<p style="margin-top: 1em" valign="top"><b>uname</b></p> - -<p style="margin-left:26%; margin-top: 1em">The file owner -as a symbolic name.</p> - -<p style="margin-top: 1em" valign="top"><b>SEE ALSO</b></p> - -<p style="margin-left:8%;">cksum(1), find(1), mtree(8)</p> - -<p style="margin-top: 1em" valign="top"><b>BUGS</b></p> - -<p style="margin-left:8%;">The FreeBSD implementation of -mtree does not currently support the <b>mtree</b> 2.0 -format. The requirement for a -‘‘#mtree’’ signature line is new and -not yet widely implemented.</p> - -<p style="margin-top: 1em" valign="top"><b>HISTORY</b></p> - -<p style="margin-left:8%;">The <b>mtree</b> utility -appeared in 4.3BSD−Reno. The MD5 digest capability was -added in FreeBSD 2.1, in response to the widespread use -of programs which can spoof cksum(1). The SHA-1 and -RIPEMD160 digests were added in FreeBSD 4.0, as new -attacks have demonstrated weaknesses in MD5. The SHA-256 -digest was added in FreeBSD 6.0. Support for file flags -was added in FreeBSD 4.0, and mostly comes from NetBSD. -The ‘‘full’’ entry format was added -by NetBSD.</p> - - -<p style="margin-left:8%; margin-top: 1em">FreeBSD 8.0 -August 20, 2007 FreeBSD 8.0</p> -<hr> -</body> -</html> +%!PS-Adobe-3.0 +%%Creator: groff version 1.19.2 +%%CreationDate: Sun Mar 14 02:49:17 2010 +%%DocumentNeededResources: font Times-Roman +%%DocumentSuppliedResources: procset grops 1.19 2 +%%Pages: 46 +%%PageOrder: Ascend +%%DocumentMedia: Default 612 792 0 () () +%%Orientation: Portrait +%%EndComments +%%BeginDefaults +%%PageMedia: Default +%%EndDefaults +%%BeginProlog +%%BeginResource: procset grops 1.19 2 +%!PS-Adobe-3.0 Resource-ProcSet +/setpacking where{ +pop +currentpacking +true setpacking +}if +/grops 120 dict dup begin +/SC 32 def +/A/show load def +/B{0 SC 3 -1 roll widthshow}bind def +/C{0 exch ashow}bind def +/D{0 exch 0 SC 5 2 roll awidthshow}bind def +/E{0 rmoveto show}bind def +/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def +/G{0 rmoveto 0 exch ashow}bind def +/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/I{0 exch rmoveto show}bind def +/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def +/K{0 exch rmoveto 0 exch ashow}bind def +/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/M{rmoveto show}bind def +/N{rmoveto 0 SC 3 -1 roll widthshow}bind def +/O{rmoveto 0 exch ashow}bind def +/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/Q{moveto show}bind def +/R{moveto 0 SC 3 -1 roll widthshow}bind def +/S{moveto 0 exch ashow}bind def +/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/SF{ +findfont exch +[exch dup 0 exch 0 exch neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/MF{ +findfont +[5 2 roll +0 3 1 roll +neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/level0 0 def +/RES 0 def +/PL 0 def +/LS 0 def +/MANUAL{ +statusdict begin/manualfeed true store end +}bind def +/PLG{ +gsave newpath clippath pathbbox grestore +exch pop add exch pop +}bind def +/BP{ +/level0 save def +1 setlinecap +1 setlinejoin +72 RES div dup scale +LS{ +90 rotate +}{ +0 PL translate +}ifelse +1 -1 scale +}bind def +/EP{ +level0 restore +showpage +}def +/DA{ +newpath arcn stroke +}bind def +/SN{ +transform +.25 sub exch .25 sub exch +round .25 add exch round .25 add exch +itransform +}bind def +/DL{ +SN +moveto +SN +lineto stroke +}bind def +/DC{ +newpath 0 360 arc closepath +}bind def +/TM matrix def +/DE{ +TM currentmatrix pop +translate scale newpath 0 0 .5 0 360 arc closepath +TM setmatrix +}bind def +/RC/rcurveto load def +/RL/rlineto load def +/ST/stroke load def +/MT/moveto load def +/CL/closepath load def +/Fr{ +setrgbcolor fill +}bind def +/setcmykcolor where{ +pop +/Fk{ +setcmykcolor fill +}bind def +}if +/Fg{ +setgray fill +}bind def +/FL/fill load def +/LW/setlinewidth load def +/Cr/setrgbcolor load def +/setcmykcolor where{ +pop +/Ck/setcmykcolor load def +}if +/Cg/setgray load def +/RE{ +findfont +dup maxlength 1 index/FontName known not{1 add}if dict begin +{ +1 index/FID ne{def}{pop pop}ifelse +}forall +/Encoding exch def +dup/FontName exch def +currentdict end definefont pop +}bind def +/DEFS 0 def +/EBEGIN{ +moveto +DEFS begin +}bind def +/EEND/end load def +/CNT 0 def +/level1 0 def +/PBEGIN{ +/level1 save def +translate +div 3 1 roll div exch scale +neg exch neg exch translate +0 setgray +0 setlinecap +1 setlinewidth +0 setlinejoin +10 setmiterlimit +[]0 setdash +/setstrokeadjust where{ +pop +false setstrokeadjust +}if +/setoverprint where{ +pop +false setoverprint +}if +newpath +/CNT countdictstack def +userdict begin +/showpage{}def +/setpagedevice{}def +}bind def +/PEND{ +countdictstack CNT sub{end}repeat +level1 restore +}bind def +end def +/setpacking where{ +pop +setpacking +}if +%%EndResource +%%EndProlog +%%BeginSetup +%%BeginFeature: *PageSize Default +<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice +%%EndFeature +%%IncludeResource: font Times-Roman +grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 +def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron +/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen +/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon +/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O +/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex +/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y +/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft +/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl +/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut +/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash +/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen +/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft +/logicalnot/minus/registered/macron/degree/plusminus/twosuperior +/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior +/ordmasculine/guilsinglright/onequarter/onehalf/threequarters +/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE +/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex +/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis +/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn +/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash +/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def +/Times-Roman@0 ENC0/Times-Roman RE +%%EndSetup +%%Page: 1 1 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<html>)0 12 Q(<head>)0 24 Q(<title>)36 36 Q +(August 20, 2007 MTREE 5)74.5 48 Q(</title>)36 72 Q 0 Cg EP +%%Page: 2 2 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<style type="te)36 12 Q(xt/css">)-.15 E(<!--)36 +24 Q(body { mar)72 36 Q(gin-left:4%; })-.18 E(H1, H2, H3, H4, H5 {)72 48 +Q(color: maroon; padding: 4pt; mar)108 60 Q(gin-left: -4%;)-.18 E +(border: solid; border)108 72 Q(-width: thin; width: 100%;)-.2 E 0 Cg EP +%%Page: 3 3 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(background: r)108 12 Q(gb\(204,204,255\))-.18 E +(})72 24 Q(-->)36 36 Q(</style>)36 48 Q(</head>)0 60 Q +(<body bgcolor="#FFFFFF" te)0 72 Q(xt="#000000">)-.15 E 0 Cg EP +%%Page: 4 4 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<h3 id="N)36 12 Q(AME">)-.35 E -.35(NA)36 24 S +(ME).35 E(</h3>)36 36 Q(<b>mtree</b>)0 48 Q 2.5(-f)0 60 S +(ormat of mtree dir hierarch)-2.5 E 2.5<798c>-.05 G(les)-2.5 E +(<h3 id="DESCRIPTION">)36 72 Q 0 Cg EP +%%Page: 5 5 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(DESCRIPTION)36 12 Q(</h3>)36 24 Q(The)0 36 Q +(<b>mtree</b>)0 48 Q(format is a te)0 60 Q +(xtual format that describes a collection of \214lesystem objects.)-.15 +E(Such \214les are typically used to create or v)0 72 Q +(erify directory hierarchies.)-.15 E 0 Cg EP +%%Page: 6 6 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<h4 id="General F)36 12 Q(ormat">)-.15 E +(General F)36 24 Q(ormat)-.15 E(</h4>)36 36 Q(An)0 48 Q(<b>mtree</b>)0 +60 Q(\214le consists of a series of lines, each pro)0 72 Q +(viding information)-.15 E 0 Cg EP +%%Page: 7 7 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(about a single \214lesystem object.)0 12 Q +(Leading whitespace is al)0 24 Q -.1(wa)-.1 G(ys ignored.).1 E(<p>)36 36 +Q(When encoding \214le or pathnames, an)0 48 Q 2.5(yb)-.15 G +(ackslash character or)-2.5 E +(character outside of the 95 printable ASCII characters must be)0 60 Q +(encoded as a a backslash follo)0 72 Q(wed by three)-.25 E 0 Cg EP +%%Page: 8 8 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(octal digits.)0 12 Q +(When reading mtree \214les, an)0 24 Q 2.5(ya)-.15 G +(ppearance of a backslash)-2.5 E(follo)0 36 Q +(wed by three octal digits should be con)-.25 E -.15(ve)-.4 G +(rted into the).15 E(corresponding character)0 48 Q(.)-.55 E(<p>)36 60 Q +(Each line is interpreted independently as one of the follo)0 72 Q +(wing types:)-.25 E 0 Cg EP +%%Page: 9 9 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<dl compact>)0 12 Q(<p><dt>Signature<dd>)0 24 Q +(The \214rst line of an)0 36 Q 2.5(ym)-.15 G(tree \214le must be)-2.5 E +(gin with)-.15 E -.74(``)0 48 S(#mtree').74 E('.)-.74 E +(If a \214le contains an)0 60 Q 2.5(yf)-.15 G +(ull path entries, the \214rst line should)-2.5 E(be)0 72 Q(gin with) +-.15 E 0 Cg EP +%%Page: 10 10 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.74(``)0 12 S(#mtree v2.0').74 E(',)-.74 E +(otherwise, the \214rst line should be)0 24 Q(gin with)-.15 E -.74(``)0 +36 S(#mtree v1.0').74 E('.)-.74 E(<p><dt>Blank<dd>)0 48 Q +(Blank lines are ignored.)0 60 Q(<p><dt>Comment<dd>)0 72 Q 0 Cg EP +%%Page: 11 11 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(Lines be)0 12 Q(ginning with)-.15 E +(<b></b><b>#</b>)0 24 Q(are ignored.)0 36 Q(<p><dt>Special<dd>)0 48 Q +(Lines be)0 60 Q(ginning with)-.15 E(<b></b><b>/</b>)0 72 Q 0 Cg EP +%%Page: 12 12 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(are special commands that in\215uence)0 12 Q +(the interpretation of later lines.)0 24 Q(<p><dt>Relati)0 36 Q -.15(ve) +-.25 G(<dd>).15 E(If the \214rst whitespace-delimited w)0 48 Q +(ord has no)-.1 E(<b></b><b>/</b>)0 60 Q(characters,)0 72 Q 0 Cg EP +%%Page: 13 13 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF +(it is the name of a \214le in the current directory)0 12 Q(.)-.65 E(An) +0 24 Q 2.5(yr)-.15 G(elati)-2.5 E .3 -.15(ve e)-.25 H +(ntry that describes a directory changes the).15 E(current directory)0 +36 Q(.)-.65 E(<p><dt>dot-dot<dd>)0 48 Q(As a special case, a relati)0 60 +Q .3 -.15(ve e)-.25 H(ntry with the \214lename).15 E +(<code></code><code>..</code>)0 72 Q 0 Cg EP +%%Page: 14 14 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF +(changes the current directory to the parent directory)0 12 Q(.)-.65 E +(Options on dot-dot entries are al)0 24 Q -.1(wa)-.1 G(ys ignored.).1 E +(<p><dt>Full<dd>)0 36 Q(If the \214rst whitespace-delimited w)0 48 Q +(ord has a)-.1 E(<b></b><b>/</b>)0 60 Q(character after)0 72 Q 0 Cg EP +%%Page: 15 15 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(the \214rst character)0 12 Q 2.5(,i)-.4 G 2.5 +(ti)-2.5 G 2.5(st)-2.5 G(he pathname of a \214le relati)-2.5 E .3 -.15 +(ve t)-.25 H 2.5(ot).15 G(he)-2.5 E(starting directory)0 24 Q(.)-.65 E +(There can be multiple full entries describing the same \214le.)0 36 Q +(</dl>)0 48 Q(<p>)36 60 Q(Some tools that process)0 72 Q 0 Cg EP +%%Page: 16 16 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<b>mtree</b>)0 12 Q +(\214les may require that multiple lines describing the same \214le)0 24 +Q(occur consecuti)0 36 Q -.15(ve)-.25 G(ly).15 E(.)-.65 E +(It is not permitted for the same \214le to be mentioned using)0 48 Q +(both a relati)0 60 Q .3 -.15(ve a)-.25 H +(nd a full \214le speci\214cation.).15 E(<h4 id="Special commands">)36 +72 Q 0 Cg EP +%%Page: 17 17 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(Special commands)36 12 Q(</h4>)36 24 Q -1 -.8 +(Tw o)0 36 T(special commands are currently de\214ned:)3.3 E +(<dl compact>)0 48 Q(<p><dt><b></b><b>/set</b><dd>)0 60 Q +(This command de\214nes def)0 72 Q(ault v)-.1 E(alues for one or more k) +-.25 E -.15(ey)-.1 G -.1(wo).15 G(rds.).1 E 0 Cg EP +%%Page: 18 18 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(It is follo)0 12 Q +(wed on the same line by one or more whitespace-separated)-.25 E -.1(ke) +0 24 S(yw)-.05 E(ord de\214nitions.)-.1 E +(These de\214nitions apply to all follo)0 36 Q +(wing \214les that do not specify)-.25 E 2.5(av)0 48 S(alue for that k) +-2.75 E -.15(ey)-.1 G -.1(wo).15 G(rd.).1 E +(<p><dt><b></b><b>/unset</b><dd>)0 60 Q(This command remo)0 72 Q -.15 +(ve)-.15 G 2.5(sa).15 G .3 -.15(ny d)-2.5 H(ef).15 E(ault v)-.1 E +(alue set by a pre)-.25 E(vious)-.25 E 0 Cg EP +%%Page: 19 19 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<b></b><b>/set</b>)0 12 Q(command.)0 24 Q +(It is follo)0 36 Q(wed on the same line by one or more k)-.25 E -.15 +(ey)-.1 G -.1(wo).15 G(rds).1 E(separated by whitespace.)0 48 Q(</dl>)0 +60 Q(<h4 id="K)36 72 Q -.15(ey)-.25 G -.1(wo).15 G(rds">).1 E 0 Cg EP +%%Page: 20 20 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -2.15 -.25(Ke y)36 12 T -.1(wo).25 G(rds).1 E +(</h4>)36 24 Q(After the \214lename, a full or relati)0 36 Q .3 -.15 +(ve e)-.25 H(ntry consists of zero).15 E(or more whitespace-separated k) +0 48 Q -.15(ey)-.1 G -.1(wo).15 G(rd de\214nitions.).1 E +(Each such de\214nition consists of a k)0 60 Q .3 -.15(ey f)-.1 H +(rom the follo).15 E(wing)-.25 E(list immediately follo)0 72 Q +(wed by an '=' sign)-.25 E 0 Cg EP +%%Page: 21 21 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(and a v)0 12 Q(alue.)-.25 E(Softw)0 24 Q +(are programs reading mtree \214les should w)-.1 E(arn about)-.1 E +(unrecognized k)0 36 Q -.15(ey)-.1 G -.1(wo).15 G(rds.).1 E(<p>)36 48 Q +(Currently supported k)0 60 Q -.15(ey)-.1 G -.1(wo).15 G +(rds are as follo).1 E(ws:)-.25 E(<dl compact>)0 72 Q 0 Cg EP +%%Page: 22 22 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>cksum</b><dd>)0 12 Q +(The checksum of the \214le using the def)0 24 Q +(ault algorithm speci\214ed by)-.1 E(the)0 36 Q +(<a href="../html1/cksum.html">cksum\(1\)</a>)0 48 Q(utility)0 60 Q(.) +-.65 E(<p><dt><b></b><b>contents</b><dd>)0 72 Q 0 Cg EP +%%Page: 23 23 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF +(The full pathname of a \214le that holds the contents of this \214le.)0 +12 Q(<p><dt><b></b><b>\215ags</b><dd>)0 24 Q +(The \214le \215ags as a symbolic name.)0 36 Q(See)0 48 Q +(<a href="../html1/ch\215ags.html">ch\215ags\(1\)</a>)0 60 Q +(for information on these names.)0 72 Q 0 Cg EP +%%Page: 24 24 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(If no \215ags are to be set the string)0 12 Q +-.74(``)0 24 S(none').74 E(')-.74 E(may be used to o)0 36 Q -.15(ve)-.15 +G(rride the current def).15 E(ault.)-.1 E(<p><dt><b></b><b>gid</b><dd>)0 +48 Q(The \214le group as a numeric v)0 60 Q(alue.)-.25 E +(<p><dt><b></b><b>gname</b><dd>)0 72 Q 0 Cg EP +%%Page: 25 25 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The \214le group as a symbolic name.)0 12 Q +(<p><dt><b></b><b>ignore</b><dd>)0 24 Q(Ignore an)0 36 Q 2.5<798c>-.15 G +(le hierarch)-2.5 E 2.5(yb)-.05 G(elo)-2.5 E 2.5(wt)-.25 G(his \214le.) +-2.5 E(<p><dt><b></b><b>link</b><dd>)0 48 Q(The tar)0 60 Q +(get of the symbolic link when type=link.)-.18 E +(<p><dt><b></b><b>md5</b><dd>)0 72 Q 0 Cg EP +%%Page: 26 26 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The MD5 message digest of the \214le.)0 12 Q +(<p><dt><b></b><b>md5digest</b><dd>)0 24 Q 2.5(As)0 36 S(ynon)-2.5 E +(ym for)-.15 E(<b></b><b>md5</b>.)0 48 Q(<p><dt><b></b><b>mode</b><dd>)0 +60 Q(The current \214le')0 72 Q 2.5(sp)-.55 G +(ermissions as a numeric \(octal\) or symbolic)-2.5 E 0 Cg EP +%%Page: 27 27 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.25(va)0 12 S(lue.).25 E +(<p><dt><b></b><b>nlink</b><dd>)0 24 Q +(The number of hard links the \214le is e)0 36 Q(xpected to ha)-.15 E +-.15(ve)-.2 G(.).15 E(<p><dt><b></b><b>nochange</b><dd>)0 48 Q(Mak)0 60 +Q 2.5(es)-.1 G(ure this \214le or directory e)-2.5 E(xists b)-.15 E +(ut otherwise ignore all attrib)-.2 E(utes.)-.2 E +(<p><dt><b></b><b>ripemd160digest</b><dd>)0 72 Q 0 Cg EP +%%Page: 28 28 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The)0 12 Q +(<font size="-1"></font><font size="-1">RIPEMD160</font>)0 24 Q +(message digest of the \214le.)0 36 Q(<p><dt><b></b><b>rmd160</b><dd>)0 +48 Q 2.5(As)0 60 S(ynon)-2.5 E(ym for)-.15 E +(<b></b><b>ripemd160digest</b>.)0 72 Q 0 Cg EP +%%Page: 29 29 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>rmd160digest</b><dd>)0 12 Q 2.5 +(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(<b></b><b>ripemd160digest</b>.)0 36 +Q(<p><dt><b></b><b>sha1</b><dd>)0 48 Q(The)0 60 Q +(<font size="-1"></font><font size="-1">FIPS</font>)0 72 Q 0 Cg EP +%%Page: 30 30 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(160-1)0 12 Q(\(`)0 24 Q +(`<font size="-1"></font><font size="-1">SHA-1</font>')-.74 E('\))-.74 E +(message digest of the \214le.)0 36 Q +(<p><dt><b></b><b>sha1digest</b><dd>)0 48 Q 2.5(As)0 60 S(ynon)-2.5 E +(ym for)-.15 E(<b></b><b>sha1</b>.)0 72 Q 0 Cg EP +%%Page: 31 31 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>sha256</b><dd>)0 12 Q(The)0 24 +Q(<font size="-1"></font><font size="-1">FIPS</font>)0 36 Q(180-2)0 48 Q +(\(`)0 60 Q(`<font size="-1"></font><font size="-1">SHA-256</font>')-.74 +E('\))-.74 E(message digest of the \214le.)0 72 Q 0 Cg EP +%%Page: 32 32 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>sha256digest</b><dd>)0 12 Q 2.5 +(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(<b></b><b>sha256</b>.)0 36 Q +(<p><dt><b></b><b>size</b><dd>)0 48 Q +(The size, in bytes, of the \214le.)0 60 Q +(<p><dt><b></b><b>time</b><dd>)0 72 Q 0 Cg EP +%%Page: 33 33 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The last modi\214cation time of the \214le.)0 12 +Q(<p><dt><b></b><b>type</b><dd>)0 24 Q +(The type of the \214le; may be set to an)0 36 Q 2.5(yo)-.15 G +(ne of the follo)-2.5 E(wing:)-.25 E(<p>)36 48 Q(<dl compact>)0 60 Q +(<dt><b></b><b>block</b><dd>)0 72 Q 0 Cg EP +%%Page: 34 34 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(block special de)0 12 Q(vice)-.25 E +(<dt><b></b><b>char</b><dd>)0 24 Q(character special de)0 36 Q(vice)-.25 +E(<dt><b></b><b>dir</b><dd>)0 48 Q(directory)0 60 Q +(<dt><b></b><b>\214fo</b><dd>)0 72 Q 0 Cg EP +%%Page: 35 35 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(\214fo)0 12 Q(<dt><b></b><b>\214le</b><dd>)0 24 +Q(re)0 36 Q(gular \214le)-.15 E(<dt><b></b><b>link</b><dd>)0 48 Q +(symbolic link)0 60 Q(<dt><b></b><b>sock)0 72 Q(et</b><dd>)-.1 E 0 Cg EP +%%Page: 36 36 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(sock)0 12 Q(et)-.1 E(</dl>)0 24 Q +(<p><dt><b></b><b>uid</b><dd>)0 36 Q(The \214le o)0 48 Q +(wner as a numeric v)-.25 E(alue.)-.25 E(<p><dt><b></b><b>uname</b><dd>) +0 60 Q(The \214le o)0 72 Q(wner as a symbolic name.)-.25 E 0 Cg EP +%%Page: 37 37 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(<p>)36 24 Q(<h3 id="SEE ALSO">)36 +36 Q(SEE ALSO)36 48 Q(</h3>)36 60 Q +(<a href="../html1/cksum.html">cksum\(1\)</a>,)0 72 Q 0 Cg EP +%%Page: 38 38 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(<a href="../html1/\214nd.html">\214nd\(1\)</a>,) +0 12 Q(<a href="../html8/mtree.html">mtree\(8\)</a>)0 24 Q(<h3 id="B)36 +36 Q(UGS">)-.1 E -.1(BU)36 48 S(GS).1 E(</h3>)36 60 Q(The)0 72 Q 0 Cg EP +%%Page: 39 39 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(FreeBSD)0 12 Q +(implementation of mtree does not currently support)0 24 Q(the)0 36 Q +(<b>mtree</b>)0 48 Q(2.0)0 60 Q(format.)0 72 Q 0 Cg EP +%%Page: 40 40 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The requirement for a)0 12 Q -.74(``)0 24 S +(#mtree').74 E(')-.74 E(signature line is ne)0 36 Q 2.5(wa)-.25 G +(nd not yet widely implemented.)-2.5 E(<h3 id="HIST)36 48 Q(OR)-.18 E +(Y">)-.65 E(HIST)36 60 Q(OR)-.18 E(Y)-.65 E(</h3>)36 72 Q 0 Cg EP +%%Page: 41 41 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The)0 12 Q(<b>mtree</b>)0 24 Q +(utility appeared in)0 36 Q(4.3BSDReno.)0 48 Q(The)0 60 Q +(<font size="-1"></font><font size="-1">MD5</font>)0 72 Q 0 Cg EP +%%Page: 42 42 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(digest capability w)0 12 Q(as added in)-.1 E +(FreeBSD2.1,)0 24 Q +(in response to the widespread use of programs which can spoof)0 36 Q +(<a href="../html1/cksum.html">cksum\(1\)</a>.)0 48 Q(The)0 60 Q +(<font size="-1"></font><font size="-1">SHA-1</font>)0 72 Q 0 Cg EP +%%Page: 43 43 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(and)0 12 Q +(<font size="-1"></font><font size="-1">RIPEMD160</font>)0 24 Q +(digests were added in)0 36 Q(FreeBSD4.0,)0 48 Q(as ne)0 60 Q 2.5(wa) +-.25 G(ttacks ha)-2.5 E .3 -.15(ve d)-.2 H(emonstrated weaknesses in).15 +E(<font size="-1"></font><font size="-1">MD5</font>.)0 72 Q 0 Cg EP +%%Page: 44 44 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(The)0 12 Q +(<font size="-1"></font><font size="-1">SHA-256</font>)0 24 Q(digest w)0 +36 Q(as added in)-.1 E(FreeBSD6.0.)0 48 Q(Support for \214le \215ags w)0 +60 Q(as added in)-.1 E(FreeBSD4.0,)0 72 Q 0 Cg EP +%%Page: 45 45 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(and mostly comes from)0 12 Q(NetBSD.)0 24 Q(The) +0 36 Q -.74(``)0 48 S(full').74 E(')-.74 E(entry format w)0 60 Q +(as added by)-.1 E(NetBSD.)0 72 Q 0 Cg EP +%%Page: 46 46 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF(</body>)0 12 Q(</html>)0 24 Q 0 Cg EP +%%Trailer +end +%%EOF |