Provided by: cfengine2_2.1.20-1_i386 bug

NAME

       cfrun - Execute remote cfagents

SYNOPSIS

       /usr/local/sbin/cfrun [options]

DESCRIPTION

       cfengine  is  a language based system specifically designed for testing
       and configuring unix-like systems attached to a TCP/IP network.

       cfrun is a tool for executing one or more remote  agents;  it  contacts
       the  cfservd daemon running on a remote host, which (in turn) starts an
       authorized agent. Cfrun cannot be used to send instructions to a remote
       agent,  but  it  can  be  used  to  flag certain aspects to the agent’s
       existing policy for special attention..

       The command line options for  cfrun  are  slightly  unusual.  They  are
       separated into three sections: options to the cfrun program, options to
       the remote  cfagent  (with  some  security  restrictions)  and  finally
       classes or flags to the remote agent.

EXAMPLES

       cfrun specialhost1 specialhost2 -- --verbose -- solaris

       In  this  example,  we contact hosts specialhost1 specialhost2 by name,
       and ask them to execute cfagent with the --verbose flag, if  the  class
       solaris is not defined.

       cfrun specialhost1 --verbose  --  -- solaris

       In  this  example  the verbose flag is sent to cfrun rather than to the
       remote agent.  No options are sent to  the  remote  agents.  The  class
       specifier  is sent to all the agents so that they may determine whether
       they fulfill the required class membership for execution.

       The default behaviour is to  execute  cfagent  serially  on  all  hosts
       listed in the cfrun.hosts file.

FILES

       cfrun  read  a configuration file cfrun.hosts which must contain a list
       of every potentially contactable host.

AUTHOR

       Mark Burgess, Oslo University College

INFORMATION

       http://www.cfengine.org