Provided by: dpkg_1.16.0.3ubuntu5_i386 bug

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.