Function

GLib-2.0 ▶ GLib ▶ spawn_async

  • Executes a child program asynchronously.

    See g_spawn_async_with_pipes_and_fds() for a full description; this function simply calls the g_spawn_async_with_pipes() without any pipes, which in turn calls g_spawn_async_with_pipes_and_fds().

    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: string

      child's current working directory, or null to inherit parent's

    • argv: string[]

      child's argument vector

    • envp: string[]

      child's environment, or null to inherit parent's

    • flags: GLib.SpawnFlags

      flags from GLib.SpawnFlags

    • Optionalchild_setup: SpawnChildSetupFunc

      function to run in the child just before exec()

    Returns [boolean, number]

    true on success, false if error is set