NOMBRE

       execve - ejecuta un programa

SINOPSIS

       #include <unistd.h>

       int execve (const char *filename, const char *argv [], const char *envp[]);

DESCRIPCIÓN

       execve()  ejecuta  el programa indicado por filename.  filename debe ser bien un binario ejecutable, bien
       un guión shell (shell script) comenzando con una línea de la forma "#! intérprete [arg]". En  el  segundo
       caso, el intérprete debe ser un nombre de camino válido para un ejecutable que no sea él mismo un guión y
       que será ejecutado como intérprete [arg] filename.

       argv  es  un  array  de  cadenas  de  argumentos pasados al nuevo programa.  envp es un array de cadenas,
       convencionalmente de la forma clave=valor, que se pasan como entorno al nuevo programa.  Tanto argv  como
       envp  deben terminar en un puntero nulo. El vector de argumentos y el entorno pueden ser accedidos por la
       función "main" del programa invocado cuando  se  define  como  int  main(int  argc,  char  *argv[],  char
       *envp[]).

       execve()  no  regresa  en  caso  de  éxito,  y  el  código, datos, bss y la pila del proceso invocador se
       reescriben con los correspondientes del programa cargado. El programa invocado hereda el PID del  proceso
       invocador  y  cualquier  descriptor  de  fichero  abierto  que  no  se  halla configurado para "cerrar en
       ejecución" (close on exec). Las señales pendientes del proceso  invocador  se  limpian.  Cualquier  señal
       capturada por el proceso invocador es devuelta a su comportamiento por defecto.  La señal SIGCHLD (cuando
       está puesta a SIG_IGN) puede o no puede ser reiniciada a SIG_DFL.

       Si  el programa actual está bajo inspección de ptrace, se le enviará una señal  SIGTRAP trás la ejecución
       exitosa de execve().

       Si el bit "set-uid" está activo en el fichero del programa indicado por filename,  se  cambia  el  ID  de
       usuario  efectivo  del  proceso  invocador  al  del propietario del fichero del programa. De igual forma,
       cuando el bit "set-gid" del fichero del programa está activo, se cambia el  ID  del  grupo  efectivo  del
       proceso invocador al del grupo del fichero del programa.

       Si  el  ejecutable  es  un  ejecutable  binario  a.out  enlazado  dinámicamente  que  contiene "stubs" de
       bibliotecas compartidas, se llama al enlazador dinámico de Linux, ld.so(8), al comienzo de  la  ejecución
       para traer al núcleo las bibliotecas compartidas necesarias y enlazar el ejecutable con ellas.

       Si  el  ejecutable  es  un ejecutable ELF enlazado dinámicamente, se usa el intérprete especificado en el
       segmento PT_INTERP para cargar las bibliotecas compartidas  necesarias.  Este  intérprete  es  usualmente
       /lib/ld-linux.so.1  para los binarios enlazados con la versión 5 de la libc de Linux o /lib/ld-linux.so.2
       para los binarios enlazados con la versión 2 de la libc de GNU.

VALOR DEVUELTO

       En caso de éxito execve() no regresa mientras que en caso de error el  valor  devuelto  es  -1,  y  a  la
       variable errno se le asigna un valor apropiado.

ERRORES

       EACCES El fichero o el intérprete de guiones no es un fichero regular.

       EACCES Se  ha  denegado  el  permiso  de  ejecución  para el fichero o para el intérprete de guiones o el
              intérprete ELF.

       EACCES El sistema de ficheros está montado con la opción noexec.

       EPERM  El sistema de ficheros está montado con la opción nosuid, el usuario no es el  superusuario  y  el
              fichero tiene activo el bit SUID o SGID.

       EPERM  El  proceso está siendo ejecutado paso a paso, el usuario no es el superusuario y el fichero tiene
              activo el bit SUID o SGID.

       E2BIG  La lista de argumentos es demasiado grande.

       ENOEXEC
              El ejecutable no se encuentra en un formato reconocible, es para  una  arquitectura  incorrecta  o
              tiene algún otro error de formato que impide su ejecución.

       EFAULT filename apunta fuera de su espacio de direcciones accesible.

       ENAMETOOLONG
              filename es demasiado largo.

       ENOENT El  fichero filename no existe o no existe un intérprete de guiones o un intérprete ELF, o no pudo
              encontrarse una biblioteca compartida necesitada por el fichero o el intérprete.

       ENOMEM No hay suficiente memoria disponible en el núcleo.

       ENOTDIR
              Un componente del camino filename o del camino del intérprete de guiones o del intérprete  ELF  no
              es un directorio.

       EACCES Se  ha  denegado el permiso de búsqueda en uno de los componentes del camino filename o del camino
              del intérprete de guiones.

       ELOOP  Se han econtrado demasiados enlaces simbólicos al resolver filename, el nombre del  intérprete  de
              guiones o el nombre del intérprete ELF.

       ETXTBSY
              Uno o más procesos han abierto el ejecutable para escritura.

       EIO    Se ha producido un error de E/S.

       ENFILE Se ha alcanzado el límite del número total de ficheros abiertos en el sistema.

       EMFILE El proceso ya tiene abiertos el número máximo de fichero.

       EINVAL El ejecutable ELF tiene más de un segmento PT_INTERP (es decir, ha intentado especificar más de un
              intérprete).

       EISDIR El intérprete ELF es un directorio.

       ELIBBAD
              El intérprete ELF no está en un formato reconocible.

CONFORME A

       SVr4,  SVID,  X/OPEN  y  BSD  4.3.   POSIX  no documenta el significado de #! pero, en cualquier caso, es
       compatible. SVr4 documenta las condiciones  de  error  adicionales  EAGAIN,  EINTR,  ELIBACC,  ENOLINK  y
       EMULTIHOP;  POSIX  no  documenta  las  condiciones  de  error ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE,
       EMFILE, EINVAL, EISDIR ni ELIBBAD.

OBSERVACIONES

       Procesos SUID y SGID no pueden ser inspeccionados con ptrace().

       Linux ignora los bits SUID y SGID en los guiones shell.

       El resultado de montar un sistema de ficheros con la opción nosuid varía entre  las  distintas  versiones
       del  núcleo  Linux:  algunas se negarán a ejecutar ejecutables con los bits SUID/SGID cuando ésto pudiera
       dar al usuario poderes que no tenía antes (devolviendo  EPERM),  otras  simplemente  ignorarán  los  bits
       SUID/SGID y los ejecutarán sin más.

       La  longitud  máxima  de  línea en un ejecutable del tipo #! es de 127 caracteres en la primera línea del
       fichero.

VÉASE TAMBIÉN

       chmod(2), fork(2), execl(3), environ(5), ld.so(8)

Linux 2.0.30                                    3 septiembre 1997                                      EXECVE(2)