.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "CALL_USERMODEHELPER" "" "06 October 2005" "" ""

.SH NAME
call_usermodehelper \- start a usermode application
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int call_usermodehelper  (char * \fIpath\fB, char ** \fIargv\fB, char ** \fIenvp\fB, int \fIwait\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpath\fB\fR
pathname for the application
.TP
\fB\fIargv\fB\fR
null-terminated argument list
.TP
\fB\fIenvp\fB\fR
null-terminated environment list
.TP
\fB\fIwait\fB\fR
wait for the application to finish and return status.
.SH "DESCRIPTION"
.PP
Runs a user-space application.  The application is started
asynchronously if wait is not set, and runs as a child of keventd.
(ie. it runs with full root capabilities).
.PP
Must be called from process context.  Returns a negative error code
if program was not execed successfully, or 0.