udisks_spawned_job_new ()

UDisksSpawnedJob *
udisks_spawned_job_new (const gchar *command_line,
                        const gchar *input_string,
                        uid_t run_as_uid,
                        uid_t run_as_euid,
                        UDisksDaemon *daemon,
                        GCancellable *cancellable);

Creates a new UDisksSpawnedJob instance.

The job is started immediately - connect to the “spawned-job-completed” or “completed” signals to get notified when the job is done.

udisks_spawned_job_get_command_line ()

const gchar *
udisks_spawned_job_get_command_line (UDisksSpawnedJob *job);

Gets the command line that job was constructed with.

UDisksSpawnedJob

typedef struct _UDisksSpawnedJob UDisksSpawnedJob;

The UDisksSpawnedJob structure contains only private data and should only be accessed using the provided API.

The “command-line” property

  “command-line”             gchar *

The command-line to run.

Flags: Read / Write / Construct Only

Default value: NULL

The “input-string” property

  “input-string”             gchar *

String that will be written to stdin of the spawned program or NULL to not write anything.

Flags: Write / Construct Only

Default value: NULL

The “run-as-euid” property

  “run-as-euid”              guint

The effective uid_t to run the program as.

Flags: Write / Construct Only

Default value: 0

The “run-as-uid” property

  “run-as-uid”               guint

The uid_t to run the program as.

Flags: Write / Construct Only

Default value: 0

The “spawned-job-completed” signal

gboolean
user_function (UDisksSpawnedJob *job,
               GError           *error,
               gint              status,
               GString          *standard_output,
               GString          *standard_error,
               gpointer          user_data)

Emitted when the spawned job is complete. If spawning the command failed or if the job was cancelled, error will non-NULL. Otherwise you can use macros such as WIFEXITED() and WEXITSTATUS() on the status integer to obtain more information.

The default implementation simply emits the “completed” signal with success set to TRUE if, and only if, error is NULL, WIFEXITED() evaluates to TRUE and WEXITSTATUS() is zero. Additionally, message on that signal is set to standard_error regards of whether success is TRUE or FALSE.

You can avoid the default implementation by returning TRUE from your signal handler.

This signal is emitted in the

thread-default main loop

of the thread that job was created in.

Flags: Run Last