Funciones _exec _wexec

Cada función de esta familia carga y ejecuta un proceso nuevo:

_execl, _wexecl
_execv, _wexecv
_execle, _wexecle

_execve, _wexecve
_execlp, _wexeclp
_execvp, _wexecvp

_execlpe, _wexeclpe
_execvpe, _wexecvpe

La última letra del nombre de función determina la variación.

_exec sufijo de función	Descripción
e	envp, una matriz de punteros a la configuración de entorno, se pasa al nuevo proceso.
l	Los argumentos de la línea de comandos se pasan individualmente a la función _exec. Se suele usar cuando el número de parámetros para el nuevo proceso se conoce de antemano.
p	La variable de entorno PATH se usa para buscar el archivo que se va a ejecutar.
v	argv, una matriz de punteros a los argumentos de la línea de comandos, se pasa a _exec. Se suele usar cuando el número de parámetros del proceso nuevo es variable.

Comentarios

Cada función _exec carga y ejecuta un proceso nuevo. Todas las funciones _exec usan la misma función del sistema operativo (CreateProcess). Las funciones _exec controlan automáticamente argumentos de cadena de caracteres multibyte como sea necesario, reconociendo las secuencias de caracteres multibyte en función de la página de códigos multibyte actualmente en uso. Las funciones _wexec son versiones con caracteres anchos de las funciones _exec. Las funciones _wexec se comportan de forma idéntica a las funciones correspondientes de la familia de _exec, salvo que no controlan las cadenas de caracteres multibyte.

Asignaciones de rutinas de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_texecl	_execl	_execl	_wexecl
_texecle	_execle	_execle	_wexecle
_texeclp	_execlp	_execlp	_wexeclp
_texeclpe	_execlpe	_execlpe	_wexeclpe
_texecv	_execv	_execv	_wexecv
_texecve	_execve	_execve	_wexecve
_texecvp	_execvp	_execvp	_wexecvp
_texecvpe	_execvpe	_execvpe	_wexecvpe

El parámetro de cmdname especifica el archivo que se va a ejecutar como nuevo proceso. Puede especificar una ruta de acceso completa (desde la raíz), una ruta de acceso parcial (desde el directorio de trabajo actual) o un nombre de archivo. Si cmdname no tiene una extensión de nombre de archivo o no termina con un punto (.), la función _exec busca el archivo con nombre. Si la búsqueda no obtiene resultado, intenta el mismo nombre base con la extensión de nombre de archivo .com y, después, con las extensiones de nombre de archivo .exe, .bat y .cmd. Si cmdname tiene una extensión de nombre de archivo, solo se usa esa extensión en la búsqueda. Si cmdname termina con un punto, la función _exec busca cmdname sin extensión de nombre de archivo. _execlp, _execlpe, _execvp y _execvpe buscan cmdname (usando los mismos procedimientos) en los directorios especificados por la variable de entorno PATH. Si cmdname contiene un especificador de unidad o barras diagonales (es decir, si es una ruta de acceso relativa), la llamada a _exec busca únicamente el archivo especificado y la ruta no se busca.

Los parámetros se pasan al proceso nuevo con uno o varios punteros a cadenas de caracteres como parámetros en la llamada a _exec. Estas cadenas de caracteres forman la lista de parámetros para el nuevo proceso. La longitud total de la configuración de entorno heredada y las cadenas que forman la lista de parámetros del nuevo proceso no debe ser mayor de 32 kilobytes. El carácter de terminación NULL (\0) de cada cadena no se incluye en el recuento, pero los caracteres de espacio (que se insertan automáticamente para separar los parámetros) sí se cuentan.

Nota:

Los espacios insertados en cadenas pueden generar un comportamiento inesperado; por ejemplo, si se pasa a _exec la cadena "hi there", el nuevo proceso obtendrá dos argumentos, "hi" y "there". Si se deseaba que el nuevo proceso abriera un archivo denominado “hi there”, el proceso produciría un error. Para evitarlo, escriba la cadena entre comillas: "\"hi there\"".

Importante

No pase datos proporcionados por el usuario a _exec sin comprobar expresamente su contenido. _exec dará lugar a una llamada a CreateProcess, por lo que debe tener presente que los nombres de ruta de acceso incompletos podrían dar lugar a vulnerabilidades de seguridad.

Las funciones _exec validan sus parámetros. Si los parámetros esperados son punteros nulos, cadenas vacías o se omiten, las _exec funciones invocan al controlador de parámetros no válidos, tal como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y devuelven -1. No se ejecuta ningún proceso nuevo.

Los punteros de argumento se pueden pasar como parámetros separados (_execl, _execle, _execlp y _execlpe) o como matriz de punteros (en _execv, _execve, _execvp y _execvpe). Se debe pasar al menos un parámetro, arg0, al nuevo proceso. Este parámetro es argv[0] del nuevo proceso. Normalmente, este parámetro es una copia de cmdname. (Un valor diferente no genera un error).

Las llamadas a _execl, _execle, _execlp y _execlpe se suelen usar cuando el número de parámetros se conoce de antemano. El parámetro arg0 suele ser un puntero a cmdname. Los parámetros de arg1 a argn señalan a las cadenas de caracteres que forman la nueva lista de parámetros. Un puntero nulo debe ir detrás de argn para marcar el final de la lista de parámetros.

