2 Copyright © 1995-2003, The AROS Development Team. All rights reserved.
5 spavnv() function, used to spawn new processes.
8 #include "__arosc_privdata.h"
10 #include <proto/dos.h>
11 #include <proto/exec.h>
13 #include <dos/dosextens.h>
14 #include <dos/filesystem.h>
15 #include <aros/debug.h>
22 #include <sys/syscall.h>
25 /*****************************************************************************
39 Spawn a child process, given a vector of arguments and an already LoadSeg()'d executable.
42 mode - the way the child process has to be loaded, and how the parent has to behave
43 after the child process is initiated. Specify one of the following values:
45 P_WAIT - the child program is loaded into memory, then it's executed while
46 the parent process waits for it to terminate, at which point the
47 patent process resumes execution.
49 P_NOWAIT - the parent program is executed concurrently with the new child process.
51 P_OVERLAY - teplace the parent program with the child program in memory and then
52 execute the child. The parent program will never be resumed. This
53 mode is equivalent to calling one of the exec*() functions.
55 filename - command to execute
57 searchpath - boolean to indicate if path should be searched for command
59 argv - a pointer to a NULL terminated array of strings representing arguments to pass
60 to the child process. The first entry in the array is conventionally the name of
61 the program to spawn, but in any case it must _never_ be NULL, and the argv
62 pointer itself must never be NULL either.
66 If P_WAIT is specified, then the return code of the child program is returned.
67 If instead P_NOWAIT is used, then the pid of the newly created process is returned.
68 Finally, if P_OVERLAY is used, the function doesn't return unless an error has occurred,
69 in which case -1 is returned also for the other modes and the global errno variable will
70 hold the proper error code.
74 The way the child process behaves regarding parent's file descriptors, signal handlers
75 and so on is the same way it would behave with one of the exec*(3) functions.
76 This, for one, means that all filedescriptors are inherited except the ones which have
77 the close-on-exec flag set.
84 execl(), execle(), execlp(), execlpe(), execv(), execve(), execvp(), execvpe(), getenv(),
85 putenv(), setenv(), spawn(), spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnp(),
86 spawnve(), spawnvp(), spawnvpe(), wait(), waitpid()
90 For now only the stdin, stout and stderr file descriptors are inherited, and signals
93 ******************************************************************************/
105 D(bug("__spawnv: vfork pid = %d\n", pid
));
111 D(bug("__spawnv: From parent child returned %d from execv,\n"
112 " errno = %d\n", ret
, errno
));
113 /* Child exec did return => error */
121 waitpid(pid
, &status
, 0);
123 if (WIFEXITED(status
))
124 return WEXITSTATUS(status
);
126 /* FIXME: Is this the right thing to do ? */
129 else /* mode == P_NOWAIT */
135 ret
= execvp(filename
, argv
);
137 ret
= execv(filename
, argv
);
139 D(bug("__spawnv: Child exec returned %d\n", ret
));
143 else /* Error in vfork */
151 return execvp(filename
, argv
);
153 return execv(filename
, argv
);
164 assert(0); /* Should not be reached */