clockd - Clockwork Master


clockd [options]

clockd -c /path/to/clockd.conf

clockd -Fvvv


Clockwork is a configuration management system designed to securely and correctly enforce configuration policies on lots of hosts.

It can ensure that files have the right attributes (owner, group, permissions, etc.) and content. It can maintain a specific set of installed packages, and even make sure that system user accounts exist.

clockd is the Policy Master component of Clockwork. It holds all of the policies for all managed systems, and gives them out to the clockd agents when they connect.

clockd is also responsible for hosting and serving file contents to clients that need to update file resources.


-V, --version

Print version and copyright information.

-c --config /path/to/clockd.conf

Specify the path to an alternate configuration file. If not given, the default configuration file (/etc/clockwork/clockd.conf) is used instead.

-q, --quiet

Disable logging.

-v, --verbose

Increase verbosity by one level. Can be used more than once.

-t, --test

Test clockd configuration and environment. Not only does this check config file and manifest syntax, it also checks the system filesystem to ensure that configured files and directories exist, and are readable or writable.

Administrators are strongly encouraged to run clockd -t whenever changing configuration.

-S, --show-config

Once clockd has determined its running configuration, have it print that to standard output and exit.

-F, --foreground

Normally, clockd forks into the background and detaches from the controlling terminal, so that it can run as a system service. This flag disabled that behavior. As a side effect, all logging will be forced to go to standard output, regardless of what syslog facility is specified in the configuration file.



Default configuration file that clockd reads on start up. See clockd.conf(5) for details.


clockwork(7), cogd(1), clockd.conf(5) and cogd.conf(5)


Clockwork was designed and written by James Hunt.

The Clockwork website is licensed under the Creative Commons Attribution-NoDerivs 3.0 United States License