Name

call_usermodehelper_keys — start a usermode application

Synopsis

int call_usermodehelper_keys (char *  path,
 char **  argv,
 char **  envp,
 struct key *  session_keyring,
 int  wait);

Arguments

path

pathname for the application

argv

null-terminated argument list

envp

null-terminated environment list

session_keyring

session keyring for process (NULL for an empty keyring)

wait

wait for the application to finish and return status.

Description

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).

Must be called from process context. Returns a negative error code if program was not execed successfully, or 0.