NAME

       cfrun - Execute remote cfagents

SYNOPSIS

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

                                              Maintenance Commands                                   cfengine(8)