219 lines
7.8 KiB
C
219 lines
7.8 KiB
C
/***
|
|
*spawnvpe.c - spawn a child process with given environ (search PATH)
|
|
*
|
|
* Copyright (c) 1985-2001, Microsoft Corporation. All rights reserved.
|
|
*
|
|
*Purpose:
|
|
* defines _spawnvpe() - spawn a child process with given environ (search
|
|
* PATH)
|
|
*
|
|
*Revision History:
|
|
* 04-15-84 DFW written
|
|
* 10-29-85 TC added spawnvpe capability
|
|
* 11-19-86 SKS handle both kinds of slashes
|
|
* 12-01-86 JMB added Kanji file name support under conditional KANJI
|
|
* switches. Corrected header info. Removed bogus check
|
|
* for env = b after call to strncpy
|
|
* 12-11-87 JCR Added "_LOAD_DS" to declaration
|
|
* 09-05-88 SKS Treat EACCES the same as ENOENT -- keep trying
|
|
* 10-17-88 GJF Removed copy of PATH string to local array, changed
|
|
* bbuf to be a malloc-ed buffer. Removed bogus limits
|
|
* on the size of that PATH string.
|
|
* 10-25-88 GJF Don't search PATH when relative pathname is given (per
|
|
* Stevesa). Also, if the name built from PATH component
|
|
* and filename is a UNC name, allow any error.
|
|
* 05-17-89 MT Added "include <jstring.h>" under KANJI switch
|
|
* 05-24-89 PHG Reduce _amblksiz to use minimal memory (DOS only)
|
|
* 08-29-89 GJF Use _getpath() to retrieve PATH components, fixing
|
|
* several problems in handling unusual or bizarre
|
|
* PATH's.
|
|
* 11-20-89 GJF Added const attribute to types of filename, argv and
|
|
* envptr.
|
|
* 03-08-90 GJF Replaced _LOAD_DS with _CALLTYPE1, added #include
|
|
* <cruntime.h> and removed #include <register.h>
|
|
* 07-24-90 SBM Removed redundant includes, replaced <assertm.h> by
|
|
* <assert.h>
|
|
* 09-27-90 GJF New-style function declarator.
|
|
* 01-17-91 GJF ANSI naming.
|
|
* 09-25-91 JCR Changed ifdef "OS2" to "_DOS_" (unused in 32-bit tree)
|
|
* 11-30-92 KRS Port _MBCS code from 16-bit tree.
|
|
* 04-06-93 SKS Replace _CRTAPI* with __cdecl
|
|
* 12-07-93 CFW Wide char enable.
|
|
* 01-10-95 CFW Debug CRT allocs.
|
|
* 02-06-95 CFW assert -> _ASSERTE.
|
|
* 02-06-98 GJF Changes for Win64: changed return type to intptr_t.
|
|
*
|
|
*******************************************************************************/
|
|
|
|
#include <cruntime.h>
|
|
#include <errno.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <malloc.h>
|
|
#include <internal.h>
|
|
#include <process.h>
|
|
#include <mbstring.h>
|
|
#include <tchar.h>
|
|
#include <dbgint.h>
|
|
|
|
#define SLASH _T("\\")
|
|
#define SLASHCHAR _T('\\')
|
|
#define XSLASHCHAR _T('/')
|
|
#define DELIMITER _T(";")
|
|
|
|
#ifdef _MBCS
|
|
/* note, the macro below assumes p is to pointer to a single-byte character
|
|
* or the 1st byte of a double-byte character, in a string.
|
|
*/
|
|
#define ISPSLASH(p) ( ((p) == _mbschr((p), SLASHCHAR)) || ((p) == \
|
|
_mbschr((p), XSLASHCHAR)) )
|
|
#else
|
|
#define ISSLASH(c) ( ((c) == SLASHCHAR) || ((c) == XSLASHCHAR) )
|
|
#endif
|
|
|
|
/***
|
|
*_spawnvpe(modeflag, filename, argv, envptr) - spawn a child process
|
|
*
|
|
*Purpose:
|
|
* Spawns a child process with the given arguments and environ,
|
|
* searches along PATH for given file until found.
|
|
* Formats the parameters and calls _spawnve to do the actual work. The
|
|
* NULL environment pointer indicates that the new process will inherit
|
|
* the parents process's environment. NOTE - at least one argument must
|
|
* be present. This argument is always, by convention, the name of the
|
|
* file being spawned.
|
|
*
|
|
*Entry:
|
|
* int modeflag - defines mode of spawn (WAIT, NOWAIT, or OVERLAY)
|
|
* only WAIT and OVERLAY supported
|
|
* _TSCHAR *filename - name of file to execute
|
|
* _TSCHAR **argv - vector of parameters
|
|
* _TSCHAR **envptr - vector of environment variables
|
|
*
|
|
*Exit:
|
|
* returns exit code of spawned process
|
|
* if fails, returns -1
|
|
*
|
|
*Exceptions:
|
|
*
|
|
*******************************************************************************/
|
|
|
|
intptr_t __cdecl _tspawnvpe (
|
|
int modeflag,
|
|
REG3 const _TSCHAR *filename,
|
|
const _TSCHAR * const *argv,
|
|
const _TSCHAR * const *envptr
|
|
)
|
|
{
|
|
intptr_t i;
|
|
REG1 _TSCHAR *env;
|
|
REG2 _TSCHAR *buf = NULL;
|
|
_TSCHAR *pfin;
|
|
#ifdef _DOS_
|
|
int tempamblksiz; /* old _amblksiz */
|
|
#endif
|
|
_ASSERTE(filename != NULL);
|
|
_ASSERTE(*filename != _T('\0'));
|
|
_ASSERTE(argv != NULL);
|
|
_ASSERTE(*argv != NULL);
|
|
_ASSERTE(**argv != _T('\0'));
|
|
|
|
#ifdef _DOS_
|
|
tempamblksiz = _amblksiz;
|
|
_amblksiz = 0x10; /* reduce _amblksiz for efficient mallocs */
|
|
#endif
|
|
|
|
if (
|
|
(i = _tspawnve(modeflag, filename, argv, envptr)) != -1
|
|
/* everything worked just fine; return i */
|
|
|
|
|| (errno != ENOENT)
|
|
/* couldn't spawn the process, return failure */
|
|
|
|
|| (_tcschr(filename, XSLASHCHAR) != NULL)
|
|
/* filename contains a '/', return failure */
|
|
|
|
#ifdef _DOS_
|
|
|| (_tcschr(filename,SLASHCHAR) != NULL)
|
|
/* filename contains a '\', return failure */
|
|
|
|
|| *filename && *(filename+1) == _T(':')
|
|
/* drive specification, return failure */
|
|
#endif
|
|
|
|
|| !(env = _tgetenv(_T("PATH")))
|
|
/* no PATH environment string name, return failure */
|
|
|
|
|| ( (buf = _malloc_crt(_MAX_PATH * sizeof(_TSCHAR))) == NULL )
|
|
/* cannot allocate buffer to build alternate pathnames, return
|
|
* failure */
|
|
) {
|
|
#ifdef _DOS_
|
|
_amblksiz = tempamblksiz; /* restore old _amblksiz */
|
|
#endif
|
|
goto done;
|
|
}
|
|
|
|
#ifdef _DOS_
|
|
_amblksiz = tempamblksiz; /* restore old _amblksiz */
|
|
#endif
|
|
|
|
|
|
/* could not find the file as specified, search PATH. try each
|
|
* component of the PATH until we get either no error return, or the
|
|
* error is not ENOENT and the component is not a UNC name, or we run
|
|
* out of components to try.
|
|
*/
|
|
|
|
#ifdef WPRFLAG
|
|
while ( (env = _wgetpath(env, buf, _MAX_PATH - 1)) && (*buf) ) {
|
|
#else
|
|
while ( (env = _getpath(env, buf, _MAX_PATH - 1)) && (*buf) ) {
|
|
#endif
|
|
|
|
pfin = buf + _tcslen(buf) - 1;
|
|
|
|
/* if necessary, append a '/'
|
|
*/
|
|
#ifdef _MBCS
|
|
if (*pfin == SLASHCHAR) {
|
|
if (pfin != _mbsrchr(buf,SLASHCHAR))
|
|
/* fin is the second byte of a double-byte char */
|
|
strcat(buf, SLASH );
|
|
}
|
|
else if (*pfin !=XSLASHCHAR)
|
|
strcat(buf, SLASH);
|
|
#else
|
|
if (*pfin != SLASHCHAR && *pfin != XSLASHCHAR)
|
|
_tcscat(buf, SLASH);
|
|
#endif
|
|
/* check that the final path will be of legal size. if so,
|
|
* build it. otherwise, return to the caller (return value
|
|
* and errno rename set from initial call to _spawnve()).
|
|
*/
|
|
if ( (_tcslen(buf) + _tcslen(filename)) < _MAX_PATH )
|
|
_tcscat(buf, filename);
|
|
else
|
|
break;
|
|
|
|
/* try spawning it. if successful, or if errno comes back with a
|
|
* value other than ENOENT and the pathname is not a UNC name,
|
|
* return to the caller.
|
|
*/
|
|
if ( (i = _tspawnve(modeflag, buf, argv, envptr)) != -1
|
|
|| ((errno != ENOENT)
|
|
#ifdef _MBCS
|
|
&& (!ISPSLASH(buf) || !ISPSLASH(buf+1))) )
|
|
#else
|
|
&& (!ISSLASH(*buf) || !ISSLASH(*(buf+1)))) )
|
|
#endif
|
|
break;
|
|
|
|
}
|
|
|
|
done:
|
|
if (buf != NULL)
|
|
_free_crt(buf);
|
|
return(i);
|
|
}
|