Provided by:
dpkg_1.16.0.3ubuntu5_i386 
NOMBRE
start-stop-daemon - Detiene y arranca demonios del sistema
SINOPSIS
start-stop-daemon [opciones] orden
DESCRIPCI'ON
start-stop-daemon sirve para controlar la creacion y finalizacion de
los procesos del sistema. Usando una de las opciones de busqueda, puede
configurar start-stop-daemon para encontrar las instancias de un
proceso en ejecucion.
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 buscara en la tabla de procesos cualquier proceso que
concuerde en nombre, uid y/o gid (si se especifica). Cualquier proceso
que concuerde con los parametros prevendra a --start de iniciar el
demonio. Se mandara a todos los procesos la senal TERM (o la senal
especificada mediante --signal o --retry) si se especifica --stop. Debe
especificar un fichero pid para los demonios que tengan hijos de larga
duracion que necesiten sobrevivir a un --stop.
'ORDENES
-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 linea de ordenes despues de -- se
introduce sin modificacion alguna al programa que se va a
ejecutar.
-K, --stop
Comprueba la existencia del proceso especificado. Si este
proceso existe, start-stop-daemon envia la senal 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 opcion --oknodo ). Si se
especifica la opcion --retry, start-stop-daemon comprobara que
el proceso o los procesos han terminado.
-H, --help
Muestra la informacion de uso y termina.
-V, --version
Muestra la version y termina.
OPCIONES DE B'USQUEDA
-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 (segun
/proc/pid/exe).
-n, --name nombre-proceso
Comprueba los procesos con el nombre nombre-proceso (segun
/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 se~nal
Junto con --stop, define la senal enviada al proceso que se
desea parar (TERM por omision).
-R, --retry tiempo-de-espera|acci'on-programada
Junto con --stop, especifica que start-stop-daemon compruebe que
el proceso o los procesos han terminado. Lo comprobara repetidas
veces hasta que no haya ningun proceso que coincida. Si el
proceso no termina tomara una decision determinada por
acci'on-programada.
Si se especifica tiempo-de-espera en vez de acci'on-programada,
se usa la secuencia
se~nal/tiempo-de-espera/KILL/tiempo-de-espera, donde se~nal es la
senal definida con --signal.
acci'on-programada es una lista de al menos dos elementos
separados por barras (/); cada elemento puede ser un
-n'umerodese~nal o [-]nombre-de-se~nal, que significa que se debe
mandar esa senal, 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 accion programada
indefinidamente si es necesario.
Si se alcanza el final de la accion programada y no se ha
especificado forever, start-stop-daemon termina con un estado de
error 2. Si se especifica una accion programada cualquier senal
especificada con --signal no se tendra en cuenta.
-a, --startas nombre-ruta
Con --start, comienza el proceso definido con nombre-ruta. Si no
se define, se usaran los argumentos dados con --exec.
-t, --test
Muestra las acciones que se realizarian 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 accion.
-q, --quiet
No muestra mensajes informativos, solo muestra mensajes de
error.
-c, --chuid nombre-usuario|uid
Cambia a este usuario/uid antes de empezar el proceso. Tambien
puede definir un grupo anadiendo : seguido del grupo o el gid,
del mismo modo que haria con la orden <<chown>> (usuario:grupo).
Tenga en cuenta que cuando se usa esta opcion el grupo primario
y complementario tambien cambian, incluso si no se especifica
--group. La opcion --group es solo para grupos de los que el
usuario no es miembro (como el grupo nobody).
-r, --chroot directorio-ra'iz
Ejecuta <<chdir>> y <<chroot>> sobre el directorio-ra'iz antes de
empezar el proceso. Tenga en cuenta que el fichero pid tambien
se escribe despues del chroot.
-d, --chdir ruta
Ejecuta un <<chdir>> a ruta antes de empezar el proceso. Esto se
hace tras <<chroot>>, si se define la opcion -r|--chroot. Si no
se define, start-stop-daemon ejecutara un <<chdir>> al
directorio raiz antes de empezar el proceso.
-b, --background
Usado habitualmente con programas que no se separan por si
mismos. Esta opcion forzara start-stop-daemon a hacer un fork
antes de empezar el proceso, para luego dejarlo en segundo
plano. ATENCI'ON: start-stop-daemon no puede comprobar el estado
de salida si el proceso no puede ejecutarse por cualquier razon.
Esto se hace como ultimo recurso, y solo tiene sentido usarla en
programas donde no tiene sentido que hagan fork por si mismos, o
no si es posible anadir el codigo para que lo hagan por si
mismos.
-N, --nicelevel entero
Altera la prioridad del proceso antes de iniciarlo.
-P, --procsched directriz:prioridad
Altera la directriz de la accion programada del proceso y la
prioridad de la accion programada antes de iniciarlo. Puede
especificar la prioridad opcionalmente anadiendo :, seguido del
valor. La prioridad por omision es 0. Las directrices
compatibles son other, fifo y rr.
-I, --iosched clase:prioridad
Esto altera la clase la planificacion de E/S y la prioridad del
proceso antes de iniciarlo. Opcionalmente, puede definir la
prioridad anadiendo : al final, seguido del valor. La prioridad
predefinida es 4, a menos que la clase sea idle. En tal caso, la
prioridad sera 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 opcion hace que start-stop-daemon cree
el fichero referido con --pidfile y coloque el pid dentro de el
justo antes de ejecutar el proceso. Tenga en cuenta que no se
borrara cuando termine el programa. NOTA: Esta caracteristica no
funciona en todos los casos. Mas notablemente cuando el programa
que se ejecuta hace un fork de su proceso principal. Por esto es
util solo cuando se combina con la opcion --background.
-v, --verbose
Muestra mensajes informativos detallados.
ESTADOS DE SALIDA
start-stop-daemon devuelve 0 si la accion requerida tuvo exito, o si se
define --oknodo y si se definio o bien --start, existiendo un proceso
cuyo nombre coincide, o --stop y si no existe un proceso que coincida.
Devuelve 1 si se especifico --oknodo pero nada ocurrio. Devuelve 2 si
se especificaron --stop y --retry, y la accion programada se ejecuto y
los procesos aun se estaban ejecutando. Devuelve 3 para los demas
errores.
EJEMPLO
Arranca el demonio food, a menos que se este ejecutando uno (un proceso
llamado <<food>>, ejecutandose 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
Envia SIGTERM a food y espera 5 segundos para su finalizacion:
start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
Un ejemplo de una accion 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
version previa de Ian Jackson <ian@chiark.greenend.org.uk>.
Pagina de manual de Klee Dienes <klee@mit.edu>, reformateada
parcialmente por Ian Jackson.
TRADUCTOR
Rudy Godoy <rudy@kernel-panik.org>, Ruben 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
Fernandez-Sanguino, Ruben Porras, Luis Uribe y Omar Campagne.