EXEC(3)

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'').