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)