NAME¶

dune-cache - Manage the shared artifacts cache

SYNOPSIS¶

dune cache [OPTION]... [ACTION]

DESCRIPTION¶

Dune is able to share build artifacts between workspaces. dune cache-daemon is a daemon that runs in the background and manages this shared cache. For instance, it makes sure that it does not grow too big and try to maximise sharing between the various workspaces that are using the shared cache.

The daemon is automatically started by Dune when the shared cache is enabled. You do not need to run this command manually.

ACTIONS¶

start starts the daemon if not already running.

stop stops the daemon.

trim removes oldest files from the cache to free space.

ARGUMENTS¶

ACTION

The cache-daemon action to perform (one of `start', `stop' or `trim')

OPTIONS¶

--exit-no-client (absent DUNE_CACHE_EXIT_NO_CLIENT env)

Whether to exit once all clients have disconnected

-f, --foreground

Whether to start in the foreground or as a daemon

--help[=FMT] (default=auto)

Show this help in format FMT. The value FMT must be one of `auto', `pager', `groff' or `plain'. With `auto', the format is `pager` or `plain' whenever the TERM env var is `dumb' or undefined.

--port-file=PATH (absent=/builddir/.cache/dune/db/runtime/dune-cache-daemon/port)

The file to read/write the daemon port from/to.

--root=PATH (absent=/builddir/.cache/dune/db)

Root of the dune cache

--size=BYTES

size to trim the cache to

--trimmed-size=BYTES

size to trim from the cache

--version

Show version information.

COMMON OPTIONS¶

These options are common to all commands.

--config-file=FILE

Load this configuration file instead of the default one.

--display=MODE

Control the display mode of Dune. See dune-config(5) for more details.

--no-config

Do not load the configuration file

--verbose

Same as --display verbose

MORE HELP¶

Use `dune COMMAND --help' for help on a single command.

ENVIRONMENT¶

These environment variables affect the execution of cache:

DUNE_CACHE_EXIT_NO_CLIENT

Whether to exit once all clients have disconnected

BUGS¶

Check bug reports at https://github.com/ocaml/dune/issues