Note that GNU long options are available with the syntax
--longoption
. The long names are given in brackets.
--sysadm
) Print only the name of the system administrator then quit.
--auto
) Can be used to signify an automatic run of cfengine, as opposed
to a manual run. The distinction is not predetermined. Use of this option
currently causes cfengine to ignore locks. This option is reserved for future
development.
--force-net-copy
) Normally cfengine detects attempts to copy
from a server via the network that will loop back to the localhost.
It then avoids using the network to make the copy. This option forces
cfengine to copy using the network. Yes, someone thinks this is useful!
--no-check-files
) Do not check file systems for ownership / permissions etc.
--no-check-mounts
) Check mount points for consistency. If this
option is specified then directories which lie in the “mount point”
area are checked to see whether there is anything mounted on them.
Normally this is off since not all machines use mounted file
systems in the same way. e.g. HPUX does not generally operate with
partitions, but nevertheless one might wish to mimick a partition-like
environment there, but it would be irritating to be informed that
nothing was mounted on the mount point.
--debug
) Enable debugging output. Normally you will want to
send this to a file using the shell script command or a pipe.
-d1 shows only parsing output. -d2 shows only
runtime action output. -d0 shows both levels. Debugging ouput is
intended mainly for the author's convenience and is not a supported
feature. The details of this output may change at any time.
--define
) Define a compound class symbol of the form
alpha.beta.gamma.
--no-edits
) Suppress file editing.
--enforce-links
) Globally force links to be created where plain
files or links already exist. Since this option
is a big hammer, you have to use it in interactive mode and
answer a yes/no query before cfengine will run like this.
--file
) Parse filename after this switch. By default cfengine
looks for a file called cfengine.conf in the current directory.
--check-contradictions
) Never implemented.
--help
) Help information. Display version banner and options
summary.
--no-hard-classes
). Prevents cfengine from generating any built-in
class name information. Can be used for emulation purposes.
--no-ifconfig
) Do not attempt to configure the local area
network interface.
--inform
) Switches on the inform output level, whereby cfengine
reports everything it changes..
--just
) Executed only named action types.
$ cfagent --avoid resolve,copy $ cfagent --just tidy --just shellcommands
--no-copy
) Do not copy/image any files.
--no-lock
) Ignore locks when running.
--traverse-links
) Normally cfengine does not follow symbolic
links when recursively parsing directories. This option will force it
to do so.
--delete-stale-links
) Delete links which do not point to
existing files (except in user home directories, which are not touched).
--no-mount
) Do not attempt to mount file systems or edit the
filesystem table.
--no-modules
)
Ignore modules in actionsequence.
--recon
,--dry-run
,--just-print
) No action. Only
print what has to be done without actually doing it.
--negate
,--undefine
) Cancel a set of classes,
or undefine (set value to false) a compound class of the form
alpha.beta.gamma.
--avoid
) Do not execute named action types.
$ cfagent --avoid resolve,copy $ cfagent --just tidy --just shellcommands
--parse-only
) Parse file and then stop. Used for checking the
syntax of a program. You do not have to be superuser to use this
option.
--no-processes
) Do not execute the processes action.
--no-splay
) Switch off host splaying (sleeping).
--query
) Query the values of the comma separated list of variable names.
--no-commands
) Do not execute scripts or shell commands.
--silent
) Silence run time warnings.
--no-tidy
) Do not tidy file systems.
--use-env
) Causes cfengine 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 V systems to generate a Bus
Error or segmentation fault. The same information is available from the
cfengine built-in variable $(allclasses)
and can be passed as a
parameter to scripts.
When this variable grows too large for embedding one can also access a complete
list of current classes in /var/cfengine/state/allclasses.
--underscore-classes
). When this option is set, cfengine adds
an underscore to the beginning of the hard system classes (like _sun4
, _linux
etc. The longer compound classes are not underscored, since these are already
complex and would unlikely result in collisions.) This can be used to avoid naming conflicts if you are so
unjudicious as to name a host by the name of a hard class. Other classes
are not affected.
--verbose
) Verbose mode. Prints detailed information about
actions and state.
--version
) Print only the version string and then quit.
--no-warn,--quiet
,--quiet
) Do not print warning messages.
--csdb
) Print the name of the current checksum database.
--no-preconf
) Do not execute the cf.preconf net
configuration file.
--no-links
) Do not execute the links
section of a
program.
--zone-info
) Print variable data
--method
) Execute a method as a sub-process.
Note that GNU long options are available with the syntax
--longoption
. The long names are given in brackets.
debug
) Set debugging ouput. e.g. -d2
file
) Set name of input file instead to default cfservd.conf.
no-fork
) Do not run in background (daemon mode).
help
) Print help info.
ld-library-path
) Set the internal LD_LIBRARY_PATH
variable.
parse-only
) Only parse configuration, do not run.
verbose
) Run in verbose mode. Should be combined with ‘-F’ for debugging.
Note that GNU long options are available with the syntax
--longoption
. The long names are given in brackets.
once
) Run once only, now. Do not run in background (daemon mode).
debug
) Set debugging ouput. e.g. -d2
file
) Set name of input file instead to default cfservd.conf.
no-fork
) Do not run in background (daemon mode).
foreground
) Do not run in background (daemon mode).
help
) Print help info.
ld-library-path
) Set the internal LD_LIBRARY_PATH
variable.
parse-only
) Only parse configuration, do not run.
verbose
) Run in verbose mode. Should be combined with ‘-F’ for debugging.
Note that GNU long options are available with the syntax
--longoption
. The long names are given in brackets.
debug
) Set debugging ouput. e.g. -d2
no-fork
) Do not run in background (daemon mode).
help
) Print help info.
help
) Keep histogram data.
help
) Interface with tcpdump
if present on the system.
verbose
) Run in verbose mode. Should be combined with ‘-F’ for debugging.
Note that GNU long options are available with the syntax
--longoption
. The long names are given in brackets.
e.g. cfrun -- -- linux Run on all linux machines cfrun -- -p Ping and parse on all hosts cfrun host1 host2 -- -p Ping and parse on named hosts cfrun -v -- -p Ping all, local verbose cfrun -v -- -k -- solaris Local verbose, all solaris, but no copy
Cfenvgraph is the tool that converts data stored by cfenvd
into
text files that can be used to produce graphs. Use another tool like
gnuplot
or xmgrace
to generate scientific graphs. Use
cfbrain
to perform monitoring based on cfenvd
data.
--no-error-bars
) Plot X,Y only, do not add error bars
--erasehistory
) A comma separated list of metrics to be erased. The past week's data is not erased.
--help
) Print help message.
--file
) Specify a database other than the default.
--no-scaling
) Do not perform automatic scaling of graphs.
--now
) Plot an expanded view of the past four hours, not a weekly view.
--outputdir
) Set the output directory name.
--resolution
) Plot the data with maximum 5-minute resolution.
--separate
) Plot one graph per metric, instead of all graphs on one trace.
--titles
) Add title data to graph files.
--timestamps
) Add a timestamp to the output directory name in order to keep a history.
--verbose
) Verbose output.
Cfshow is the tool that shows data recorded in cfengine's private workspace.
--active
) Display any action locks that are currently active.
--audit
) Dump the system auditing history.
--checksum
) Dump the database of cryptographic checksums.
--classes
) Dump the class history of this host.
--debug
) Show debugging output.
--filename
) Change the default database names.
--help
) Show help message.
--html
) Generate output in html.
--locks
) Show the historical database of all action locks.
--performance
) Show data about performance of instrumented actions.
--regex
) Show configuration rules in classes that match the regular expression argument.
--last-seen
) Show the last-seen times of all observed peers.
--xml
) Generate output in XML.
--purge
) Purge data older than one week.
--version
) Output version string.
--verbose
) Verbose output.
Has no options.