NAME
OpenBSD::Mtree - simple "mtree(8)" spec parser
SYNOPSIS
use OpenBSD::Mtree;
my %hier;
OpenBSD::Mtree::parse(\%hier, "/", "/etc/mtree/4.4BSD.dist", $extra);
DESCRIPTION
"OpenBSD::Mtree" is a parser for mtree(8) specifications that can reconstruct directory hierarchies.
The basic function "OpenBSD::Mtree::parse_fh(\%hash, $basedir, $fh, $extra)" will populate the hash $hash with defined entries for each directory seen while reading from $fh, assuming the specification is to be interpreted relative to $basedir (some canonicalization of directory names will occur).
If $extra is non null, each entry will itself be an empty hash.
"OpenBSD::Mtree:parse(\%hash, $basedir, $filename, $extra)" is a convenience function which also handles opening the filehandle from $filename and closing it after reading the specification.