Provided by:
dpkg_1.15.8.4ubuntu3_i386 
NOMBRE
start-stop-daemon - Detiene y arranca demonios del sistema
SINOPSIS
start-stop-daemon [opciones] orden
DESCRIPCIN
start-stop-daemon sirve para controlar la creacin y finalizacin de los
procesos del sistema. Usando una de las opciones de bsqueda, puede
configurar start-stop-daemon para encontrar las instancias de un
proceso en ejecucin.
Nota :Tenga en cuenta que a menos que se especifique --pidfile,
start-stop-daemon se comporta de forma similar a killall(1).
start-stop-daemon buscar en la tabla de procesos cualquier proceso que
concuerde en nombre, uid y/o gid (si se especifica). Cualquier proceso
que concuerde con los parmetros prevendr a --start de iniciar el
demonio. Se mandar a todos los procesos la seal TERM (o la seal
especificada mediante --signal o --retry) si se especifica --stop. Debe
especificar un fichero pid para los demonios que tengan hijos de larga
duracin que necesiten sobrevivir a un --stop.
RDENES
-S, --start [--] argumentos
Comprueba la existencia del proceso especificado. Si este
proceso ya existe, start-stop-daemon no hace nada y finaliza con
un estado de error 1 (0 si se especifica --oknodo ). Si el
proceso no existe, comienza uno nuevo usando el ejecutable
especificado por --exec, (o, si se especifica, por --startas ).
Cualquier argumento dado en la lnea de rdenes despus de -- se
introduce sin modificacin alguna al programa que se va a
ejecutar.
-K, --stop
Comprueba la existencia del proceso especificado. Si este
proceso existe, start-stop-daemon enva la seal especificada por
--signal, y finaliza con un estado de error 0. Si este proceso
no existe, start-stop-daemon termina con un estado de error 1 (0
si se ha especificado la opcin --oknodo ). Si se especifica la
opcin --retry, start-stop-daemon comprobar que el proceso o los
procesos han terminado.
-H, --help
Muestra la informacin de uso y termina.
-V, --version
Muestra la versin y termina.
OPCIONES DE BSQUEDA
-p, --pidfile fichero-pid
Comprueba si un proceso ha creado el fichero fichero-pid.
-x, --exec ejecutable
Busca procesos que sean instancias de este ejecutable (segn
/proc/pid/exe).
-n, --name nombre-proceso
Comprueba los procesos con el nombre nombre-proceso (segn
/proc/pid/stat).
-u, --user nombre-usuario|uid
Comprueba si existen los procesos del usuario especificado por
nombre-usuario o uid.
OPCIONES
-g, --group grupo|gid
Pasa a grupo o gid cuando comienza el proceso.
-s, --signal seal
Junto con --stop, define la seal enviada al proceso que se desea
parar (TERM por omisin).
-R, --retry tiempo-de-espera|accin-programada
Junto con --stop, especifica que start-stop-daemon compruebe que
el proceso o los procesos han terminado. Lo comprobar repetidas
veces hasta que no haya ningn proceso que coincida. Si el
proceso no termina tomar una decisin determinada por
accin-programada.
Si se especifica tiempo-de-espera en vez de accin-programada, se
usa la secuencia seal/tiempo-de-espera/KILL/tiempo-de-espera,
donde seal es la seal definida con --signal.
accin-programada es una lista de al menos dos elementos
separados por barras (/); cada elemento puede ser un
-nmerodeseal o [-]nombre-de-seal, que significa que se debe
mandar esa seal, o tiempo-de-espera, que significa que se debe
esperar tantos segundos para que el programa termine, o forever,
que significa que se repita el resto de la accin programada
indefinidamente si es necesario.
Si se alcanza el final de la accin programada y no se ha
especificado forever, start-stop-daemon termina con un estado de
error 2. Si se especifica una accin programada cualquier seal
especificada con --signal no se tendr en cuenta.
-a, --startas nombre-ruta
Con --start, comienza el proceso definido con nombre-ruta. Si no
se define, se usarn los argumentos dados con --exec.
-t, --test
Muestra las acciones que se realizaran y devuelve el valor
apropiado, pero no hace nada.
-o, --oknodo
Devuelve un estado 0 en vez de 1 si no se realiza (o se vayan a
realizar) ninguna accin.
-q, --quiet
No muestra mensajes informativos, slo muestra mensajes de error.
-c, --chuid nombre-usuario|uid
Cambia a este usuario/uid antes de empezar el proceso. Tambin
puede definir un grupo aadiendo : seguido del grupo o el gid,
del mismo modo que hara con la orden chown (usuario:grupo).
Tenga en cuenta que cuando se usa esta opcin el grupo primario y
complementario tambin cambian, incluso si no se especifica
--group. La opcin --group es slo para grupos de los que el
usuario no es miembro (como el grupo nobody).
-r, --chroot directorio-raz
Ejecuta chdir y chroot sobre el directorio-raz antes de empezar
el proceso. Tenga en cuenta que el fichero pid tambin se escribe
despus del chroot.
-d, --chdir ruta
Ejecuta un chdir a ruta antes de empezar el proceso. Esto se
hace tras chroot, si se define la opcin -r|--chroot. Si no se
define, start-stop-daemon ejecutar un chdir al directorio raz
antes de empezar el proceso.
-b, --background
Usado habitualmente con programas que no se separan por s
mismos. Esta opcin forzar start-stop-daemon a hacer un fork
antes de empezar el proceso, para luego dejarlo en segundo
plano. ATENCIN: start-stop-daemon no puede comprobar el estado
de salida si el proceso no puede ejecutarse por cualquier razn.
Esto se hace como ltimo recurso, y slo tiene sentido usarla en
programas donde no tiene sentido que hagan fork por s mismos, o
no si es posible aadir el cdigo para que lo hagan por s mismos.
-N, --nicelevel entero
Altera la prioridad del proceso antes de iniciarlo.
-P, --procsched directriz:prioridad
Altera la directriz de la accin programada del proceso y la
prioridad de la accin programada antes de iniciarlo. Puede
especificar la prioridad opcionalmente aadiendo :, seguido del
valor. La prioridad por omisin es 0. Las directrices compatibles
son other, fifo y rr.
-I, --iosched clase:prioridad
Esto altera la clase la planificacin de E/S y la prioridad del
proceso antes de iniciarlo. Opcionalmente, puede definir la
prioridad aadiendo : al final, seguido del valor. La prioridad
predefinida es 4, a menos que la clase sea idle. En tal caso, la
prioridad ser siempre 7. Los valores posibles para la clase son
idle, best-effort y real-time.
-k, --umask mask
Define el umask del proceso antes de iniciarlo.
-m, --make-pidfile
Se usa cuando se quiere comenzar un programa que no crea su
propio fichero pid. Esta opcin hace que start-stop-daemon cree
el fichero referido con --pidfile y coloque el pid dentro de l
justo antes de ejecutar el proceso. Tenga en cuenta que no se
borrar cuando termine el programa. NOTA: Esta caracterstica no
funciona en todos los casos. Ms notablemente cuando el programa
que se ejecuta hace un fork de su proceso principal. Por esto es
til slo cuando se combina con la opcin --background.
-v, --verbose
Muestra mensajes informativos detallados.
ESTADOS DE SALIDA
start-stop-daemon devuelve 0 si la accin requerida tuvo xito, o si se
define --oknodo y si se defini o bien --start, existiendo un proceso
cuyo nombre coincide, o --stop y si no existe un proceso que coincida.
Devuelve 1 si se especific --oknodo pero nada ocurri. Devuelve 2 si se
especificaron --stop y --retry, y la accin programada se ejecut y los
procesos an se estaban ejecutando. Devuelve 3 para los dems errores.
EJEMPLO
Arranca el demonio food, a menos que se est ejecutando uno (un proceso
llamado food, ejecutndose como usuario food, y con pid en food.pid):
start-stop-daemon --start --oknodo --user food --name food --pidfile /var/run/food.pid --startas /usr/sbin/food --chuid food -- --daemon
Enva SIGTERM a food y espera 5 segundos para su finalizacin:
start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
Un ejemplo de una accin programada personalizada para detener food:
start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry=TERM/30/KILL/5
AUTORES
Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> basada en una
versin previa de Ian Jackson <ian@chiark.greenend.org.uk>.
Pgina de manual de Klee Dienes <klee@mit.edu>, reformateada
parcialmente por Ian Jackson.
TRADUCTOR
Rudy Godoy <rudy@kernel-panik.org>, Rubn Porras <nahoo@inicia.es>,
Bruno Barrera C. <bruno.barrera@igloo.cl>, Carlos Izquierdo
<gheesh@ertis.net>, Esteban Manchado y NOK. Debian L10n Spanish
<debian-l10n-spanish@lists.debian.org>.
Revisiones por Santiago Vila <sanvila@unex.es>, Javier
Fernndez-Sanguino, Rubn Porras, Luis Uribe y Omar Campagne.