Clockwork

cw-shell(1)

NAME

cw-shell - Clockwork Policy Shell

SYNOPSIS

cw-shell [options] /path/to/manifest/file

DESCRIPTION

Clockwork is a system configuration management system designed to securely enforce policies on one or more host systems. It can ensure that files have the prescribed 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.

cw-shell is a utility for administrators and policy developers that exposes the internals of a policy manifest, letting you explore how a policy would be implemented by the client agents.

OPTIONS

-e, --execute command

Execute arbitrary commands. Multiple commands must be separated by a semi-colon (;) with optional whitespace.

-h, --help

Show a brief summary of the options that cw-shell takes.

-v, --verbose

Increase the verbosity of cw-shell. Can be used multple times; each time it increases the log level by one.

Note: cw-shell doesn't log to a file, it write all log messages to standard output. If you wish to save cw-shell output, use your shell's IO redirection capabilities.

-V, --version

Print version and copyright information, and then exit. If specified, any command script is ignored, as well as the -e option.

EXIT STATUS

In interactive mode and script interpreter mode, cw-shell always exits with status 0.

If -e is used, cw-shell exits with status 0 if all commands completed successfully, and exits non-zero when the first command (which may be the only command) fails.

FILES

None

SEE ALSO

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

AUTHOR

Clockwork was designed and written by James Hunt.

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