FreeBSD Manual Pages
mapdir(1) Manpage for mapdir mapdir(1) NAME mapdir - Map directory structures SYNOPSIS mapdir [-dfhnpt] [-e excludes] [-s savefile] [-x excludes_file] [/path/to/file] DESCRIPTION The mapdir utility is used to map the structure of files and most no- tably folder hierarchies. Unless overridden with the -n or -s options, the results are stored in a report file in the invoking user's home di- rectory, according to the following naming convention: mapdir_path_to_file_date.txt. If the file mapped is a regular file, then mapdir also reports its size in bytes and the file's md5 or sha256 checksum. If upon invocation no argument is passed to mapdir, then the utility maps the structure of the current working directory. The utility mainly aims to facilitate verifying the consistency between two (or more) file hierarchies that contain the same files, as the gen- erated report files can subsequently be passed to the diff(1) utility. When using mapdir to this end, it should generally be invoked with the -f switch. OPTIONS -d only parse non-hidden files. -e excludes list of files to be excluded. -f omit reporting the name of the starting directory in the report file. -h use the sha256 message digest instead of md5. -n only print to stdout, i.e. don't generate a savefile. This op- tion overrides the -s option. -p print a tree view of the directory. This option requires the -f option to work and won't work with the -e or -x switches acti- vated. -s savefile save the report in ${HOME}/savefile. -t generate a statistical report of the kinds of files mapped. -x excludes_file read the files to be excluded from excludes_file. Entries are expected to contain the full path to file and are read line by line. EXAMPLES 1. Verify the consistency between /path/to/dir1 and /path/to/dir2: mapdir -fh -s dir1_map.txt /path/to/dir1 mapdir -fh -s dir2_map.txt /path/to/dir2 diff ~/dir1_map.txt ~/dir2_map.txt 2. Map the structure of /path/to/dir in a tree like view to stdout: mapdir -fnp /path/to/dir 3. Map the structure of /usr but exclude directories /usr/games and /usr/include: mapdir -s usr_directory.txt -e "/usr/games /usr/include" /usr SEE ALSO mapdircmp(1) BUGS Please report when found. AUTHOR Oliver Mahmoudi (contact@olivermahmoudi.com) mapdir 1.2.1 April 2020 mapdir(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | BUGS | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mapdir&sektion=1&manpath=FreeBSD+Ports+15.0>