16.120. cdist-type__process(7)

16.120.1. NAME

cdist-type__process - Start or stop process

16.120.2. DESCRIPTION

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

16.120.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.

16.120.4. MESSAGES

started
The process was started.
stopped
The process was stopped.

16.120.5. 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.*"

16.120.6. SEE ALSO

cdist-type__start_on_boot(7)

16.120.7. AUTHORS

Thomas Eckert <tom--@--it-eckert.de>

16.120.8. COPYING

Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.