66 lines
2.5 KiB
Groff
66 lines
2.5 KiB
Groff
|
. \" Manual Seite fuer fexecve
|
||
|
|
. \" @(#)fexecve.3 1.1
|
||
|
|
. \"
|
||
|
|
.if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
|
||
|
|
.if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
|
||
|
|
.if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
|
||
|
|
.if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
|
||
|
|
.if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
|
||
|
|
.if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-.75n'U
|
||
|
|
.if t .ds s \(*b
|
||
|
|
.if t .ds S SS
|
||
|
|
.if n .ds a ae
|
||
|
|
.if n .ds o oe
|
||
|
|
.if n .ds u ue
|
||
|
|
.if n .ds s sz
|
||
|
|
.TH FEXECVE 3 "15. Juli 1988" "J\*org Schilling" "Schily\'s LIBRARY FUNCTIONS"
|
||
|
|
.SH NAME
|
||
|
|
fexecve() \- executes a program
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.nf
|
||
|
|
.B
|
||
|
|
fexecve (name, in, out, err, argptr, envptr)
|
||
|
|
.B char *name;
|
||
|
|
.B FILE *in, *out, *err;
|
||
|
|
.B char **argptr, **envptr;
|
||
|
|
.fi
|
||
|
|
.SH DESCRIPTION
|
||
|
|
fexecve() causes the current process to execute a new program.
|
||
|
|
The text, data, and stack segments of the process are discarded
|
||
|
|
and replaced with the text and data sections of the new object
|
||
|
|
file and a new stack. The argument list and environment list
|
||
|
|
are copied into the new address space where they become the
|
||
|
|
arguments to the entry point of the new program.
|
||
|
|
.PP
|
||
|
|
name is a string containing the name of the object file to be
|
||
|
|
executed. If the name contains a slash (/), it is assumed to be
|
||
|
|
a pathname to the file. If there is no slash, fexecve()
|
||
|
|
searches for the file in a list of directories contained in the
|
||
|
|
environment variable PATH, or if there is no such variable, it
|
||
|
|
searches the working directory first, then /bin. The PATH
|
||
|
|
variable (which is taken from the new environment list envptr )
|
||
|
|
has a value which is a series of directory names separated by
|
||
|
|
colons. The working directory is represented in this list by
|
||
|
|
omitting a name (before the first colon, between two colons, or
|
||
|
|
after the last colon). Thus the default search rules may be
|
||
|
|
expressed as
|
||
|
|
.PP
|
||
|
|
.B "PATH=:/bin"
|
||
|
|
.PP
|
||
|
|
in, out, and err are files which are to be substituted for
|
||
|
|
stdin, stdout, and stderr, respectively, when the new program is
|
||
|
|
executed.
|
||
|
|
.PP
|
||
|
|
argptr and envptr are pointers to arrays of pointers to strings,
|
||
|
|
with a NULL pointer as the last element of the array. By
|
||
|
|
convention, argptr[0] is the name of the program.
|
||
|
|
.SH RETURNS
|
||
|
|
Returns a standard system error code; fexecve() does not return
|
||
|
|
if it succeeds, as the program that calls it is no longer in
|
||
|
|
this process's memory.
|
||
|
|
.SH NOTES
|
||
|
|
If a program needs to run another program without destroying
|
||
|
|
itself, it can use fork(), some variation of fexecve(), and
|
||
|
|
cwait(). These three functions are combined in spawnl() and
|
||
|
|
spawnv().
|