cfengine(8)cfengine(8)NAMEcfagent - system configuration agent
SYNOPSIS
/usr/local/sbin/cfagent [options]
DESCRIPTION
cfengine is a language based system specifically designed for testing
and configuring unix-like systems attached to a TCP/IP network. You can
think of cfengine as a very high level language -- much higher level
than Perl or shell. A single statement can result in many hundreds of
links being created, or the permissions of many hundreds of files being
set. The idea of cfengine is to create a single file or set of configu‐
ration files which will describe the setup of every host on your net‐
work.
cfagent runs on every host and parses one file (or file-set), the con‐
figuration of the host is checked against this file and, if desired,
any deviations are fixed. cfagent reads a configuration file called
cfengine.conf in a directory pointed to by the environment variable
CFINPUTS. cfagent performs host integrity and security checks as well
as installing and repairing system configuration.
COMMAND LINE OPTIONS-a (--sysadm) Print only the name of the system administra‐
tor then quit.
-b (--force-net-copy) Forces net copy even if remote server is
localhost
-c (--no-check-files) Do not check access rights on file systems
-C (--no-check-mounts) Check mount points for consistency. If this
option is set then directories which lie in
the ”mount point“ area are checked to see
whether there is anything mounted on them.
-d (--debug) Enable debugging output. (parsing -d1,run,
-d2, lite -d3)
-D (--define) Define a compound class symbol of the form
alpha.beta.gamma.
-e (--no-edits) Suppress file editing.
-E (--enforce-links) Globally force links to be created where plain
files or links already exist. You have to use
this in interactive mode and answer a yes/no
query before cfagent will run like this.
-f (--file) Parse filename after this switch. By default
cfagent looks for a file called cfengine.conf
in the current directory.
-h (--help ) Help information. Display version banner and
options summary.
-H (--no-hard-classes) Prevents cfagent from generating any internal
class name information. Can be used for emula‐
tion purposes.
-i (--no-ifconfig) Do not attempt to configure the local area
network interface.
-I (--inform) Switches on the inform output level, whereby
cfagent reports everything it changes..
-k (--no-copy) Do not copy/image any files.
-K (--no-lock) Ignore locks when running.
-l (--traverse-links) Normally cfagent does not follow symbolic
links when recursively parsing directories.
This option will force it to do so.
-L (--delete-stale-links)
Delete links which do not point to existing
files (except in user home directories, which
are not touched).
-m (--no-mount) Do not attempt to mount file systems or edit
the filesystem table.
-M (--no-modules) Ignore modules in actionsequence.
-n (--recon,--dry-run,--just-print)
No action. Only print what has to be done
without actually doing it.
-N (--negate,--undefine) Cancel a set of classes, or undefine (set
value to false) a compound class of the form
alpha.beta.gamma.
-p (--parse-only) Parse file and then stop. Used for checking
the syntax of a program.
-P (--no-processes) Do not test the existence of processes, signal
processes or optionally restart them.
-q (--no-splay) Switch off host splaying (sleeping).
-s (--no-commands) Do not execute scripts or shell commands.
-S (--silent) Silence run time warnings.
-t (--no-tidy) Do not tidy file systems.
-u (--use-env) Causes cfagent to generate an environment
variable CFALLCLASSES which can be read by
child processes (scripts). This variable con‐
tains a summary of all the currently defined
classes at any given time. This option causes
some system 5 systems to generate a Bus Error
or segmentation fault.
-U (--underscore-classes)
When this option is set, cfagent adds an
underscore to the beginning of all hard system
classes (like _sun4, _linux etc.) This can be
used to avoid naming conflicts if you are so
injudicious as to name a host by the name of a
hard class. Other classes are not affected.
-v (--verbose) Verbose mode. Prints detailed information
about actions and state.
-V (--version) Print only the version string and then quit.
-x (--no-preconf) Do not execute the cf.preconf net configura‐
tion file.
-X (--no-links) Do not execute the links section of a program.
-w (--no-warn,--quiet) Do not print warning messages.
AUTHOR
Mark Burgess, Oslo University College
INFORMATION
http://www.cfengine.org
Maintenance Commands cfengine(8)
