cachedir man page

cachedir ā€” tag/untag/find cache directories

Synopsis

cachedir [--config=FILE] [--dump-config] [--dump-setting-names] [--generate-manpage=TEMPLATE] [-h] [--help] [--help-all] [--list-config-files] [--version] [--no-default-configs] [--dump-memory-profile=METHOD] [--log=FILE] [--log-keep=N] [--log-level=LEVEL] [--log-max=SIZE] [--log-mode=MODE] [--memory-dump-interval=SECONDS] [--output=FILE]

cachedir [options] help
cachedir [options] help-all

Description

cachedir tags directories as cache directories, or remotes such tags, or finds tagged directories. A cache directory tag is a file called CACHEDIR.TAG with a specific content. See the specification referenced from the "See Also" section for details.

Options

--generate-manpage=TEMPLATE

fill in manual page TEMPLATE

-h, --help

show this help message and exit

--output=FILE

write output to FILE, instead of standard output

--version

show program's version number and exit

Configuration files and settings

--config=FILE

add FILE to config files

--dump-config

write out the entire current configuration

--dump-setting-names

write out all names of settings and quit

--help-all

show all options

--list-config-files

list all possible config files

--no-default-configs

clear list of configuration files to read

Logging

--log=FILE

write log entries to FILE (default is to not write log files at all); use "syslog" to log to system log, "stderr" to log to the standard error output, or "none" to disable logging

--log-keep=N

keep last N logs (10)

--log-level=LEVEL

log at LEVEL, one of debug, info, warning, error, critical, fatal (default: debug)

--log-max=SIZE

rotate logs larger than SIZE, zero for never (default: 0)

--log-mode=MODE

set permissions of new log files to MODE (octal; default 0600)

Peformance

--dump-memory-profile=METHOD

make memory profiling dumps using METHOD, which is one of: none, simple, or meliae (default: simple)

--memory-dump-interval=SECONDS

make memory profiling dumps at least SECONDS apart

Example

To tag a directory as a cache directory:

    cachedir tag $HOME/.cache

To remove a cache directory tag:

    cachedir untag $HOME/.cache

To find all cache directories below your home directory:

    cachedir find $HOME

See Also

http://www.bford.info/cachedir/