NOMBRE

       execl, execlp, execle, execv, execvp - ejecutan un fichero

SINOPSIS

       #include <unistd.h>

       extern char **environ;

       int execl(const char *path, const char *arg, ...);
       int execlp(const char *file, const char *arg, ...);
       int execle(const char *path, const char *arg , ..., char * const envp[]);
       int execv(const char *path, char *const argv[]);
       int execvp(const char *file, char *const argv[]);

DESCRIPCIÓN

       La  familia  de funciones exec reemplaza la imagen del proceso en curso con una nueva. Las
       funciones descritas en esta página del Manual son interfaces para la primitiva  execve(2).
       (Consulte  la  página del Manual de execve para información detallada acerca del reemplazo
       del proceso en curso.)

       El primer argumento de estas funciones es el camino de un fichero que va a ser ejecutado.

       El const char *arg y puntos suspensivos siguientes  en  las  funciones  execl,  execlp,  y
       execle  pueden  ser  contemplados como arg0, arg1, ..., argn.  Todos juntos, describen una
       lista de uno o más punteros a cadenas de caracteres terminadas en cero, que representan la
       lista  de  argumentos  disponible  para  el  programa  ejecutado. El primer argumento, por
       convenio, debe apuntar  al  nombre  de  fichero  asociado  con  el  fichero  que  se  esté
       ejecutando. La lista de argumentos debe ser terminada por un puntero NULL.

       Las  funciones  execv y execvp proporcionan un vector de  punteros a cadenas de caracteres
       terminadas en cero, que representan la  lista  de  argumentos  disponible  para  el  nuevo
       programa.  El  primer  argumento, por convenio, debe apuntar al nombre de fichero asociado
       con el fichero que se esté ejecutando. El vector de punteros debe  ser  terminado  por  un
       puntero NULL.

       La  función  execle  también  especifica  el  entorno  del  proceso  ejecutado mediante un
       parámetro adicional que va detrás del puntero NULL que termina la lista de  argumentos  de
       la  lista de parámetros o el puntero al vector argv. Este parámetro adicional es un vector
       de punteros a cadenas de caracteres acabadas en cero y debe ser terminada por  un  puntero
       NULL.   Las  otras  funciones  obtienen  el  entorno para la nueva imagen de proceso de la
       variable externa environ en el proceso en curso.

       Algunas de estas funciones tienen una semántica especial.

       Las funciones execlp y execvp duplicarán las acciones  del  shell  al  buscar  un  fichero
       ejecutable si el nombre de fichero especificado no contiene un carácter de barra inclinada
       (/). El camino de búsqueda es el especificado en el entorno por la variable PATH.  Si esta
       variable  no  es  especificada,  se  emplea  el  camino predeterminado ``:/bin:/usr/bin''.
       Además, ciertos errores se tratan de forma especial.

       Si a un fichero se le deniega el permiso (la función intentada  execve  devuelve  EACCES),
       estas  funciones  continuarán  buscando  en  el  resto  del  camino  de búsqueda. Si no se
       encuentra otro fichero, empero, retornarán dando el valor  EACCES  a  la  variable  global
       errno .

       Si  no  se  reconoce  la  cabecera  de  un  fichero  (la función intentada execve devuelve
       ENOEXEC), estas funciones ejecutarán el shell con el camino del  fichero  como  su  primer
       argumento. (Si este intento falla, no se busca más.)

VALOR DEVUELTO

       Si  cualquiera  de  las  funciones  exec regresa, es que ha ocurrido un error. El valor de
       retorno es -1, y en la variable global errno se pondrá el código de error adecuado.

FICHEROS

       /bin/sh

ERRORES

       Todas estas funciones pueden fallar y dar un valor a errno para cualquiera de los  errores
       especificados para la función execve(2).

VÉASE TAMBIÉN

       sh(1), execve(2), fork(2), environ(5), ptrace(2)

COMPATIBILIDAD

       En algunos otros sistemas, la ruta por defecto (utilizada cuando el entorno no contiene la
       variable PATH) tiene el directorio de trabajo listado detrás de /bin y /usr/bin, como  una
       medida  anti-caballo  de  Troya. Linux utiliza aquí la ruta por defecto con el tradicional
       "el directorio de trabajo, el primero".

       El comportamiento de execlp y execvp cuando hay errores al intentar ejecutar el fichero es
       una  práctica de antiguo, pero tradicionalmente no ha sido documentada y el estándar POSIX
       no lo especifica. BSD (y quizás otros sistemas) hacen un sleep() automático y un reintento
       a  continuación,  si  se  encuentra  el  error  ETXTBSY.  Linux  trata  esto como un error
       importante y el regreso de la función es inmediato.

       Tradicionalmente, las funciones execlp y execvp hacían caso omiso  de  todos  los  errores
       salvo  los  descritos  arriba  y  ENOMEM y E2BIG, que provocaban el regreso. Ahora también
       regresan si tiene lugar algún error distinto de los descritos anteriormente.

CONFORME A

       execl, execv, execle, execlp y execvp son conformes con IEEE Std1003.1-88 (``POSIX.1'').