NAME

     cfengine - network configuration engine

SYNOPSIS

     /usr/gnu/sbin/cfengine [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 cfenginge is to create a single file or set
     of  configuration  files  which  will  describe the setup of
     every host on your network.

     cfenginge 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.   cfen-
     ginge  reads  a configuration file called cfengine.conf in a
     directory pointed to by the environment  variable  CFINPUTS.
     cfenginge  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 direc-
                              tories  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 cfenginge  will
                              run like this.

     -f (--file)              Parse filename after  this  switch.
                              By  default  cfenginge  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 cfenginge from  generating
                              any  internal  class  name informa-
                              tion. 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  cfenginge  reports
                              everything it changes..

     -k (--no-copy)           Do not copy/image any files.

     -K (--no-lock)           Ignore locks when running.

     -l (--traverse-links)    Normally cfenginge 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  sys-
                              tems 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  unde-
                              fine  (set  value  to false) a com-
                              pound    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  (sleep-
                              ing).

     -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  cfenginge  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,  cfenginge
                              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 College

INFORMATION

     http://www.iu.hioslo.no/cfengine