CFENGINE 3.0.0-training SYNTAXPromise datatype legend
- string
- int
- real
- slist
- ilist
- rlist
- (option)
- (option list)
- (ext body)
- class
- clist
- irange [int,int]
- rrange [real,real]
|
Bundle types (software components)
- COMPONENT common
Promise types for common bundles
PROMISE TYPE vars
string | string | (arbitrary string) |
int | int | -9999999,999999 |
real | real | -9.99999E100,9.99999E100 |
slist | slist | (arbitrary string) |
ilist | ilist | -9999999,999999 |
rlist | rlist | -9.99999E100,9.99999E100 |
policy | (option) | free,overridable,constant |
|
- COMPONENT agent
Promise types for agent bundles
PROMISE TYPE vars
string | string | (arbitrary string) |
int | int | -9999999,999999 |
real | real | -9.99999E100,9.99999E100 |
slist | slist | (arbitrary string) |
ilist | ilist | -9999999,999999 |
rlist | rlist | -9.99999E100,9.99999E100 |
policy | (option) | free,overridable,constant |
PROMISE TYPE files
file_select | (ext body) |
name | slist | (arbitrary string) |
path | slist | /.* |
mode | string | (arbitrary string) |
size | irange [int,int] | (arbitrary string) |
owner | slist | (arbitrary string) |
group | slist | (arbitrary string) |
ctime | irange [int,int] | 0,4026531839 |
mtime | irange [int,int] | 0,4026531839 |
atime | irange [int,int] | 0,4026531839 |
exec_regex | string | (arbitrary string) |
filetypes | (option list) | reg,link,dir,socket,fifo,door,char,block |
issymlinkto | slist | (arbitrary string) |
filetype | string | [(plain| link| dir| socket| fifo| door| char| block)[| ]*]* |
result | string | [(name| path| filetype| mode| size| owner| group| atime| ctime| mtime| issymlinkto| exec_regex)[| &!.]*]* |
|
copyfrom | (ext body) |
source | string | (arbitrary string) |
servers | slist | (arbitrary string) |
action | string | (arbitrary string) |
backup | string | (arbitrary string) |
repository | string | /.* |
stealth | (option) | true,false,yes,no,on,off |
preserve | (option) | true,false,yes,no,on,off |
linkpattern | string | (arbitrary string) |
xdev | (option) | true,false,yes,no,on,off |
compare | (option) | atime,mtime,ctime,checksum |
linktype | (option) | absolute,relative,hard |
typecheck | (option) | true,false,yes,no,on,off |
forceupdate | (option) | true,false,yes,no,on,off |
forcedirs | (option) | true,false,yes,no,on,off |
forceipv4 | (option) | true,false,yes,no,on,off |
size | int | 0,inf |
trigger | slist | (arbitrary string) |
trustkey | (option) | true,false,yes,no,on,off |
encrypt | (option) | true,false,yes,no,on,off |
verify | (option) | true,false,yes,no,on,off |
purge | (option) | true,false,yes,no,on,off |
findertype | (option) | MacOSX |
|
linkto | (ext body) |
link_type | (option) | symbolic,absolute,abs,hard,relative,rel |
copy_patterns | string | (arbitrary string) |
deadlinks | (option) | kill,force |
when_no_file | (option) | force,kill |
|
access | (ext body) |
mode | string | [0-7ugorwx,+-]* |
owner | slist | .* |
group | slist | .* |
|
changes | (ext body) |
hash | (option) | md5,sha1 |
update | (option) | true,false,yes,no,on,off |
|
tidy | (ext body) |
age | irange [int,int] | 0,inf |
size | irange [int,int] | 0,inf |
age_type | (option) | mtime,ctime,mtime,atime |
dirlinks | (option) | delete,keep,tidy |
rmdirs | (option) | yes,no,true,false,sub |
links | (option) | stop,keep,traverse,tidy |
|
rename | (ext body) |
newname | string | filename |
type | (option) | plain,file,link |
rotate | int | 0,99 |
size | irange [int,int] | 0,inf |
|
repository | string | /.* |
edit_line | (ext body) | (Separate Bundle) |
edit_xml | (ext body) | (Separate Bundle) |
acl | (ext body) | |
recurse | int | 0,inf |
PROMISE TYPE executables
args | string | (arbitrary string) |
containment | (ext body) |
useshell | (option) | true,false,yes,no,on,off |
umask | int | 0,77 |
owner | slist | (arbitrary string) |
group | slist | (arbitrary string) |
chdir | string | /.* |
chroot | slist | /.* |
|
module | (option) | true,false,yes,no,on,off |
timeout | int | 1,3600 |
background | (option) | true,false,yes,no,on,off |
PROMISE TYPE processes
signals | (option list) | hup,int,trap,kill,pipe,cont,abrt,stop,quit,term,child,usr1,usr2,bus,segv |
number | (ext body) |
match_range | irange [int,int] | (arbitrary string) |
in_range_define | slist | (arbitrary string) |
out_of_range_define | slist | (arbitrary string) |
|
process_select | (ext body) |
owner | slist | (arbitrary string) |
pid | string | (arbitrary string) |
ppid | string | (arbitrary string) |
pgid | string | (arbitrary string) |
rsize | string | (arbitrary string) |
vsize | string | (arbitrary string) |
status | string | (arbitrary string) |
ttime_range | string | (arbitrary string) |
stime_range | string | (arbitrary string) |
command | string | (arbitrary string) |
tty | string | (arbitrary string) |
priority | string | (arbitrary string) |
threads | string | (arbitrary string) |
result | (option) | owner,pid,ppid,pgid,rsize,vsize,status,command,ttime,stime,tty,priority,threads |
|
restart | string | [a-zA-Z0-9_]+ |
|
- COMPONENT server
Promise types for server bundles
PROMISE TYPE vars
string | string | (arbitrary string) |
int | int | -9999999,999999 |
real | real | -9.99999E100,9.99999E100 |
slist | slist | (arbitrary string) |
ilist | ilist | -9999999,999999 |
rlist | rlist | -9.99999E100,9.99999E100 |
policy | (option) | free,overridable,constant |
PROMISE TYPE access
admit | slist | (arbitrary string) |
deny | slist | (arbitrary string) |
|
- COMPONENT monitor
Promise types for monitor bundles
PROMISE TYPE vars
string | string | (arbitrary string) |
int | int | -9999999,999999 |
real | real | -9.99999E100,9.99999E100 |
slist | slist | (arbitrary string) |
ilist | ilist | -9999999,999999 |
rlist | rlist | -9.99999E100,9.99999E100 |
policy | (option) | free,overridable,constant |
|
builtin functions
Return type | Function name | Arguments |
int | randomint() | 2 args expected |
int | getuid() | 1 args expected |
int | getgid() | 1 args expected |
string | execresult() | 2 args expected |
string | readtcp() | 4 args expected |
class | returnszero() | 2 args expected |
class | isnewerthan() | 2 args expected |
class | accessedbefore() | 2 args expected |
class | changedbefore() | 2 args expected |
class | fileexists() | 1 args expected |
class | isdir() | 1 args expected |
class | islink() | 1 args expected |
class | isplain() | 1 args expected |
class | iprange() | 1 args expected |
class | hostrange() | 2 args expected |
class | isvariable() | 1 args expected |
class | strcmp() | 2 args expected |
class | regcmp() | 2 args expected |
class | isgreaterthan() | 2 args expected |
class | islessthan() | 2 args expected |
class | userexists() | 1 args expected |
class | groupexists() | 1 args expected |
slist | readstringlist() | 4 args expected |
ilist | readintlist() | 4 args expected |
rlist | readreallist() | 4 args expected |
irange [int,int] | irange() | 2 args expected |
rrange [real,real] | rrange() | 2 args expected |
int | ondate() | 6 args expected |
int | ago() | 6 args expected |
int | now() | 0 args expected |
class | persiststate() | 3 args expected |
class | erasestate() | 1 args expected |
|