summaryrefslogblamecommitdiffstats
path: root/private/crt32/exec/spawnv.c
blob: fe90c213f1e332d8ec3e2d36bc1334db88c0fdbb (plain) (tree)


































































                                                                                
/***
*spawnv.c - spawn a child process
*
*	Copyright (c) 1985-1991, Microsoft Corporation. All rights reserved.
*
*Purpose:
*	defines _spawnv() - spawn a child process
*
*Revision History:
*	04-15-84  DFW	written
*	12-11-87  JCR	Added "_LOAD_DS" to declaration
*	11-20-89  GJF	Fixed copyright, alignment. Added const to arg types
*			for pathname and argv.
*	03-08-90  GJF	Replace _LOAD_DS with _CALLTYPE1 and added #include
*			<cruntime.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.
*	02-14-90  SRW   Use NULL instead of _environ to get default.
*
*******************************************************************************/

#include <cruntime.h>
#include <assert.h>
#include <stdlib.h>
#include <process.h>

/***
*int _spawnv(modeflag, pathname, argv) - spawn a child process
*
*Purpose:
*	Spawns a child process.
*	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   - mode to spawn (WAIT, NOWAIT, or OVERLAY)
*			 only WAIT and OVERLAY currently implemented
*	char *pathname - file to spawn
*	char **argv    - vector of arguments
*
*Exit:
*	returns exit code of child process
*	if fails, returns -1
*
*Exceptions:
*
*******************************************************************************/

int _CALLTYPE1 _spawnv (
	int modeflag,
	const char *pathname,
	const char * const *argv
	)
{
	assert(pathname != NULL);
	assert(*pathname != '\0');
	assert(argv != NULL);
	assert(*argv != NULL);
	assert(**argv != '\0');

	return(_spawnve(modeflag,pathname,argv,NULL));
}