Linux Certif

Toute la documentation sur la certification Linux LPI

start-stop-daemon

NOMBRE

start-stop-daemon - para y arranca demonios del sistema

SINOPSIS

start-stop-daemon -S|--start opciones [--] argumentos

start-stop-daemon -K|--stop opciones

start-stop-daemon -H|--help

start-stop-daemon -V|--version

DESCRIPCI�N

start-stop-daemon

se usa para controlar la creaci�n y terminaci�n de los procesos del sistema. Usando las opciones --exec, --pidfile, --user, y --name opciones, start-stop-daemon se puede configurar para encontrar distintos procesos del mismo demonio.

Con --start, start-stop-daemon comprueba la existencia del proceso especificado. Si este proceso ya existe, start-stop-daemon no hace nada, y termina 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 l�nea de �rdenes despu�s de -- se pasa sin modificaci�n alguna al programa que se va a ejecutar.

Con --stop, start-stop-daemon comprueba adem�s la existencia del proceso especificado. Si este proceso existe, start-stop-daemon env�a la se�al especificada por --signal, y termina 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 opci�n --oknodo ). Si se especifica la opci�n --retry entonces start-stop-daemon comprobar� que el proceso o los procesos han terminado.

Dese cuenta que a menos que se especifique --pidfile , start-stop-daemon se comporta 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 par�metros prevendr� a --start de empezar el demonio. Se mandar� a todos los procesos la se�al KILL si se especifica --stop. Para los demonios que tengan hijos de larga duraci�n que necesiten sobrevivir a un --stop debe especificar un fichero-de-pid.

OPCIONES

-x|--exec ejecutable

Busca distintos procesos de este ejecutable (seg�n /proc/pid/exe ).

-p|--pidfile fichero-de-pid

Comprueba si un procesos ha creado el fichero fichero-de-pid.

-u|--user nombre-usuario|uid

Comprueba si existen los procesos del usuario especificado por nombre-usuario o uid.

-g|--group grupo|gid

Cambia a grupo o gid cuando comienza el proceso.

-n|--name nombre-proceso

Comprueba los procesos con el nombre nombre-proceso (seg�n /proc/pid/stat).

-s|--signal se�al

Junto con --stop, especifica la se�al enviada al proceso que se desea parar (15 por omisi�n).

-R|--retry tiempo-de-espera|acci�n-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 ning�n proceso que coincida. Si el proceso no termina tomar� una decisi�n determinada por acci�n-programada .

Si se especifica tiempo-de-espera en vez de acci�n-programada entonces se usa la secuencia se�al/tiempo-de-espera/KILL/tiempo-de-espera , donde se�al es la se�al especificada por --signal.

acci�n-programada es una lista de al menos dos art�culos separados por barras (/); cada art�culo puede ser un -n�merodese�al o [-]nombre de se�al, que significa que se debe mandar esa se�al, o tiempo-de-espera, que significa que se debe esperar esos segundos para que el programa termine, o forever, que significa que se repite el resto de acci�n-programada para siempre si es necesario.

Si se alcanza el final de la acci�n-programada y no se ha especificado forever , entonces start-stop-daemon termina con un estado de error 2. Si se especifica una secuencia, entonces cualquier se�al especificada con --signal no se tendr� en cuenta.

-a|--startas pathname

Con --start, comienza el proceso especificado por pathname. Si no se especifica, se usar�n los argumentos dados con --exec.

-t|--test

Muestra las acciones que se realizar�an y devuelve el valor apropiado, pero no hace nada.

-o|--oknodo

Devuelve un estado 0 en vez de 1 si no se realiza (realizasen) ninguna acci�n.

-q|--quiet

No muestra mensajes informativos, s�lo muestra mensajes de error.

-c|--chuid nombre-usuario|uid

Cambia a este usuario/uid antes de empezar el proceso. Adem�s puede especificar el grupo a�adiendo :, luego el grupo o el gid del mismo modo que har�a con la orden `chown' (usuario:grupo). Debe de darse cuenta que cuando se usa esta opci�n el grupo primario y complementario se cambian tambi�n, incluso si no se especifica --group . La opci�n --group es s�lo para grupos de los que el usuario no es miembro (como el grupo nobody ).

-r|--chroot directorio-ra�z

Efectua chdir y chroot a directorio-ra�z antes de empezar el proceso. Dese cuenta que el fichero del pid tambi�n es escrito despu�s de hacer el chroot.

-d|--chdir directorio

Efectua chdir a directorio antes de empezar el proceso. Esto se hace despu�s de efectuar chroot, si es que la opci�n -r|--chroot est� establecida. Si no se especifica, start-stop-daemon ejecutar� un chdir al directorio ra�z antes de empezar el proceso.

-b|--background

Usado t�picamente con programas que no se separan por s� mismos. Esta opci�n forzar� start-stop-daemon a hacer fork antes de empezar el proceso, y luego dejarlo en segundo plano. ATENCI�N: start-stop-daemon no puede comprobar el estado de salida si el proceso no puede ejecutarse por cualquier raz�n. Esto se hace como �ltimo recurso, y s�lo tiene sentido usarla en programas donde no tiene sentido que hagan fork por s� mismos, o no es factible a�adir el c�digo para que lo hagan por s� mismos.

-N|--nicelevel entero

Altera la prioridad del proceso antes de empezarlo.

-m|--make-pidfile

Se usa cuando se quiere comenzar un programa que no crea su propio fichero de pid. Esta opci�n hace que start-stop-daemon cree el fichero referido con --pidfile y coloque el pid dentro de �l justo antes de ejecutar el proceso. Dese cuenta que no se borrar� cuando termine el programa. NOTA: Esta caracter�stica no funciona en todos los casos. M�s notablemente cuando el programa que se ejecuta hace fork en su proceso principal. Por esto solamente es �til cuando se combina con la opci�n --background .

-v|--verbose

Muestra mensajes informativos detallados.

-H|--help

Muestra la ayuda y luego termina.

-V|--version

Muestra la versi�n y luego termina.

AUTORES

Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> basada en una versi�n previa de Ian Jackson <ian@chiark.greenend.org.uk>.

P�gina del manual de Klee Dienes <klee@mit.edu>, reformada parcialmente por Ian Jackson.

Traducida por Rub�n Porras <nahoo@inicia.es> Revisada por Santiago Vila <sanvila@unex.es>