cdist-type__process(7)

Nico Schottelius

<nico-cdist--@--schottelius.org>

Table of Contents

1. NAME
2. DESCRIPTION
3. OPTIONAL PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__process - Start or stop process

2. DESCRIPTION

This cdist type allows you to define the state of a process.

3. OPTIONAL PARAMETERS

state

Either "present" or "absent", defaults to "present"

name

Process name to match on when using pgrep -f -x.

This is useful, if the name starts with a "/",
because the leading slash is stripped away from
the object id by cdist.

stop

Executable to use for stopping the process.

start

Executable to use for starting the process.

4. EXAMPLES

# Start if not running
__process /usr/sbin/syslog-ng --state present

# Start if not running with a different binary
__process /usr/sbin/nginx --state present --start "/etc/rc.d/nginx start"

# Stop the process using kill (the type default) - DO NOT USE THIS
__process /usr/sbin/sshd --state absent

# Stop the process using /etc/rc.d/sshd stop - THIS ONE NOT AS WELL
__process /usr/sbin/sshd --state absent --stop "/etc/rc.d/sshd stop"

# Ensure cups is running, which runs with -C ...:
__process cups --start "/etc/rc.d/cups start" --state present \
   --name "/usr/sbin/cupsd -C /etc/cups/cupsd.conf"

# Ensure rpc.statd is running (which usually runs with -L) using a regexp
__process rpcstatd --state present --start "/etc/init.d/statd start" \
    --name "rpc.statd.*"

5. SEE ALSO

cdist-type(7)
cdist-type__start_on_boot(7)