NOMBRE

       system - ejecuta una orden del intérprete de órdenes (shell)

SINOPSIS

       #include <stdlib.h>

       int system(const char *string);

DESCRIPCIÓN

       system()  ejecuta una orden especificada en string llamando a /bin/sh -c string, y regresa después de que
       la orden se haya terminado de ejecutar.  Durante la ejecucion de la orden, se bloqueará SIGCHLD y  no  se
       hace caso de las señales SIGINT ni SIGQUIT.

VALOR DEVUELTO

       El  valor  devuelto  es  -1  en caso de error (p.e. falló la llamada a fork), y el estado devuelto por la
       orden en caso contrario.  Este último valor está en el formato especificado en wait(2).  Así,  el  código
       de  salida de la orden será WEXITSTATUS(status).  En caso de que /bin/sh no pudiera ejecutarse, el estado
       de salida será el de una orden que haga exit(127).  Si el valor de string es NULL, system()  devuelve  un
       número distinto de cero si hay un intérprete de órdenes disponible, y cero si no.

       system() no afecta al estado de espera de cualquier otro proceso hijo.

CONFORME A

       C ANSI, POSIX.2, BSD 4.3

OBSERVACIONES

       Como se mencionó, system() ignora SIGINT y SIGQUIT. Esto puede hacer que los programas que invocan a esta
       función  desde  un  bucle  sean  ininterrumpibles,  a menos que se preocupen ellos mismos de comprobar el
       estado de salida del hijo. P.e.

           while(algo) {
               int ret = system("foo");

               if (WIFSIGNALED(ret) &&
                   (WTERMSIG(ret) == SIGINT || WTERMSIG(ret) == SIGQUIT))
                       break;
           }

       No llame a system() desde un programa con privilegios suid o sgid, porque pudiera ser  que  se  emplearan
       valores  extraños  para  algunas  variables de entorno para comprometer la integridad del sistema.  En su
       lugar emplee la familia de funciones exec(3), salvo execlp(3) o  execvp(3).   system()  ,  de  hecho,  no
       funcionará  apropiadamente  desde  programas con privilegios suid o sgid en sistemas donde /bin/sh sea la
       versión 2 de bash, puesto que bash 2 elimina los privilegios en el arranque.   (Debian  usa  una  versión
       modificada de bash que no hace ésto cuando es invocado como sh.)

       En realidad no se comprueba si el intérprete de órdenes /bin/sh está disponible o no; en Linux siempre se
       supone  que  lo  está.  ISO  C  especifica la comprobación, pero POSIX.2 especifica que el valor devuelto
       siempre será no cero, ya que un sistema sin intérprete de órdenes no es conforme, y esto  es  lo  que  se
       implementa.

       Es  posible que una orden del intérprete de órdenes devuelva 127, así que ese código no es una indicación
       segura de que execve() haya fallado.

VÉASE TAMBIÉN

       sh(1), signal(2), wait(2), exec(3)

                                               23 septiembre 2001                                      SYSTEM(3)