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 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 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