Provided by: dpkg_1.15.8.4ubuntu3_i386 bug

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.