cf-report(8) [debian man page]
cf-report(8) System Manager's Manual cf-report(8) NAME
cf-report - cfengine's reporting agent SYNOPSIS
: cf-report [options] DESCRIPTION
: The reporting agent is a merger between the older cfengine programs cfshow and cfenvgraph. It outputs data stored in cfengine's embedded databases in human readable form. cfengine is a self-healing configuration and change management based system. You can think of cfengine as a very high level language, much higher level than Perl or shell. Asingle statement is called a promise, and compliance can result in many hundreds of filesbeing created, or the permissions of many hundreds offiles being set. The idea of cfengine is to create a one or more sets of configuration files which willclassify and describe the setup of every host in a network. COMMAND LINE OPTIONS
: --help, -h Print the help message --class-regex, -c Specify a class regular expression to search for --csv, -C Enable CSV output mode in hub queries --debug, -d Set debugging level 0,1,2,3 --verbose, -v Output verbose information about the behaviour of the agent --inform, -I Output information about actions performed by the agent --version, -V Output the version of the software --no-lock, -K Ignore ifelapsed locks --file, -f Specify an alternative input file than the default --hostkey, -k Specify a hostkey to lookup --html, -H Print output in HTML --xml, -X Print output in XML --version, -V Print version string for software --purge, -P Purge data about peers not seen beyond the threshold horizon for assumed-dead --erasehistory, -E Erase historical data from the cf-monitord monitoring database --nova-export, -x Export Nova reports to file - delta or full report --nova-import, -i Import Nova reports from file - specify the path (only on Nova policy hub) --outputdir, -o Set output directory for printing graph data --promise-handle, -p Specify a promise-handle to look up --query-hub, -q Query hub database interactively with optional regex search string --titles, -t Add title data to generated graph files --timestamps, -T Add a time stamp to directory name for graph file data --resolution, -R Print graph data in high resolution --show, -1 Show data matching named criteria (software,variables,classes) --syntax, -S Print a syntax summary for this cfengine version --syntax-export, -s Export a syntax tree in Javascript format --no-error-bars, -e Do not add error bars to the printed graphs --no-scaling, -n Do not automatically scale the axes --verbose, -v Generate verbose output --remove-hosts, -r Remove comma separated list of key hash entries from the hosts-seen database AUTHOR
Mark Burgess and CFEngine AS INFORMATION
Bug reports: http://bug.cfengine.com, .PP Community help: http://forum.cfengine.com Community info: http://www.cfengine.com/pages/community Support services: http://www.cfengine.com This software is Copyright (C) 2008-2013 CFEngine AS. Maintenance Commands cf-report(8)
Check Out this Related Man Page
cfengine(8) System Manager's Manual cfengine(8) NAME
cfengine - network configuration engine SYNOPSIS
/usr/sbin/cfagent [options] /usr/sbin/cfrun [options] /usr/sbin/cfservd /usr/sbin/cfexecd /usr/sbin/cfenvd /usr/sbin/cfkey /usr/sbin/cfenvgraph 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 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 (--sysadm) Print only the name of the system administrator 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 direc- tory. -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 emulation 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. -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 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 (--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 configuration 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 HiOslo Maintenance Commands cfengine(8)