Function

GLibspawn_async

Declaration

gboolean
g_spawn_async (
  const gchar* working_directory,
  gchar** argv,
  gchar** envp,
  GSpawnFlags flags,
  GSpawnChildSetupFunc child_setup,
  gpointer user_data,
  GPid* child_pid,
  GError** error
)

Description

Executes a child program asynchronously.

See g_spawn_async_with_pipes() for a full description; this function simply calls the g_spawn_async_with_pipes() without any pipes.

You should call g_spawn_close_pid() on the returned child process reference when you don’t need it any more.

If you are writing a GTK application, and the program you are spawning is a graphical application too, then to ensure that the spawned program opens its windows on the right screen, you may want to use GdkAppLaunchContext, GAppLaunchContext, or set the DISPLAY environment variable.

Note that the returned child_pid on Windows is a handle to the child process and not its identifier. Process handles and process identifiers are different concepts on Windows.

Parameters

working_directory const gchar*
 

Child’s current working directory, or NULL to inherit parent’s.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a file system path, using the OS encoding.
argv An array of filename
 
child's argument vector.
 The array must be NULL-terminated.
 The data is owned by the caller of the function.
 Each element is a file system path, using the OS encoding.
envp An array of filename
 
child's environment, or `NULL` to inherit parent's.
 The argument can be NULL.
 The array must be NULL-terminated.
 The data is owned by the caller of the function.
 Each element is a file system path, using the OS encoding.
flags GSpawnFlags
 

Flags from GSpawnFlags.

child_setup GSpawnChildSetupFunc
 

Function to run in the child just before exec()

 The argument can be NULL.
user_data gpointer
 

User data for child_setup.

 The argument can be NULL.
 The data is owned by the caller of the function.
child_pid GPid
 

Return location for child process reference, or NULL.

 The argument will be set by the function.
 The argument can be NULL.
 The called function takes ownership of the data, and is responsible for freeing it.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: gboolean
 

TRUE on success, FALSE if error is set.