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