1FEXECVE(3)                 Linux Programmer's Manual                FEXECVE(3)
2
3
4

NAME

6       fexecve - execute program specified via file descriptor
7

SYNOPSIS

9       #define _GNU_SOURCE
10       #include <unistd.h>
11
12       int fexecve(int fd, char *const argv[], char *const envp[]);
13

DESCRIPTION

15       fexecve() performs the same task as execve(2), with the difference that
16       the file to be executed is specified via a file descriptor, fd,  rather
17       than  via a pathname.  The file descriptor fd must be opened read-only,
18       and the caller must have permission to execute the file that it  refers
19       to.
20

RETURN VALUE

22       A  successful  call to fexecve() never returns.  On error, the function
23       returns, with a result value of -1, and errno is set appropriately.
24

ERRORS

26       Errors are as for execve(2), with the following additions:
27
28       EINVAL fd is not a valid file descriptor, or argv is NULL, or  envp  is
29              NULL.
30
31       ENOSYS The /proc file system could not be accessed.
32

VERSIONS

34       fexecve() is implemented since glibc 2.3.2.
35

CONFORMING TO

37       POSIX.1-2008.   This  function is not specified in POSIX.1-2001, and is
38       not widely available on other systems.
39

NOTES

41       On Linux, fexecve() is implemented using the proc(5)  file  system,  so
42       /proc needs to be mounted and available at the time of the call.
43

SEE ALSO

45       execve(2)
46

COLOPHON

48       This  page  is  part of release 3.22 of the Linux man-pages project.  A
49       description of the project, and information about reporting  bugs,  can
50       be found at http://www.kernel.org/doc/man-pages/.
51
52
53
54Linux                             2009-02-04                        FEXECVE(3)
Impressum