Changeset View
Changeset View
Standalone View
Standalone View
lib/libc/gen/exec.3
Show All 22 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)exec.3 8.3 (Berkeley) 1/24/94 | .\" @(#)exec.3 8.3 (Berkeley) 1/24/94 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd January 5, 2016 | .Dd April 6, 2018 | ||||
.Dt EXEC 3 | .Dt EXEC 3 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm execl , | .Nm execl , | ||||
.Nm execlp , | .Nm execlp , | ||||
.Nm execle , | .Nm execle , | ||||
.Nm exect , | .Nm exect , | ||||
.Nm execv , | .Nm execv , | ||||
▲ Show 20 Lines • Show All 158 Lines • ▼ Show 20 Lines | |||||
.Er ENOEXEC ) , | .Er ENOEXEC ) , | ||||
these functions will execute the shell with the path of | these functions will execute the shell with the path of | ||||
the file as its first argument. | the file as its first argument. | ||||
(If this attempt fails, no further searching is done.) | (If this attempt fails, no further searching is done.) | ||||
.Pp | .Pp | ||||
The function | The function | ||||
.Fn exect | .Fn exect | ||||
executes a file with the program tracing facilities enabled (see | executes a file with the program tracing facilities enabled (see | ||||
.Xr ptrace 2 ) . | .Xr ptrace 2 ) . | ||||
This function is not portable and is deprecated in favor of using the | |||||
.Xr ptrace 2 | |||||
facilities. | |||||
brooks: Line break after `.` and after `2` in the next line. You'd also want to bump the doc data `. | |||||
.Sh RETURN VALUES | .Sh RETURN VALUES | ||||
If any of the | If any of the | ||||
.Fn exec | .Fn exec | ||||
functions returns, an error will have occurred. | functions returns, an error will have occurred. | ||||
The return value is \-1, and the global variable | The return value is \-1, and the global variable | ||||
.Va errno | .Va errno | ||||
will be set to indicate the error. | will be set to indicate the error. | ||||
.Sh FILES | .Sh FILES | ||||
▲ Show 20 Lines • Show All 107 Lines • Show Last 20 Lines |
Line break after . and after 2 in the next line. You'd also want to bump the doc data .Dd above.