Las llamadas a _execv, _execve, _execvp y _execvpe son útiles cuando el número de parámetros para el nuevo proceso es variable. Los punteros a los parámetros se pasan como matriz, argv. El parámetro argv[0] suele ser un puntero a cmdname. Los parámetros de argv[1] a argv[n] señalan a las cadenas de caracteres que forman la nueva lista de parámetros. El parámetro argv[n+1] debe ser un puntero NULL para marcar el final de la lista de parámetros.

Los archivos que están abiertos cuando se realiza una llamada a _exec permanecen abiertos en el nuevo proceso. En llamadas a _execl, _execlp, _execv y _execvp, el nuevo proceso hereda el entorno del proceso de llamada. Las llamadas a _execle, _execlpe, _execve y _execvpe modifican el entorno del nuevo proceso pasando una lista de configuración de entorno con el parámetro envp. envp es una matriz de punteros de caracteres, en la que cada elemento (salvo el elemento final) señala a una cadena terminada en NULL que define una variable de entorno. Esta cadena suele tener el formato NAME=value, donde NAME es el nombre de una variable de entorno y value es el valor de cadena en el que se establece la variable. (No value se incluye entre comillas dobles). El elemento final de la envp matriz debe ser NULL. Cuando envp es NULL, el nuevo proceso hereda la configuración de entorno del proceso de llamada.

Un programa que se ejecuta con una de las funciones _exec se carga siempre en la memoria como si el campo de asignación máxima del encabezado del archivo .exe del programa estuviera establecido en el valor predeterminado de 0xFFFFH.

Las llamadas a _exec no conservan los modos de traducción de los archivos abiertos. Si el nuevo proceso debe usar archivos heredados del proceso de llamada, use la rutina _setmode para establecer el modo de traducción de estos archivos en el modo deseado. Debe vaciar explícitamente (mediante fflush o _flushall) o cerrar todos los flujos antes de la llamada de la función _exec. Las configuraciones de las señales no se conservan en los nuevos procesos creados mediante llamadas a rutinas de _exec. Las configuraciones de las señales se restablecen a los valores predeterminados en el proceso nuevo.

Ejemplo

// crt_args.c
// Illustrates the following variables used for accessing
// command-line arguments and environment variables:
// argc  argv  envp
// This program will be executed by crt_exec which follows.

#include <stdio.h>

int main( int argc,  // Number of strings in array argv
char *argv[],       // Array of command-line argument strings
char **envp )       // Array of environment variable strings
{
    int count;

    // Display each command-line argument.
    printf( "\nCommand-line arguments:\n" );
    for( count = 0; count < argc; count++ )
        printf( "  argv[%d]   %s\n", count, argv[count] );

    // Display each environment variable.
    printf( "\nEnvironment variables:\n" );
    while( *envp != NULL )
        printf( "  %s\n", *(envp++) );

    return;
}

Ejecute el programa siguiente para ejecutar Crt_args.exe:

// crt_exec.c
// Illustrates the different versions of exec, including
//      _execl          _execle          _execlp          _execlpe
//      _execv          _execve          _execvp          _execvpe
//
// Although CRT_EXEC.C can exec any program, you can verify how
// different versions handle arguments and environment by
// compiling and specifying the sample program CRT_ARGS.C. See
// "_spawn, _wspawn Functions" for examples of the similar spawn
// functions.

#include <stdio.h>
#include <conio.h>
#include <process.h>

char *my_env[] =     // Environment for exec?e
{
   "THIS=environment will be",
   "PASSED=to new process by",
   "the EXEC=functions",
   NULL
};

int main( int ac, char* av[] )
{
   char *args[4];
   int ch;
   if( ac != 3 ){
      fprintf( stderr, "Usage: %s <program> <number (1-8)>\n", av[0] );
      return;
   }

   // Arguments for _execv?
   args[0] = av[1];
   args[1] = "exec??";
   args[2] = "two";
   args[3] = NULL;

   switch( atoi( av[2] ) )
   {
   case 1:
      _execl( av[1], av[1], "_execl", "two", NULL );
      break;
   case 2:
      _execle( av[1], av[1], "_execle", "two", NULL, my_env );
      break;
   case 3:
      _execlp( av[1], av[1], "_execlp", "two", NULL );
      break;
   case 4:
      _execlpe( av[1], av[1], "_execlpe", "two", NULL, my_env );
      break;
   case 5:
      _execv( av[1], args );
      break;
   case 6:
      _execve( av[1], args, my_env );
      break;
   case 7:
      _execvp( av[1], args );
      break;
   case 8:
      _execvpe( av[1], args, my_env );
      break;
   default:
      break;
   }

   // This point is reached only if exec fails.
   printf( "\nProcess was not execed." );
   exit( 0 );
}

Requisitos

Encabezado: process.h

Consulte también

Control de procesos y entornos
abort
atexit
exit, , _Exit, _exit
_onexit, _onexit_m
Funciones _spawn, _wspawn
system, _wsystem