head 1.22;
access;
symbols
libarchive-3-8-7:1.1.1.23
libarchive-3-8-6:1.1.1.22
pkgsrc-2026Q1:1.20.0.2
pkgsrc-2026Q1-base:1.20
libarchive-3-8-5:1.1.1.21
libarchive-3-8-4:1.1.1.20
pkgsrc-2025Q4:1.18.0.2
pkgsrc-2025Q4-base:1.18
libarchive-3-8-3:1.1.1.19
libarchive-3-8-2:1.1.1.18
pkgsrc-2025Q3:1.16.0.2
pkgsrc-2025Q3-base:1.16
libarchive-3-8-1:1.1.1.17
pkgsrc-2025Q2:1.15.0.2
pkgsrc-2025Q2-base:1.15
libarchive-3-8-0:1.1.1.16
libarchive-3-7-9:1.1.1.15
pkgsrc-2025Q1:1.13.0.4
pkgsrc-2025Q1-base:1.13
pkgsrc-2024Q4:1.13.0.2
pkgsrc-2024Q4-base:1.13
libarchive-3-7-7:1.1.1.14
pkgsrc-2024Q3:1.12.0.2
pkgsrc-2024Q3-base:1.12
libarchive-3-7-5:1.1.1.13
pkgsrc-2024Q2:1.11.0.2
pkgsrc-2024Q2-base:1.11
libarchive-3-7-4:1.1.1.12
libarchive-3-7-3:1.1.1.11
pkgsrc-2024Q1:1.9.0.2
pkgsrc-2024Q1-base:1.9
libarchive-3-7-2:1.1.1.10
pkgsrc-2023Q4:1.8.0.30
pkgsrc-2023Q4-base:1.8
pkgsrc-2023Q3:1.8.0.28
pkgsrc-2023Q3-base:1.8
pkgsrc-2023Q2:1.8.0.26
pkgsrc-2023Q2-base:1.8
pkgsrc-2023Q1:1.8.0.24
pkgsrc-2023Q1-base:1.8
pkgsrc-2022Q4:1.8.0.22
pkgsrc-2022Q4-base:1.8
pkgsrc-2022Q3:1.8.0.20
pkgsrc-2022Q3-base:1.8
pkgsrc-2022Q2:1.8.0.18
pkgsrc-2022Q2-base:1.8
pkgsrc-2022Q1:1.8.0.16
pkgsrc-2022Q1-base:1.8
pkgsrc-2021Q4:1.8.0.14
pkgsrc-2021Q4-base:1.8
pkgsrc-2021Q3:1.8.0.12
pkgsrc-2021Q3-base:1.8
pkgsrc-2021Q2:1.8.0.10
pkgsrc-2021Q2-base:1.8
pkgsrc-2021Q1:1.8.0.8
pkgsrc-2021Q1-base:1.8
pkgsrc-2020Q4:1.8.0.6
pkgsrc-2020Q4-base:1.8
pkgsrc-2020Q3:1.8.0.4
pkgsrc-2020Q3-base:1.8
pkgsrc-2020Q2:1.8.0.2
pkgsrc-2020Q2-base:1.8
pkgsrc-2020Q1:1.7.0.4
pkgsrc-2020Q1-base:1.7
pkgsrc-2019Q4:1.7.0.6
pkgsrc-2019Q4-base:1.7
pkgsrc-2019Q3:1.7.0.2
pkgsrc-2019Q3-base:1.7
libarchive-3-4-0:1.1.1.9
libarchive-3-3-3:1.1.1.8
pkgsrc-2019Q2:1.6.0.2
pkgsrc-2019Q2-base:1.6
pkgsrc-2019Q1:1.5.0.16
pkgsrc-2019Q1-base:1.5
pkgsrc-2018Q4:1.5.0.14
pkgsrc-2018Q4-base:1.5
pkgsrc-2018Q3:1.5.0.12
pkgsrc-2018Q3-base:1.5
pkgsrc-2018Q2:1.5.0.10
pkgsrc-2018Q2-base:1.5
pkgsrc-2018Q1:1.5.0.8
pkgsrc-2018Q1-base:1.5
pkgsrc-2017Q4:1.5.0.6
pkgsrc-2017Q4-base:1.5
pkgsrc-2017Q3:1.5.0.4
pkgsrc-2017Q3-base:1.5
libarchive-3-3-2:1.1.1.7
pkgsrc-2017Q2:1.4.0.4
pkgsrc-2017Q2-base:1.4
pkgsrc-2017Q1:1.4.0.2
pkgsrc-2017Q1-base:1.4
libarchive-3-3-1:1.1.1.6
pkgsrc-2016Q4:1.3.0.6
pkgsrc-2016Q4-base:1.3
pkgsrc-2016Q3:1.3.0.4
pkgsrc-2016Q3-base:1.3
pkgsrc-2016Q2:1.3.0.2
pkgsrc-2016Q2-base:1.3
libarchive-3-2-1:1.1.1.5
pkgsrc-2016Q1:1.2.0.10
pkgsrc-2016Q1-base:1.2
pkgsrc-2015Q4:1.2.0.8
pkgsrc-2015Q4-base:1.2
pkgsrc-2015Q3:1.2.0.6
pkgsrc-2015Q3-base:1.2
pkgsrc-2015Q2:1.2.0.4
pkgsrc-2015Q2-base:1.2
pkgsrc-2015Q1:1.2.0.2
pkgsrc-2015Q1-base:1.2
pkgsrc-2014Q4:1.1.1.4.0.36
pkgsrc-2014Q4-base:1.1.1.4
pkgsrc-2014Q3:1.1.1.4.0.34
pkgsrc-2014Q3-base:1.1.1.4
pkgsrc-2014Q2:1.1.1.4.0.32
pkgsrc-2014Q2-base:1.1.1.4
pkgsrc-2014Q1:1.1.1.4.0.30
pkgsrc-2014Q1-base:1.1.1.4
pkgsrc-2013Q4:1.1.1.4.0.28
pkgsrc-2013Q4-base:1.1.1.4
pkgsrc-2013Q3:1.1.1.4.0.26
pkgsrc-2013Q3-base:1.1.1.4
pkgsrc-2013Q2:1.1.1.4.0.24
pkgsrc-2013Q2-base:1.1.1.4
pkgsrc-2013Q1:1.1.1.4.0.22
pkgsrc-2013Q1-base:1.1.1.4
pkgsrc-2012Q4:1.1.1.4.0.20
pkgsrc-2012Q4-base:1.1.1.4
pkgsrc-2012Q3:1.1.1.4.0.18
pkgsrc-2012Q3-base:1.1.1.4
pkgsrc-2012Q2:1.1.1.4.0.16
pkgsrc-2012Q2-base:1.1.1.4
pkgsrc-2012Q1:1.1.1.4.0.14
pkgsrc-2012Q1-base:1.1.1.4
pkgsrc-2011Q4:1.1.1.4.0.12
pkgsrc-2011Q4-base:1.1.1.4
pkgsrc-2011Q3:1.1.1.4.0.10
pkgsrc-2011Q3-base:1.1.1.4
pkgsrc-2011Q2:1.1.1.4.0.8
pkgsrc-2011Q2-base:1.1.1.4
pkgsrc-2011Q1:1.1.1.4.0.6
pkgsrc-2011Q1-base:1.1.1.4
pkgsrc-2010Q4:1.1.1.4.0.4
pkgsrc-2010Q4-base:1.1.1.4
pkgsrc-2010Q3:1.1.1.4.0.2
pkgsrc-2010Q3-base:1.1.1.4
libarchive-2-8-4:1.1.1.4
pkgsrc-2010Q2:1.1.1.3.0.4
pkgsrc-2010Q2-base:1.1.1.3
pkgsrc-2010Q1:1.1.1.3.0.2
pkgsrc-2010Q1-base:1.1.1.3
libarchive-2-8-3:1.1.1.3
libarchive-2-8-2:1.1.1.2
libarchive-2-8-0:1.1.1.1
KIENTZLE:1.1.1;
locks; strict;
comment @# @;
1.22
date 2026.04.15.08.46.34; author adam; state Exp;
branches;
next 1.21;
commitid pL26mrnh4kOo62CG;
1.21
date 2026.03.26.11.20.06; author adam; state Exp;
branches;
next 1.20;
commitid 8pSUUUHFeJu1BtzG;
1.20
date 2026.01.06.11.55.22; author adam; state Exp;
branches;
next 1.19;
commitid lOosf75XWhczkkpG;
1.19
date 2025.12.23.14.01.22; author adam; state Exp;
branches;
next 1.18;
commitid 3zKcl3VhUVXFtxnG;
1.18
date 2025.11.20.06.08.25; author adam; state Exp;
branches;
next 1.17;
commitid kB7NF5kSlmUaVfjG;
1.17
date 2025.11.02.08.52.13; author adam; state Exp;
branches;
next 1.16;
commitid hdaVwMAEUWR8pXgG;
1.16
date 2025.07.01.15.14.43; author adam; state Exp;
branches;
next 1.15;
commitid sA2cBFYBXpUBv31G;
1.15
date 2025.05.21.15.25.49; author adam; state Exp;
branches;
next 1.14;
commitid 6aTN21WjRYk8TMVF;
1.14
date 2025.04.28.10.31.33; author adam; state Exp;
branches;
next 1.13;
commitid Tocq615J6mYPZNSF;
1.13
date 2024.10.19.05.39.56; author adam; state Exp;
branches;
next 1.12;
commitid fYRSlpIWMYluweuF;
1.12
date 2024.09.15.07.02.19; author adam; state Exp;
branches;
next 1.11;
commitid x365AQIKhret4SpF;
1.11
date 2024.04.30.06.05.18; author adam; state Exp;
branches;
next 1.10;
commitid id0E8i4RwCC4c88F;
1.10
date 2024.04.12.15.39.49; author adam; state Exp;
branches;
next 1.9;
commitid 52ilmjFHKDf0XR5F;
1.9
date 2024.01.18.18.00.14; author adam; state Exp;
branches;
next 1.8;
commitid hNXpsHx3SuHqsXUE;
1.8
date 2020.05.26.09.16.40; author nia; state Exp;
branches;
next 1.7;
commitid nNhsdZACz3PjmJ9C;
1.7
date 2019.09.22.09.55.07; author joerg; state Exp;
branches;
next 1.6;
commitid FdPvRjF4OzwBwZDB;
1.6
date 2019.04.10.08.24.05; author adam; state Exp;
branches;
next 1.5;
commitid LnliQ9ieqYkikMiB;
1.5
date 2017.08.01.22.26.22; author joerg; state Exp;
branches;
next 1.4;
commitid 32clTfkmVE8bPy1A;
1.4
date 2017.02.25.21.11.19; author joerg; state Exp;
branches;
next 1.3;
commitid rW8QfCWrsCO1snHz;
1.3
date 2016.06.20.17.24.56; author joerg; state Exp;
branches;
next 1.2;
commitid ArUvympBjfBseebz;
1.2
date 2015.01.17.12.44.49; author adam; state Exp;
branches;
next 1.1;
commitid yy7e1hLrfmA2pn6y;
1.1
date 2010.02.20.03.49.45; author joerg; state Exp;
branches
1.1.1.1;
next ;
1.1.1.1
date 2010.02.20.03.49.45; author joerg; state Exp;
branches;
next 1.1.1.2;
1.1.1.2
date 2010.03.14.17.57.27; author joerg; state Exp;
branches;
next 1.1.1.3;
1.1.1.3
date 2010.03.16.17.07.06; author joerg; state Exp;
branches;
next 1.1.1.4;
1.1.1.4
date 2010.07.09.11.53.35; author joerg; state Exp;
branches;
next 1.1.1.5;
1.1.1.5
date 2016.06.20.17.11.53; author joerg; state Exp;
branches;
next 1.1.1.6;
commitid rRgm3BqbmbI8aebz;
1.1.1.6
date 2017.02.25.20.54.23; author joerg; state Exp;
branches;
next 1.1.1.7;
commitid ReqPI0ibLYjdmnHz;
1.1.1.7
date 2017.08.01.22.21.11; author joerg; state Exp;
branches;
next 1.1.1.8;
commitid XQwPAFJku336Ny1A;
1.1.1.8
date 2019.09.22.09.47.03; author joerg; state Exp;
branches;
next 1.1.1.9;
commitid N0KxAXOYyULduZDB;
1.1.1.9
date 2019.09.22.09.51.33; author joerg; state Exp;
branches;
next 1.1.1.10;
commitid 5kDbfPbiV3INvZDB;
1.1.1.10
date 2024.01.18.17.37.45; author adam; state Exp;
branches;
next 1.1.1.11;
commitid zDULEPUODGjTkXUE;
1.1.1.11
date 2024.04.12.15.27.44; author adam; state Exp;
branches;
next 1.1.1.12;
commitid tQWTddCoxBumSR5F;
1.1.1.12
date 2024.04.30.05.50.49; author adam; state Exp;
branches;
next 1.1.1.13;
commitid e4DnFoZdQV9Z688F;
1.1.1.13
date 2024.09.15.06.45.25; author adam; state Exp;
branches;
next 1.1.1.14;
commitid pOuXKsbh8iPCYRpF;
1.1.1.14
date 2024.10.19.05.27.34; author adam; state Exp;
branches;
next 1.1.1.15;
commitid v1iXM4j1Na52seuF;
1.1.1.15
date 2025.04.28.09.44.10; author adam; state Exp;
branches;
next 1.1.1.16;
commitid 1zB7ffc4d2qCJNSF;
1.1.1.16
date 2025.05.21.15.11.28; author adam; state Exp;
branches;
next 1.1.1.17;
commitid Nzqt2UgtvkVXNMVF;
1.1.1.17
date 2025.07.01.14.58.53; author adam; state Exp;
branches;
next 1.1.1.18;
commitid wKXYoBc9F9j8q31G;
1.1.1.18
date 2025.11.02.08.32.34; author adam; state Exp;
branches;
next 1.1.1.19;
commitid 8C56Xg3dc0HriXgG;
1.1.1.19
date 2025.11.20.05.51.45; author adam; state Exp;
branches;
next 1.1.1.20;
commitid LC6NMc2P0QpnPfjG;
1.1.1.20
date 2025.12.23.13.41.06; author adam; state Exp;
branches;
next 1.1.1.21;
commitid hhQbXTytJ7PFmxnG;
1.1.1.21
date 2026.01.06.11.43.29; author adam; state Exp;
branches;
next 1.1.1.22;
commitid Q4rjOheYoLWofkpG;
1.1.1.22
date 2026.03.26.11.11.16; author adam; state Exp;
branches;
next 1.1.1.23;
commitid P6u0vpfNBymXxtzG;
1.1.1.23
date 2026.04.15.08.40.11; author adam; state Exp;
branches;
next ;
commitid enlkxxj5Vxhi42CG;
desc
@@
1.22
log
@libarchive: updated to 3.8.7
Libarchive 3.8.7 is a security and bugfix release.
Notable fixes:
CAB: fix NULL pointer dereference during skip
CAB: Fix Heap OOB Write in CAB LZX decoder
cpio: various fixes and improvements
contrib/untar: fix out-of-bounds read
iso9660: fix undefined behavior
iso9660: fix posibble heap buffer overflow on 32-bit systems
libarchive: fix handling of option failures
libarchive: do not continue with truncated numbers
libarchive: lzop and grzip filter support
RAR: fix LZSS window size mismatch after PPMd block
@
text
@
MTREE(5) File Formats Manual MTREE(5)
NAME
mtree — format of mtree
dir hierarchy files
DESCRIPTION
The mtree format is a
textual format that describes a collection of filesystem
objects. Such files are typically used to create or verify
directory hierarchies.
General
Format
An mtree file consists of
a series of lines, each providing information about a single
filesystem object. Leading whitespace is always ignored.
When encoding
file or pathnames, any backslash character or character
outside of the 95 printable ASCII characters must be encoded
as 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.
Each line is
interpreted independently as one of the following types:
Blank
Blank lines are
ignored.
Comment
Lines beginning
with # are ignored.
Special
Lines beginning
with / are special commands that influence the
interpretation of later lines.
Relative
If the first
whitespace-delimited word has no / characters, it is
the name of a file in the current directory. Any relative
entry that describes a directory changes the current
directory.
dot-dot
As a special
case, a relative entry with the filename .. changes
the current directory to the parent directory. Options on
dot-dot entries are always ignored.
Full
If the first
whitespace-delimited word has a / 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.
Some tools that
process mtree 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.
Special
commands
Two special commands are
currently defined:
/set
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.
/unset
This command
removes any default value set by a previous /set
command. It is followed on the same line by one or more
keywords separated by whitespace.
Keywords
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.
Currently
supported keywords are as follows:
cksum
The checksum of
the file using the default algorithm specified by the
cksum(1) utility.
device
The device
number for block or char file types. The value
must be one of the following forms:
format,major,minor[
,subunit]
A device with major,
minor and optional subunit fields. Their
meaning is specified by the operating’s system
format. See below for valid formats.
number
Opaque number (as stored on the
file system).
The following
values for format are recognized: native,
386bsd, 4bsd, bsdos, freebsd,
hpux, isc, linux, netbsd,
osf1, sco, solaris, sunos,
svr3, svr4, and ultrix.
See
mknod(8) for more details.
contents
The full
pathname of a file that holds the contents of this file.
flags
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.
gid
The file group
as a numeric value.
gname
The file group
as a symbolic name.
ignore
Ignore any file
hierarchy below this file.
inode
The inode
number.
link
The target of
the symbolic link when type=link.
md5
The MD5 message
digest of the file.
md5digest
A synonym for
md5.
mode
The current
file’s permissions as a numeric (octal) or symbolic
value.
nlink
The number of
hard links the file is expected to have.
nochange
Make sure this
file or directory exists but otherwise ignore all
attributes.
optional
The file is
optional; do not complain about the file if it is not in the
file hierarchy.
resdevice
The
“resident” device number of the file, e.g. the
ID of the device that contains the file. Its format is the
same as the one for device.
ripemd160digest
The RIPEMD160 message digest of
the file.
rmd160
A synonym for
ripemd160digest.
rmd160digest
A synonym for
ripemd160digest.
sha1
The FIPS 160-1
(“SHA-1”) message digest of the file.
sha1digest
A synonym for
sha1.
sha256
The FIPS 180-2
(“SHA-256”) message digest of the file.
sha256digest
A synonym for
sha256.
sha384
The FIPS 180-2
(“SHA-384”) message digest of the file.
sha384digest
A synonym for
sha384.
sha512
The FIPS 180-2
(“SHA-512”) message digest of the file.
sha512digest
A synonym for
sha512.
size
The size, in
bytes, of the file.
time
The last
modification time of the file.
type
The type of the
file; may be set to any one of the following:
block
block special
device
char
character
special device
dir
directory
fifo
fifo
file
regular
file
link
symbolic
link
socket
socket
uid
The file owner
as a numeric value.
uname
The file owner
as a symbolic name.
SEE ALSO
cksum(1), find(1),
mtree(8)
HISTORY
The mtree 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.
Debian September 4, 2013 MTREE(5)
@
1.21
log
@libarchive: updated to 3.8.6
Libarchive 3.8.6 is a security and bugfix release.
Notable fixes:
libarchive: fix incompatibility with Nettle 4.x
libarchive: fix NULL pointer dereference in archive_acl_from_text_w()
bsdunzip: fix ISO week year and Gregorian year confusion
7zip: ix SEGV in check_7zip_header_in_sfx via ELF offset validation
7zip: fix out-of-bounds access on ELF 64-bit header
RAR5 reader: fix infinite loop in rar5 decompression
RAR5 reader: fix potential memory leak
RAR5: fix SIGSEGV when archive_read_support_format_rar5 is called twice
CAB reader: fix memory leak on repeated calls to archive_read_support_format_cab
mtree reader: Fix file descriptor leak in mtree parser cleanup
various small bugfixes in code and documentation
@
text
@d2 1
a2 1
@
1.20
log
@libarchive: updated to 3.8.5
3.8.5
Notable bugxies:
bsdtar: fix regression from 3.8.4 zero-length pattern issue bugfix
various small bugfixes in code and documentation
@
text
@d2 1
a2 1
@
1.19
log
@libarchive: updated to 3.8.4
3.8.4
Notable bugxies:
bsdtar: Fix zero-length pattern issue
lib: Fix regression introduced in libarchive 3.8.2 when walking enterable but unreadable directories
@
text
@d2 1
a2 1
@
1.18
log
@libarchive: updated to 3.8.3
Libarchive 3.8.3 is a bugfix and security release.
Security fixes:
lib: Create temporary files in the target directory
lha: Fix for an out-of-bounds buffer overrun when using p[H_LEVEL_OFFSET]
7-zip: Fix a buffer overrun when reading truncated 7zip headers
Notable bugxies:
lz4 and zstd: Support both lz4 and zstd data with leading skippable frames
@
text
@d2 1
a2 1
@
1.17
log
@libarchive: updated to 3.8.2
Libarchive 3.8.2 is a bugfix and security release.
Security fixes:
7zip: Fix out of boundary access
tar reader: fix checking the result of the strftime
Notable bugfixes:
bsdtar: Allow filename to have CRLF endings
lib: archive_read_data: handle sparse holes at end of file correctly
lib: improve filter process handling
lib: fix error checking in writing files
lib: handle possible errors from system calls
lib: avoid leaking file descriptors into subprocesses
lib: parse_date: handle dates in 2038 and beyond if time_t is big enough
RAR5 reader: fix multiple issues in extra field parsing function
RAR5 reader: early fail when file declares data for a dir entry
tar writer: fix replacing a regular file with a dir for ARCHIVE_EXTRACT_SAFE_WRITES
tar reader (Windows): check WCS pathname in header_gnutar before overwriting
tar reader: fix an infinite loop when parsing V headers
zip writer: fix a memory leak if write callback error early
zip writer: fix writing with ZSTD compression
zstd write filter: enable Zstandard's checksum feature
@
text
@d2 1
a2 1
@
1.16
log
@libarchive: updated to 3.8.1
3.8.1
Important bugfixes
various compilation fixes
fixed undefined behavior in a function in warc reader
Windows binary uses xz 5.2.5
@
text
@d2 1
a2 1
@
1.15
log
@libarchive bsdtar: updated to 3.8.0
Libarchive 3.8.0 is a feature and bugfix release.
New features:
bsdtar: support --mtime and --clamp-mtime
lib: mbedtls 3.x compatibility
7-zip reader: improve self-extracting archive detection
xar: xmllite support for the XAR reader and writer
zip writer: added XZ, LZMA, ZSTD and BZIP2 support
zip writer: added LZMA + RISCV BCJ filter
Notable security fixes:
rar: do not skip past EOF while reading
rar: fix double free with over 4 billion nodes
rar: fix heap-buffer-overflow
warc: prevent signed integer overflow
tar: fix overflow in build_ustar_entry
Notable bugfixes:
bsdtar: don't hardlink negative inode files together
gz: allow setting the original filename for gzip compressed files
lib: improve lseek handling
lib: support @@-prefixed Unix epoch timestamps as date strings
rar: support large headers on 32 bit systems
tar reader: Improve LFS support on 32 bit systems
@
text
@d2 1
a2 1
@
1.14
log
@bsdtar libarchive: updated to 3.7.9
3.7.9
Important bugfixes:
a regression in libarchive 3.7.8 regarding GNU sparse entries was fixed
3.7.8
Security fixes:
tar reader: Handle truncation in the middle of a GNU long linkname
unzip: fix null pointer dereference
tar reader: fix unchecked return value in list_item_verbose()
Important bugfixes:
7zip reader: add SPARC
tar reader: Ignore ustar size when pax size is present
tar writer: Fix bug when -s/a/b/ used more than once with b flag
cpio: Fix a Y2038 bug on Windows
libarchive: Handle ARCHIVE_FILTER_LZOP in archive_read_append_filter
libarchive: Adding missing seeker function to archive_read_open_FILE()
@
text
@d2 1
a2 1
@
1.13
log
@libarchive: updated to 3.7.7
Libarchive 3.7.7 is a bugfix and security release
Security fixes:
gzip: prevent a hang when processing a malformed gzip inside a gzip
tar: don't crash on truncated tar archives
tar: fix two leaks in tar header parsing
Important bugfixes:
7-zip: read/write symlink paths as UTF-8
cpio: exit with an error code if an entry could not be extracted
rar5: report encrypted entries
tar: fix truncation of entry pathnames in specific archives
windows: fix ARCHIVE_EXTRACT_SECURE_NOABSOLUTEPATHS
Libarchive 3.7.6 is a bugfix and security release.
This release fixes a tar regression introduced in libarchive 3.7.5
Important bugfixes.
tar: clean up linkpath between entries
tar: fix memory leaks when processing symlinks or parsing pax headers
iso: be more cautious about parsing ISO-9660 timestamps
@
text
@d2 1
a2 1
@
1.12
log
@libarchive: updated to 3.7.5
Libarchive 3.7.5
Security fixes:
fix multiple vulnerabilities identified by SAST
cpio: ignore out-of-range gid/uid/size/ino and harden AFIO parsing
lzop: prevent integer overflow
rar4: protect copy_from_lzss_window_to_unp()
rar4: fix CVE-2024-26256
rar4: fix OOB in delta and audio filter
rar4: fix out of boundary access with large files
rar4: add boundary checks to rgb filter
rar4: fix OOB access with unicode filenames
rar5: clear 'data ready' cache on window buffer reallocs
rpm: calculate huge header sizes correctly
unzip: unify EOF handling
util: fix out of boundary access in mktemp functions
uu: stop processing if lines are too long
Important bugfixes:
7zip: fix issue when skipping first file in 7zip archive that is a multiple of 65536 bytes
ar: fix archive entries having no type
lha: do not allow negative file sizes
lha: fix integer truncation on 32-bit systems
shar: check strdup return value
rar5: don't try to read rediculously long names
xar: fix another infinite loop and expat error handling
many Windows fixes, cleanups and improvements
@
text
@d1 2
a2 2
d23 1
a23 1
MTREE(5) BSD File Formats Manual MTREE(5)
d27 2
a28 2
mtree — format of
mtree dir hierarchy files
d32 1
a32 1
The mtree format is a
d37 2
a38 5
General
Format
An mtree file consists of a series of lines, each
providing information about a single filesystem object.
Leading whitespace is always ignored.
d40 5
a44 1
When encoding
d52 1
a52 1
Each line is
d57 1
a57 1
Blank lines are
d62 1
a62 1
Lines beginning
d67 1
a67 1
Lines beginning
d73 1
a73 1
If the first
d81 1
a81 1
As a special
d88 1
a88 1
If the first
d94 1
a94 1
Some tools that
d100 5
a104 3
Special
commands
Two special commands are currently defined:
d108 1
a108 1
This command
d117 1
a117 1
This command
a121 8
Keywords
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.
d123 10
a132 1
Currently
d137 1
a137 1
The checksum of
d139 1
a139 1
cksum(1) utility.
d143 1
a143 1
The device
d152 1
a152 1
A device with major,
d159 1
a159 1
Opaque number (as stored on the
d162 1
a162 1
The following
d169 2
a170 2
See mknod(8)
for more details.
d174 1
a174 1
The full
d179 3
a181 3
The file flags
as a symbolic name. See chflags(1) for information on these
names. If no flags are to be set the string
d187 1
a187 1
The file group
d192 1
a192 1
The file group
d197 1
a197 1
Ignore any file
d202 1
a202 1
The inode
d207 1
a207 1
The target of
d212 1
a212 1
The MD5 message
d217 1
a217 1
A synonym for
d222 1
a222 1
The current
d228 1
a228 1
The number of
d233 1
a233 1
Make sure this
d239 1
a239 1
The file is
d245 1
a245 1
The
d252 1
a252 1
The RIPEMD160 message digest of
d257 1
a257 1
A synonym for
d262 1
a262 1
A synonym for
d267 1
a267 1
The FIPS 160-1
d272 1
a272 1
A synonym for
d277 1
a277 1
The FIPS 180-2
d282 1
a282 1
A synonym for
d287 1
a287 1
The FIPS 180-2
d292 1
a292 1
A synonym for
d297 1
a297 1
The FIPS 180-2
d302 1
a302 1
A synonym for
d307 1
a307 1
The size, in
d312 1
a312 1
The last
d317 1
a317 1
The type of the
d322 1
a322 1
block special
d327 1
a327 1
character
d332 1
a332 1
directory
d336 1
a336 1
fifo
d340 1
a340 1
regular
d345 1
a345 1
symbolic
d350 1
a350 1
socket
d354 1
a354 1
The file owner
d359 1
a359 1
The file owner
d364 2
a365 1
cksum(1), find(1), mtree(8)
d369 1
a369 1
The mtree utility
d372 7
a378 9
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.
BSD
September 4, 2013 BSD
@
1.11
log
@libarchive: updated to 3.7.4
Libarchive 3.7.4 is a bugfix and security release
Security fixes:
rar: Fix OOB in rar e8 filter (CVE-2024-26256)
zip: Fix out of boundary access
Important bugfixes:
7zip: Limit amount of properties
bsdtar: Fix error handling around strtol() usages
passphrase: Improve newline handling on Windows
passphrase: Never allow empty passwords
rar: Fix "File CRC Error" when extracting specific rar4 archives
xar: Avoid infinite link loop
zip: Update AppleDouble support for directories
zstd: Implement core detection
@
text
@d2 1
a2 1
@
1.10
log
@libarchive: updated to 3.7.3
Libarchive 3.7.3 is a feature, security and bugfix release.
New features:
PCRE2 support
add trailing letter b to bsdtar(1) substitute pattern
add support for long options "--group" and "--owner" to tar(1)
Security fixes:
Fix possible vulnerability in tar error reporting introduced in f27c173
Important bugfixes:
ISO9660: preserve the natural order of links
rar5: fix decoding unicode filenames on Windows
rar5: fix infinite loop if during rar5 decompression the last block produced no data
xz filter: fix incorrect eof at the end of an lzip member
zip: fix end-of-data marker processing when decompressing zip archives
multiple bsdunzip(1) fixes
filetime truncation fix on Windows
@
text
@d2 1
a2 1
@
1.9
log
@libarchive: updated to 3.7.2
Libarchive 3.7.2 is a security, bugfix and feature release.
Security fixes:
Multiple vulnerabilities have been fixed in the PAX writer (1b4e0d0)
Important bugfixes:
bsdunzip(1) now correctly handles arguments following an -x after the zipfile
New features:
bsdunzip(1) now supports the "--version" flag
7-zip reader now translates Windows permissions into UNIX permissions
uudecode filter in raw mode now supports file name and file mode
zstd filter now supports the "long" write option
Libarchive 3.7.1 is a security, feature and bugfix release.
Security fixes:
SEGV and stack buffer overflow in verbose mode of cpio
Feature updates:
bsdunzip updated to match latest upstream code
Important bugfixes:
miscellaneous functional bugfixes
build fixes on multiple platforms
Libarchive 3.7.0 is a feature and bugfix release.
New features:
bsdunzip: new tool ported from FreeBSD
drop-in replacement for Info-ZIP unzip, not yet ported for Windows
7zip reader: support for Zstandard compression
7zip reader: support for ARM64 filter
zstd filter: support for multi-frame zstd archives
Other notable bugfixes and improvements:
pax: fix year 2038 problem on platforms with 64-bit time_t
Windows: Universal Windows Platform (UWP) fixes and improvements
Windows: bcrypt usage fixes and improvements
Windows: time function usage fixes and improvements
@
text
@d2 1
a2 1
@
1.8
log
@libarchive: Update to 3.4.3
Libarchive 3.4.3 is a feature and bugfix release.
New features:
support for pzstd compressed files (#1357)
support for RHT.security.selinux tar extended attribute (#1348)
Important bugfixes:
various zstd fixes and improvements (#1342 #1352 #1359)
child process handling fixes (#1372)
Libarchive 3.4.2 is a feature and security release.
New features:
support for atomic file extraction (bsdtar -x --safe-writes) (#1289)
support for mbed TLS (PolarSSL) (#1301)
Important bugfixes:
security fixes in RAR5 reader (#1280 #1326)
compression buffer fix in XAR writer (#1317)
fix uname and gname longer than 32 characters in PAX writer (#1319)
fix segfault when archiving hard links in ISO9660 and XAR writers (#1325)
fix support for extracting 7z archive entries with Delta filter (#987)
Libarchive 3.4.1 is a feature and security release.
New features:
Unicode filename support for reading lha/lzh archives
New pax write option "xattrhdr"
Important bugfixes:
security fixes in wide string processing (#1276 #1298)
security fixes in RAR5 reader (#1212 #1217 #1296)
security fixes and optimizations to write filter logic (#351)
security fix related to use of readlink(2) (1dae5a5)
sparse file handling fixes (#1218 #1260)
Thanks to all contributors and bug reporters.
Special thanks to Christos Zoulas (@@zoulasc) from NetBSD for the atomic file extraction feature.
@
text
@d1 2
a2 2
d178 2
a179 2
’’none’’ may be used to override the
current default.
d242 3
a244 3
’’resident’’ device number of the
file, e.g. the ID of the device that contains the file. Its
format is the same as the one for device.
d264 1
a264 2
(’’SHA-1’’) message digest of the
file.
d274 1
a274 2
(’’SHA-256’’) message digest of the
file.
d284 1
a284 2
(’’SHA-384’’) message digest of the
file.
d294 1
a294 2
(’’SHA-512’’) message digest of the
file.
d372 1
a372 2
’’full’’ entry format was added by
NetBSD.
@
1.7
log
@Update for libarchive-3.4.0:
- improvements for Android APK and JAR archives
- better support for non-recursive list and extract
- tar --exclude-vcs support
- fixes for file attributes and flags handling
- zipx support
- rar 5.0 reader
@
text
@d1 2
a2 2
d178 2
a179 2
“none” may be used to override the current
default.
d242 3
a244 3
“resident” device number of the file, e.g. the
ID of the device that contains the file. Its format is the
same as the one for device.
d264 2
a265 1
(“SHA-1”) message digest of the file.
d275 2
a276 1
(“SHA-256”) message digest of the file.
d286 2
a287 1
(“SHA-384”) message digest of the file.
d297 2
a298 1
(“SHA-512”) message digest of the file.
d366 1
a366 2
BUGS
HISTORY
d376 2
a377 1
“full” entry format was added by NetBSD.
@
1.6
log
@libarchive: updated to 3.3.3
libarchive 3.3.3:
Avoid super-linear slowdown on malformed mtree files
Many fixes for building with Visual Studio
NO_OVERWRITE doesn't change existing directory attributes
New support for Zstandard read and write filters
@
text
@d1 2
a2 2
d178 2
a179 2
’’none’’ may be used to override the
current default.
d242 3
a244 3
’’resident’’ device number of the
file, e.g. the ID of the device that contains the file. Its
format is the same as the one for device.
d264 1
a264 2
(’’SHA-1’’) message digest of the
file.
d274 1
a274 2
(’’SHA-256’’) message digest of the
file.
d284 1
a284 2
(’’SHA-384’’) message digest of the
file.
d294 1
a294 2
(’’SHA-512’’) message digest of the
file.
d373 1
a373 2
’’full’’ entry format was added by
NetBSD.
@
1.5
log
@Merge for libarchive-3.3.2.
@
text
@d2 1
a2 1
@
1.4
log
@Merge libarchive-3.3.1.
@
text
@d2 1
a2 1
d46 4
a49 4
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.
d178 1
a178 1
‘‘none’’ may be used to override the
d242 1
a242 1
‘‘resident’’ device number of the
d264 1
a264 1
(‘‘SHA-1’’) message digest of the
d275 1
a275 1
(‘‘SHA-256’’) message digest of the
d286 1
a286 1
(‘‘SHA-384’’) message digest of the
d297 1
a297 1
(‘‘SHA-512’’) message digest of the
d370 9
a378 9
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.
@
1.3
log
@Update for libarchive 3.2.1.
@
text
@d2 1
a2 1
d178 1
a178 1
’’none’’ may be used to override the
d242 1
a242 1
’’resident’’ device number of the
d264 1
a264 1
(’’SHA-1’’) message digest of the
d275 1
a275 1
(’’SHA-256’’) message digest of the
d286 1
a286 1
(’’SHA-384’’) message digest of the
d297 1
a297 1
(’’SHA-512’’) message digest of the
d377 1
a377 1
The ’’full’’ entry format was added
@
1.2
log
@Changes 3.1.2:
This is a maintenance update to fix issues with the new RAR seeking
feature. This new release also contains fixes for build failures when
building libarchive using Visual Studio 2012 and MinGW.
@
text
@d1 2
a2 2
a53 10
Signature
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’’.
d137 31
d196 5
d233 13
d283 22
d366 2
a367 9
BUGS
The FreeBSD implementation of
mtree does not currently support the mtree 2.0
format. The requirement for a
’’#mtree’’ signature line is new and
not yet widely implemented.
HISTORY
d380 2
a381 2
BSD May 6,
2008 BSD
@
1.1
log
@Initial revision
@
text
@d1 2
a2 2
d11 4
a14 3
p { margin-top: 0; margin-bottom: 0; }
pre { margin-top: 0; margin-bottom: 0; }
table { margin-top: 0; margin-bottom: 0; }
d23 1
a23 2
MTREE(5) FreeBSD File Formats Manual
MTREE(5)
d25 1
a25 1
NAME
d27 1
a27 1
mtree — format of
d30 1
d32 1
a32 3
DESCRIPTION
The mtree format is a
d37 1
a37 1
General
d43 1
a43 1
When encoding
d51 1
a51 1
Each line is
d54 1
a54 1
Signature
d56 1
a56 1
The first line
d58 1
a58 1
‘‘#mtree’’. If a file contains any
d60 2
a61 2
‘‘#mtree v2.0’’, otherwise, the
first line should begin with ‘‘#mtree
d64 1
a64 1
Blank
d66 1
a66 1
Blank lines are
d69 1
a69 1
Comment
d71 1
a71 1
Lines beginning
d74 1
a74 1
Special
d76 1
a76 1
Lines beginning
d80 1
a80 1
Relative
d82 1
a82 1
If the first
d88 1
a88 1
dot-dot
d90 1
a90 1
As a special
d95 1
a95 1
Full
d97 1
a97 1
If the first
d103 1
a103 1
Some tools that
d109 1
a109 1
Special
d113 1
a113 1
/set
d115 1
a115 1
This command
d122 1
a122 1
/unset
d124 1
a124 1
This command
d129 1
a129 1
Keywords
d138 1
a138 1
Currently
d141 1
a141 1
cksum
d143 1
a143 1
The checksum of
d147 1
d149 1
a149 3
contents
The full
d152 1
a152 1
flags
d154 1
a154 1
The file flags
d157 1
a157 1
‘‘none’’ may be used to override the
d160 1
a160 1
gid
d162 1
a162 1
The file group
d165 1
a165 1
gname
d167 1
a167 1
The file group
d170 1
a170 1
ignore
d172 1
a172 1
Ignore any file
d175 1
a175 1
link
d177 1
a177 1
The target of
d180 1
a180 1
md5
d182 1
a182 1
The MD5 message
d185 1
d187 1
a187 3
md5digest
A synonym for
d190 1
a190 1
mode
d192 1
a192 1
The current
d196 1
a196 1
nlink
d198 1
a198 1
The number of
d201 1
d203 1
a203 3
nochange
Make sure this
d207 1
d209 1
a209 3
ripemd160digest
The RIPEMD160 message digest of
d212 1
a212 1
rmd160
d214 1
a214 1
A synonym for
d217 1
d219 1
a219 3
rmd160digest
A synonym for
d222 1
a222 1
sha1
d224 2
a225 2
The FIPS 160-1
(‘‘SHA-1’’) message digest of the
d228 1
d230 1
a230 3
sha1digest
A synonym for
d233 1
a233 1
sha256
d235 2
a236 2
The FIPS 180-2
(‘‘SHA-256’’) message digest of the
d239 1
d241 1
a241 3
sha256digest
A synonym for
d244 1
a244 1
size
d246 1
a246 1
The size, in
d249 1
a249 1
time
d251 1
a251 1
The last
d254 1
a254 1
type
d256 1
a256 1
The type of the
d259 1
a259 1
block
d261 1
a261 1
block special
d264 1
a264 1
char
d266 1
a266 1
character
d269 1
a269 1
dir
d271 1
a271 1
directory
d273 1
a273 1
fifo
d275 1
a275 1
fifo
d277 1
a277 1
file
d279 1
a279 1
regular
d282 1
a282 1
link
d284 1
a284 1
symbolic
d287 1
a287 1
socket
d289 1
a289 1
socket
d291 1
a291 1
uid
d293 1
a293 1
The file owner
d296 1
a296 1
uname
d298 1
a298 1
The file owner
d301 1
a301 1
SEE ALSO
d303 1
a303 1
cksum(1), find(1), mtree(8)
d305 1
a305 1
BUGS
d307 1
a307 1
The FreeBSD implementation of
d310 1
a310 1
‘‘#mtree’’ signature line is new and
d313 1
a313 1
HISTORY
d315 1
a315 1
The mtree utility
d323 1
a323 1
The ‘‘full’’ entry format was added
d326 2
a327 3
FreeBSD 8.0
August 20, 2007 FreeBSD 8.0
@
1.1.1.1
log
@Import libarchive 2.8.0:
- Infrastructure:
- Allow command line tools as fallback for missing compression
libraries. If compiled without gzip for example, gunzip will
be used automatically.
- Improved support for a number of platforms like high-resolution
timestamps and Extended Attributes on various Unix systems
- New convience interface for creating archives based on disk content,
complement of the archive_write_disk interface.
- Frontends:
- bsdcpio ready for public consumption
- hand-written date parser replaces the yacc code
- Filter system:
- Simplified read filter chains
- Option support for filters
- LZMA, XZ, uudecode handled
- Format support:
- Write support for mtree files based on file system or archive
content
- Basic read support for Joliet
- Write support for zip files
- Write support for shar archives, both text-only and binary-safe
@
text
@@
1.1.1.2
log
@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
@
text
@d1 339
a339 622
%!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()0 12 Q()0 24 Q()36 36 Q
(August 20, 2007 MTREE 5)74.5 48 Q()36 72 Q 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()36 48 Q()0 60 Q
()-.15 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()-.35 E -.35(NA)36 24 S
(ME).35 E(
)36 36 Q(mtree)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
()36 72 Q 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(DESCRIPTION)36 12 Q(
)36 24 Q(The)0 36 Q
(mtree)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()-.15 E
(General F)36 24 Q(ormat)-.15 E(
)36 36 Q(An)0 48 Q(mtree)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()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(
)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(
)0 12 Q(- Signature
- )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(
- Blank
- )0 48 Q
(Blank lines are ignored.)0 60 Q(
- Comment
- )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
(#)0 24 Q(are ignored.)0 36 Q(
- Special
- )0 48 Q
(Lines be)0 60 Q(ginning with)-.15 E(/)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(
- Relati)0 36 Q -.15(ve)
-.25 G(
- ).15 E(If the \214rst whitespace-delimited w)0 48 Q
(ord has no)-.1 E(/)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(
- dot-dot
- )0 48 Q(As a special case, a relati)0 60
Q .3 -.15(ve e)-.25 H(ntry with the \214lename).15 E
(
..)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
( - Full
- )0 36 Q(If the \214rst whitespace-delimited w)0 48 Q
(ord has a)-.1 E(/)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
(
)0 48 Q()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(mtree)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(
)36
72 Q 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(Special commands)36 12 Q(
)36 24 Q -1 -.8
(Tw o)0 36 T(special commands are currently de\214ned:)3.3 E
()0 48 Q(- /set
- )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
(
- /unset
- )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(/set)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(
)0
60 Q().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
(
)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()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(
)0 72 Q 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(- cksum
- )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
(cksum\(1\))0 48 Q(utility)0 60 Q(.)
-.65 E(
- contents
- )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(
- \215ags
- )0 24 Q
(The \214le \215ags as a symbolic name.)0 36 Q(See)0 48 Q
(ch\215ags\(1\))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(
- gid
- )0
48 Q(The \214le group as a numeric v)0 60 Q(alue.)-.25 E
(
- gname
- )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
(
- ignore
- )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(
- link
- )0 48 Q(The tar)0 60 Q
(get of the symbolic link when type=link.)-.18 E
(
- md5
- )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
(
- md5digest
- )0 24 Q 2.5(As)0 36 S(ynon)-2.5 E
(ym for)-.15 E(md5.)0 48 Q(
- mode
- )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
(
- nlink
- )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(
- nochange
- )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
(
- ripemd160digest
- )0 72 Q 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q
(RIPEMD160)0 24 Q
(message digest of the \214le.)0 36 Q(
- rmd160
- )0
48 Q 2.5(As)0 60 S(ynon)-2.5 E(ym for)-.15 E
(ripemd160digest.)0 72 Q 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
- rmd160digest
- )0 12 Q 2.5
(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(ripemd160digest.)0 36
Q(
- sha1
- )0 48 Q(The)0 60 Q
(FIPS)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
(`SHA-1')-.74 E('\))-.74 E
(message digest of the \214le.)0 36 Q
(
- sha1digest
- )0 48 Q 2.5(As)0 60 S(ynon)-2.5 E
(ym for)-.15 E(sha1.)0 72 Q 0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
- sha256
- )0 12 Q(The)0 24
Q(FIPS)0 36 Q(180-2)0 48 Q
(\(`)0 60 Q(`SHA-256')-.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(
- sha256digest
- )0 12 Q 2.5
(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(sha256.)0 36 Q
(
- size
- )0 48 Q
(The size, in bytes, of the \214le.)0 60 Q
(
- time
- )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(
- type
- )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(
)36 48 Q(
)0 60 Q
(- block
- )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
(
- char
- )0 24 Q(character special de)0 36 Q(vice)-.25
E(
- dir
- )0 48 Q(directory)0 60 Q
(
- \214fo
- )0 72 Q 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(\214fo)0 12 Q(
- \214le
- )0 24
Q(re)0 36 Q(gular \214le)-.15 E(
- link
- )0 48 Q
(symbolic link)0 60 Q(
- sock)0 72 Q(et
- )-.1 E 0 Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(sock)0 12 Q(et)-.1 E(
)0 24 Q
( - uid
- )0 36 Q(The \214le o)0 48 Q
(wner as a numeric v)-.25 E(alue.)-.25 E(
- uname
- )
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(
)0 12 Q()36 24 Q(
)36
36 Q(SEE ALSO)36 48 Q(
)36 60 Q
(cksum\(1\),)0 72 Q 0 Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(\214nd\(1\),)
0 12 Q(mtree\(8\))0 24 Q()-.1 E -.1(BU)36 48 S(GS).1 E(
)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
(mtree)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()-.65 E(HIST)36 60 Q(OR)-.18 E(Y)-.65 E(
)36 72 Q 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q(mtree)0 24 Q
(utility appeared in)0 36 Q(4.3BSDReno.)0 48 Q(The)0 60 Q
(MD5)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
(cksum\(1\).)0 48 Q(The)0 60 Q
(SHA-1)0 72 Q 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(and)0 12 Q
(RIPEMD160)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(MD5.)0 72 Q 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q
(SHA-256)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()0 12 Q()0 24 Q 0 Cg EP
%%Trailer
end
%%EOF
@
1.1.1.3
log
@libarchive-2.8.3: Build fix for Linux
@
text
@d1 622
a622 339
MTREE(5) FreeBSD File Formats Manual
MTREE(5)
NAME
mtree — format of
mtree dir hierarchy files
DESCRIPTION
The mtree format is a
textual format that describes a collection of filesystem
objects. Such files are typically used to create or verify
directory hierarchies.
General
Format
An mtree file consists of a series of lines, each
providing information about a single filesystem object.
Leading whitespace is always ignored.
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.
Each line is
interpreted independently as one of the following types:
Signature
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’’.
Blank
Blank lines are
ignored.
Comment
Lines beginning
with # are ignored.
Special
Lines beginning
with / are special commands that influence the
interpretation of later lines.
Relative
If the first
whitespace-delimited word has no / characters, it is
the name of a file in the current directory. Any relative
entry that describes a directory changes the current
directory.
dot-dot
As a special
case, a relative entry with the filename .. changes
the current directory to the parent directory. Options on
dot-dot entries are always ignored.
Full
If the first
whitespace-delimited word has a / 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.
Some tools that
process mtree 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.
Special
commands
Two special commands are currently defined:
/set
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.
/unset
This command
removes any default value set by a previous /set
command. It is followed on the same line by one or more
keywords separated by whitespace.
Keywords
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.
Currently
supported keywords are as follows:
cksum
The checksum of
the file using the default algorithm specified by the
cksum(1) utility.
contents
The full
pathname of a file that holds the contents of this file.
flags
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.
gid
The file group
as a numeric value.
gname
The file group
as a symbolic name.
ignore
Ignore any file
hierarchy below this file.
link
The target of
the symbolic link when type=link.
md5
The MD5 message
digest of the file.
md5digest
A synonym for
md5.
mode
The current
file’s permissions as a numeric (octal) or symbolic
value.
nlink
The number of
hard links the file is expected to have.
nochange
Make sure this
file or directory exists but otherwise ignore all
attributes.
ripemd160digest
The RIPEMD160 message digest of
the file.
rmd160
A synonym for
ripemd160digest.
rmd160digest
A synonym for
ripemd160digest.
sha1
The FIPS 160-1
(‘‘SHA-1’’) message digest of the
file.
sha1digest
A synonym for
sha1.
sha256
The FIPS 180-2
(‘‘SHA-256’’) message digest of the
file.
sha256digest
A synonym for
sha256.
size
The size, in
bytes, of the file.
time
The last
modification time of the file.
type
The type of the
file; may be set to any one of the following:
block
block special
device
char
character
special device
dir
directory
fifo
fifo
file
regular
file
link
symbolic
link
socket
socket
uid
The file owner
as a numeric value.
uname
The file owner
as a symbolic name.
SEE ALSO
cksum(1), find(1), mtree(8)
BUGS
The FreeBSD implementation of
mtree does not currently support the mtree 2.0
format. The requirement for a
‘‘#mtree’’ signature line is new and
not yet widely implemented.
HISTORY
The mtree 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.
FreeBSD 9.0
August 20, 2007 FreeBSD 9.0
@
1.1.1.4
log
@Import libarchive-2.8.4:
- Improved reliability of hash function detection
- Fix issues on ancient FreeBSD, QNX, ancient NetBSD and Minix
@
text
@d1 339
a339 622
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Wed Jun 30 11:55:53 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()0 12 Q()0 24 Q()36 36 Q
(August 20, 2007 MTREE 5)74.5 48 Q()36 72 Q 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()36 48 Q()0 60 Q
()-.15 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()-.35 E -.35(NA)36 24 S
(ME).35 E(
)36 36 Q(mtree)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
()36 72 Q 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(DESCRIPTION)36 12 Q(
)36 24 Q(The)0 36 Q
(mtree)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()-.15 E
(General F)36 24 Q(ormat)-.15 E(
)36 36 Q(An)0 48 Q(mtree)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()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(
)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(
)0 12 Q(- Signature
- )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(
- Blank
- )0 48 Q
(Blank lines are ignored.)0 60 Q(
- Comment
- )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
(#)0 24 Q(are ignored.)0 36 Q(
- Special
- )0 48 Q
(Lines be)0 60 Q(ginning with)-.15 E(/)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(
- Relati)0 36 Q -.15(ve)
-.25 G(
- ).15 E(If the \214rst whitespace-delimited w)0 48 Q
(ord has no)-.1 E(/)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(
- dot-dot
- )0 48 Q(As a special case, a relati)0 60
Q .3 -.15(ve e)-.25 H(ntry with the \214lename).15 E
(
..)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
( - Full
- )0 36 Q(If the \214rst whitespace-delimited w)0 48 Q
(ord has a)-.1 E(/)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
(
)0 48 Q()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(mtree)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(
)36
72 Q 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(Special commands)36 12 Q(
)36 24 Q -1 -.8
(Tw o)0 36 T(special commands are currently de\214ned:)3.3 E
()0 48 Q(- /set
- )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
(
- /unset
- )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(/set)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(
)0
60 Q().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
(
)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()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(
)0 72 Q 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(- cksum
- )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
(cksum\(1\))0 48 Q(utility)0 60 Q(.)
-.65 E(
- contents
- )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(
- \215ags
- )0 24 Q
(The \214le \215ags as a symbolic name.)0 36 Q(See)0 48 Q
(ch\215ags\(1\))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(
- gid
- )0
48 Q(The \214le group as a numeric v)0 60 Q(alue.)-.25 E
(
- gname
- )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
(
- ignore
- )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(
- link
- )0 48 Q(The tar)0 60 Q
(get of the symbolic link when type=link.)-.18 E
(
- md5
- )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
(
- md5digest
- )0 24 Q 2.5(As)0 36 S(ynon)-2.5 E
(ym for)-.15 E(md5.)0 48 Q(
- mode
- )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
(
- nlink
- )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(
- nochange
- )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
(
- ripemd160digest
- )0 72 Q 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q
(RIPEMD160)0 24 Q
(message digest of the \214le.)0 36 Q(
- rmd160
- )0
48 Q 2.5(As)0 60 S(ynon)-2.5 E(ym for)-.15 E
(ripemd160digest.)0 72 Q 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
- rmd160digest
- )0 12 Q 2.5
(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(ripemd160digest.)0 36
Q(
- sha1
- )0 48 Q(The)0 60 Q
(FIPS)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
(`SHA-1')-.74 E('\))-.74 E
(message digest of the \214le.)0 36 Q
(
- sha1digest
- )0 48 Q 2.5(As)0 60 S(ynon)-2.5 E
(ym for)-.15 E(sha1.)0 72 Q 0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
- sha256
- )0 12 Q(The)0 24
Q(FIPS)0 36 Q(180-2)0 48 Q
(\(`)0 60 Q(`SHA-256')-.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(
- sha256digest
- )0 12 Q 2.5
(As)0 24 S(ynon)-2.5 E(ym for)-.15 E(sha256.)0 36 Q
(
- size
- )0 48 Q
(The size, in bytes, of the \214le.)0 60 Q
(
- time
- )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(
- type
- )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(
)36 48 Q(
)0 60 Q
(- block
- )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
(
- char
- )0 24 Q(character special de)0 36 Q(vice)-.25
E(
- dir
- )0 48 Q(directory)0 60 Q
(
- \214fo
- )0 72 Q 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(\214fo)0 12 Q(
- \214le
- )0 24
Q(re)0 36 Q(gular \214le)-.15 E(
- link
- )0 48 Q
(symbolic link)0 60 Q(
- sock)0 72 Q(et
- )-.1 E 0 Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(sock)0 12 Q(et)-.1 E(
)0 24 Q
( - uid
- )0 36 Q(The \214le o)0 48 Q
(wner as a numeric v)-.25 E(alue.)-.25 E(
- uname
- )
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(
)0 12 Q()36 24 Q(
)36
36 Q(SEE ALSO)36 48 Q(
)36 60 Q
(cksum\(1\),)0 72 Q 0 Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(\214nd\(1\),)
0 12 Q(mtree\(8\))0 24 Q()-.1 E -.1(BU)36 48 S(GS).1 E(
)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
(mtree)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()-.65 E(HIST)36 60 Q(OR)-.18 E(Y)-.65 E(
)36 72 Q 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q(mtree)0 24 Q
(utility appeared in)0 36 Q(4.3BSDReno.)0 48 Q(The)0 60 Q
(MD5)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
(cksum\(1\).)0 48 Q(The)0 60 Q
(SHA-1)0 72 Q 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(and)0 12 Q
(RIPEMD160)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(MD5.)0 72 Q 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The)0 12 Q
(SHA-256)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()0 12 Q()0 24 Q 0 Cg EP
%%Trailer
end
%%EOF
@
1.1.1.5
log
@Import libarchive-3.2.1:
- security fixes and other bugfixes
- support for multhreading in xz 5.2+
@
text
@d1 622
a622 384
MTREE(5) BSD File Formats Manual MTREE(5)
NAME
mtree — format of
mtree dir hierarchy files
DESCRIPTION
The mtree format is a
textual format that describes a collection of filesystem
objects. Such files are typically used to create or verify
directory hierarchies.
General
Format
An mtree file consists of a series of lines, each
providing information about a single filesystem object.
Leading whitespace is always ignored.
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.
Each line is
interpreted independently as one of the following types:
Blank
Blank lines are
ignored.
Comment
Lines beginning
with # are ignored.
Special
Lines beginning
with / are special commands that influence the
interpretation of later lines.
Relative
If the first
whitespace-delimited word has no / characters, it is
the name of a file in the current directory. Any relative
entry that describes a directory changes the current
directory.
dot-dot
As a special
case, a relative entry with the filename .. changes
the current directory to the parent directory. Options on
dot-dot entries are always ignored.
Full
If the first
whitespace-delimited word has a / 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.
Some tools that
process mtree 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.
Special
commands
Two special commands are currently defined:
/set
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.
/unset
This command
removes any default value set by a previous /set
command. It is followed on the same line by one or more
keywords separated by whitespace.
Keywords
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.
Currently
supported keywords are as follows:
cksum
The checksum of
the file using the default algorithm specified by the
cksum(1) utility.
device
The device
number for block or char file types. The value
must be one of the following forms:
format,major,minor[
,subunit]
A device with major,
minor and optional subunit fields. Their
meaning is specified by the operating’s system
format. See below for valid formats.
number
Opaque number (as stored on the
file system).
The following
values for format are recognized: native,
386bsd, 4bsd, bsdos, freebsd,
hpux, isc, linux, netbsd,
osf1, sco, solaris, sunos,
svr3, svr4, and ultrix.
See mknod(8)
for more details.
contents
The full
pathname of a file that holds the contents of this file.
flags
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.
gid
The file group
as a numeric value.
gname
The file group
as a symbolic name.
ignore
Ignore any file
hierarchy below this file.
inode
The inode
number.
link
The target of
the symbolic link when type=link.
md5
The MD5 message
digest of the file.
md5digest
A synonym for
md5.
mode
The current
file’s permissions as a numeric (octal) or symbolic
value.
nlink
The number of
hard links the file is expected to have.
nochange
Make sure this
file or directory exists but otherwise ignore all
attributes.
optional
The file is
optional; do not complain about the file if it is not in the
file hierarchy.
resdevice
The
’’resident’’ device number of the
file, e.g. the ID of the device that contains the file. Its
format is the same as the one for device.
ripemd160digest
The RIPEMD160 message digest of
the file.
rmd160
A synonym for
ripemd160digest.
rmd160digest
A synonym for
ripemd160digest.
sha1
The FIPS 160-1
(’’SHA-1’’) message digest of the
file.
sha1digest
A synonym for
sha1.
sha256
The FIPS 180-2
(’’SHA-256’’) message digest of the
file.
sha256digest
A synonym for
sha256.
sha384
The FIPS 180-2
(’’SHA-384’’) message digest of the
file.
sha384digest
A synonym for
sha384.
sha512
The FIPS 180-2
(’’SHA-512’’) message digest of the
file.
sha512digest
A synonym for
sha512.
size
The size, in
bytes, of the file.
time
The last
modification time of the file.
type
The type of the
file; may be set to any one of the following:
block
block special
device
char
character
special device
dir
directory
fifo
fifo
file
regular
file
link
symbolic
link
socket
socket
uid
The file owner
as a numeric value.
uname
The file owner
as a symbolic name.
SEE ALSO
cksum(1), find(1), mtree(8)
BUGS
HISTORY
The mtree 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.
BSD
September 4, 2013 BSD
@
1.1.1.6
log
@Import libarchive-3.3.1.
@
text
@d2 1
a2 1
d178 1
a178 1
‘‘none’’ may be used to override the
d242 1
a242 1
‘‘resident’’ device number of the
d264 1
a264 1
(‘‘SHA-1’’) message digest of the
d275 1
a275 1
(‘‘SHA-256’’) message digest of the
d286 1
a286 1
(‘‘SHA-384’’) message digest of the
d297 1
a297 1
(‘‘SHA-512’’) message digest of the
d377 1
a377 1
The ‘‘full’’ entry format was added
@
1.1.1.7
log
@Import libarchive-3.3.2 + 9de5f3 + f9dacbf:
- Support NFS4 ACLs on Linux
- Bugfixes
@
text
@d2 1
a2 1
d46 4
a49 4
as 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.
d178 1
a178 1
’’none’’ may be used to override the
d242 1
a242 1
’’resident’’ device number of the
d264 1
a264 1
(’’SHA-1’’) message digest of the
d275 1
a275 1
(’’SHA-256’’) message digest of the
d286 1
a286 1
(’’SHA-384’’) message digest of the
d297 1
a297 1
(’’SHA-512’’) message digest of the
d370 9
a378 9
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.
@
1.1.1.8
log
@Import libarchive-3.3.3 as should have done originally.
@
text
@d2 1
a2 1
@
1.1.1.9
log
@Import libarchive 3.4.0
@
text
@d1 2
a2 2
d178 2
a179 2
“none” may be used to override the current
default.
d242 3
a244 3
“resident” device number of the file, e.g. the
ID of the device that contains the file. Its format is the
same as the one for device.
d264 2
a265 1
(“SHA-1”) message digest of the file.
d275 2
a276 1
(“SHA-256”) message digest of the file.
d286 2
a287 1
(“SHA-384”) message digest of the file.
d297 2
a298 1
(“SHA-512”) message digest of the file.
d377 2
a378 1
“full” entry format was added by NetBSD.
@
1.1.1.10
log
@Import libarchive 3.7.2
@
text
@d2 1
a2 1
d362 2
a363 1
HISTORY
@
1.1.1.11
log
@libarchive: import version 3.7.3
@
text
@d2 1
a2 1
@
1.1.1.12
log
@Libarchive 3.7.4 is a bugfix and security release
Security fixes:
rar: Fix OOB in rar e8 filter (CVE-2024-26256)
zip: Fix out of boundary access
Important bugfixes:
7zip: Limit amount of properties
bsdtar: Fix error handling around strtol() usages
passphrase: Improve newline handling on Windows
passphrase: Never allow empty passwords
rar: Fix "File CRC Error" when extracting specific rar4 archives
xar: Avoid infinite link loop
zip: Update AppleDouble support for directories
zstd: Implement core detection
@
text
@d2 1
a2 1
@
1.1.1.13
log
@libarchive: imported version 3.7.5
Libarchive 3.7.5
Security fixes:
fix multiple vulnerabilities identified by SAST
cpio: ignore out-of-range gid/uid/size/ino and harden AFIO parsing
lzop: prevent integer overflow
rar4: protect copy_from_lzss_window_to_unp()
rar4: fix CVE-2024-26256
rar4: fix OOB in delta and audio filter
rar4: fix out of boundary access with large files
rar4: add boundary checks to rgb filter
rar4: fix OOB access with unicode filenames
rar5: clear 'data ready' cache on window buffer reallocs
rpm: calculate huge header sizes correctly
unzip: unify EOF handling
util: fix out of boundary access in mktemp functions
uu: stop processing if lines are too long
Important bugfixes:
7zip: fix issue when skipping first file in 7zip archive that is a multiple of 65536 bytes
ar: fix archive entries having no type
lha: do not allow negative file sizes
lha: fix integer truncation on 32-bit systems
shar: check strdup return value
rar5: don't try to read rediculously long names
xar: fix another infinite loop and expat error handling
many Windows fixes, cleanups and improvements
@
text
@d2 1
a2 1
@
1.1.1.14
log
@libarchove: import version 3.7.7
@
text
@d1 2
a2 2
d23 1
a23 1
MTREE(5) File Formats Manual MTREE(5)
d27 2
a28 2
mtree — format of mtree
dir hierarchy files
d32 1
a32 1
The mtree format is a
d37 5
a41 2
General
Format
d43 1
a43 5
An mtree file consists of
a series of lines, each providing information about a single
filesystem object. Leading whitespace is always ignored.
When encoding
d51 1
a51 1
Each line is
d56 1
a56 1
Blank lines are
d61 1
a61 1
Lines beginning
d66 1
a66 1
Lines beginning
d72 1
a72 1
If the first
d80 1
a80 1
As a special
d87 1
a87 1
If the first
d93 1
a93 1
Some tools that
d99 3
a101 5
Special
commands
Two special commands are
currently defined:
d105 1
a105 1
This command
d114 1
a114 1
This command
d119 8
d128 1
a128 10
Keywords
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.
Currently
d133 1
a133 1
The checksum of
d135 1
a135 1
cksum(1) utility.
d139 1
a139 1
The device
d148 1
a148 1
A device with major,
d155 1
a155 1
Opaque number (as stored on the
d158 1
a158 1
The following
d165 2
a166 2
See
mknod(8) for more details.
d170 1
a170 1
The full
d175 3
a177 3
The file flags
as a symbolic name. See chflags(1) for information on
these names. If no flags are to be set the string
d183 1
a183 1
The file group
d188 1
a188 1
The file group
d193 1
a193 1
Ignore any file
d198 1
a198 1
The inode
d203 1
a203 1
The target of
d208 1
a208 1
The MD5 message
d213 1
a213 1
A synonym for
d218 1
a218 1
The current
d224 1
a224 1
The number of
d229 1
a229 1
Make sure this
d235 1
a235 1
The file is
d241 1
a241 1
The
d248 1
a248 1
The RIPEMD160 message digest of
d253 1
a253 1
A synonym for
d258 1
a258 1
A synonym for
d263 1
a263 1
The FIPS 160-1
d268 1
a268 1
A synonym for
d273 1
a273 1
The FIPS 180-2
d278 1
a278 1
A synonym for
d283 1
a283 1
The FIPS 180-2
d288 1
a288 1
A synonym for
d293 1
a293 1
The FIPS 180-2
d298 1
a298 1
A synonym for
d303 1
a303 1
The size, in
d308 1
a308 1
The last
d313 1
a313 1
The type of the
d318 1
a318 1
block special
d323 1
a323 1
character
d328 1
a328 1
directory
d332 1
a332 1
fifo
d336 1
a336 1
regular
d341 1
a341 1
symbolic
d346 1
a346 1
socket
d350 1
a350 1
The file owner
d355 1
a355 1
The file owner
d360 1
a360 2
cksum(1), find(1),
mtree(8)
d364 1
a364 1
The mtree utility
d367 9
a375 7
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.
Debian September 4, 2013 MTREE(5)
@
1.1.1.15
log
@libarchive: imported version 3.7.9
@
text
@d2 1
a2 1
@
1.1.1.16
log
@libarchive: import version 3.8.0
Libarchive 3.8.0 is a feature and bugfix release.
New features:
bsdtar: support --mtime and --clamp-mtime
lib: mbedtls 3.x compatibility
7-zip reader: improve self-extracting archive detection
xar: xmllite support for the XAR reader and writer
zip writer: added XZ, LZMA, ZSTD and BZIP2 support
zip writer: added LZMA + RISCV BCJ filter
Notable security fixes:
rar: do not skip past EOF while reading
rar: fix double free with over 4 billion nodes
rar: fix heap-buffer-overflow
warc: prevent signed integer overflow
tar: fix overflow in build_ustar_entry
Notable bugfixes:
bsdtar: don't hardlink negative inode files together
gz: allow setting the original filename for gzip compressed files
lib: improve lseek handling
lib: support @@-prefixed Unix epoch timestamps as date strings
rar: support large headers on 32 bit systems
tar reader: Improve LFS support on 32 bit systems
@
text
@d2 1
a2 1
@
1.1.1.17
log
@libarchive: import version 3.8.1
@
text
@d2 1
a2 1
@
1.1.1.18
log
@libarchive: imported version 3.8.2
@
text
@d2 1
a2 1
@
1.1.1.19
log
@libarchive: import version 3.8.3
@
text
@d2 1
a2 1
@
1.1.1.20
log
@libarchive: import 3.8.4
@
text
@d2 1
a2 1
@
1.1.1.21
log
@libarchive: import version 3.8.5
@
text
@d2 1
a2 1
@
1.1.1.22
log
@libarchive: imported version 3.8.6
@
text
@d2 1
a2 1
@
1.1.1.23
log
@libarchive: imported version 3.8.7
@
text
@d2 1
a2 1
@