>
gnome-execGnome Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gnome.h> int gnome_execute_async (const char *dir, int argc, char *const argv[]); int gnome_execute_async_fds (const char *dir, int argc, char *const argv[], |
The gnome-execute family of functions are provided to simplify execution of programs from withing GNOME applications. These routines are required to avoid passing opened file descriptors to a child process (like the X11 sockets and CORBA sockets). They will also make sure to terminate properly.
The range of possibilities goes from the most simple use to the most specialized ones.
int gnome_execute_async (const char *dir, int argc, char *const argv[]); |
Like gnome_execute_async_with_env(), but doesn't add anything to child's environment.
dir : | Directory in which child should be execd, or NULL for current directory |
argc : | Number of arguments |
argv : | Argument vector to exec child |
Returns : | process id of child, or -1 on error. |
int gnome_execute_async_fds (const char *dir, int argc, char *const argv[], |
dir : | Directory in which child should be execd, or NULL for current directory |
argc : | Number of arguments |
argv : | Argument vector to exec child |
close_fds : | Like gnome_execute_async_with_env_fds(), but doesn't add anything to child's environment. |
Returns : | process id of child, or -1 on error. |
int gnome_execute_async_with_env (const char *dir, int argc, char *const argv[], int envc, char *const envv[]); |
This function forks and executes some program in the background. On error, returns -1; in this case, errno should hold a useful value. Searches the path to find the child. Environment settings in envv are added to the existing environment -- they do not completely replace it. This function closes all fds besides 0, 1, and 2 for the child
dir : | Directory in which child should be execd, or NULL for current directory |
argc : | Number of arguments |
argv : | Argument vector to exec child |
envc : | Number of environment slots |
envv : | Environment vector |
Returns : | the process id, or -1 on error. |
int gnome_execute_async_with_env_fds (const char *dir, int argc, char *const argv[], int envc, char *const envv[], |
Like gnome_execute_async_with_env() but has a flag to decide whether or not * to close fd's
dir : | Directory in which child should be execd, or NULL for current directory |
argc : | Number of arguments |
argv : | Argument vector to exec child |
envc : | Number of environment slots |
envv : | Environment vector |
close_fds : | If TRUE will close all fds but 0,1, and 2 |
Returns : | the process id, or -1 on error. |
int gnome_execute_shell (const char *dir, const char *commandline); |
Like gnome_execute_async_with_env(), but uses the user's shell to run the desired program. Note that the pid of the shell is returned, not the pid of the user's program.
dir : | Directory in which child should be execd, or NULL for current directory |
commandline : | Shell command to execute |
Returns : | process id of shell, or -1 on error. |
int gnome_execute_shell_fds (const char *dir, const char *commandline, |
dir : | Directory in which child should be execd, or NULL for current directory |
commandline : | Shell command to execute |
close_fds : | Like close_fds in gnome_execute_async_with_env_fds() Like gnome_execute_async_with_env_fds(), but uses the user's shell to run the desired program. Note that the pid of the shell is returned, not the pid of the user's program. |
Returns : | process id of shell, or -1 on error. |