cogd - Clockwork Agent


cogd [options]

cogd -c /path/to/cogd.conf

cogd -Fv[vv...]


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.

cogd is the agent component of Clockwork that runs on managed hosts. It is responsible for retrieving the host's policy from a master server and taking whatever steps necessary to bring the host back into line with that policy.


-V, --version

Print version and copyright information, and then exit.

-c, --config /path/to/cogd.conf

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

-v, --verbose

Increase logging verbosity by one level.

-q, --quiet

Disable logging.

-F, --foreground

Normally, cogd 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.

-S, --show-config

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

-T, --trace

Enable TRACE mode on the Pendulum runtime. See clockwork(7) for details on Pendulum, including what it is, why we use it, and what you can do with it.



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


Lock file that is created to ensure that only a single configuration management run is undertaken at any one time. This lock governs cogd in foreground, one-off (-F1) mode and as a daemon.


If this file exists, cogd will refuse to start its configuration management run. This allows system admins to properly disable Clockwork temporarily. This applies to daemon and standalone modes.


clockwork(7), clockd(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