44 lines
2.0 KiB
HTML
44 lines
2.0 KiB
HTML
<html><!-- This HTML file has been created by texi2html 1.29
|
|
from syscalls.texi on 4 June 1994 -->
|
|
|
|
<TITLE>Syscall specifications of Linux - execve</TITLE>
|
|
<P>Go to the <A HREF="syscalls_57.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_57.html">previous</A>, <A HREF="syscalls_59.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_59.html">next</A> section.<P>
|
|
<H2><A NAME="SEC58" HREF="syscalls_toc.html#SEC58" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_toc.html#SEC58">execve</A></H2>
|
|
<P>
|
|
<H3>SYNOPSIS</H3>
|
|
<P>
|
|
<CODE>int execve (const char *<VAR>filename</VAR>, const char *<VAR>argv</VAR>[],
|
|
const char *<VAR>envp</VAR>[]);</CODE>
|
|
<P>
|
|
<H3>PARAMETERS</H3>
|
|
<P>
|
|
<VAR>filename</VAR>: [in] the path of the executable file.
|
|
<P>
|
|
<VAR>argv</VAR>: [in] the parameter vector for this invocation.
|
|
<P>
|
|
<VAR>envp</VAR>: [in] the environment in which to start the new text.
|
|
<P>
|
|
<H3>DESCRIPTION</H3>
|
|
<P>
|
|
Overwrites the current task with a new executable file on disk using the
|
|
parameter vector environement specified by the call. The opened files
|
|
not maked close on exec remain opened after the call.
|
|
<P>
|
|
<H3>RETURN VALUE</H3>
|
|
<P>
|
|
On success, does not return. On error, returns -1 and <CODE>errno</CODE> is set
|
|
to one of the following values:
|
|
<P>
|
|
<UL>
|
|
<LI><CODE>EACCESS</CODE>: the file is not a regular file or is not
|
|
executable.
|
|
<LI><CODE>EPERM</CODE>: the file system does not permit execution at all or
|
|
the file has the SUID or SGID bit set but the file system does not
|
|
permit SUID or SGID execution.
|
|
<LI><CODE>E2BIG</CODE>, <CODE>ENOEXEC</CODE>, <CODE>EFAULT</CODE>, <CODE>ENAMETOOLONG</CODE>,
|
|
<CODE>ENOENT</CODE>, <CODE>ENOMEM</CODE>, <CODE>ENOTDIR</CODE>, <CODE>EACCESS</CODE> and
|
|
<CODE>ELOOP</CODE> all have their standard meanings.
|
|
</UL>
|
|
<P>
|
|
<P>Go to the <A HREF="syscalls_57.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_57.html">previous</A>, <A HREF="syscalls_59.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_59.html">next</A> section.<P>
|