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
cfenginge is to create a
single file or set of configuration files which will
describe the setup of every host on your network.
cfagent runs on every host and parses one file (or file-set),
the configuration 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
Print only the name of the system administrator then quit.
"-b
Forces net copy even if remote server is localhost
"-c
Do not check access rights on file systems
"-C
Check mount points for consistency. If this option is set
then directories which lie in the (rqmount point(lq area are
checked to see whether there is anything mounted on them.
"-d
Enable debugging output. (parsing -d1,run, -d2, lite -d3)
"-D
Define a compound class symbol of the form alpha.beta.gamma.
"-e
Suppress file editing.
"-E
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
Parse filename after this switch. By default
cfagent looks for a file called cfengine.conf in the current directory.
"-h
Help information. Display version banner and options summary.
"-H
Prevents
cfagent from generating any internal class name
information. Can be used for emulation purposes.
"-i
Do not attempt to configure the local area network interface.
"-I
Switches on the inform output level, whereby
cfagent reports everything it changes..
"-k
Do not copy/image any files.
"-K
Ignore locks when running.
"-l
Normally
cfagent does not follow symbolic links when recursively
parsing directories. This option will force it to do so.
"-L
Delete links which do not point to existing files (except in
user home directories, which are not touched).
"-m
Do not attempt to mount file systems or edit the filesystem table.
"-M
Ignore modules in actionsequence.
"-n
No action. Only print what has to be done without actually doing it.
"-N
Cancel a set of classes, or undefine (set value to false) a
compound class of the form alpha.beta.gamma.
"-p
Parse file and then stop. Used for checking the syntax of a
program.
"-q
Switch off host splaying (sleeping).
"-s
Do not execute scripts or shell commands.
"-S
Silence run time warnings.
"-t
Do not tidy file systems.
"-u
Causes
cfagent to generate an environment variable CFALLCLASSES
which can be read by child processes (scripts). This variable
contains 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
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 mode. Prints detailed information about actions and state.
"-V
Print only the version string and then quit.
"-x
Do not execute the cf.preconf net configuration file.
