Top | ![]() |
![]() |
![]() |
![]() |
IdeRunner * | ide_runner_new () |
gboolean | ide_runner_get_failed () |
void | ide_runner_set_failed () |
IdeRuntime * | ide_runner_get_runtime () |
void | ide_runner_force_quit () |
IdeEnvironment * | ide_runner_get_environment () |
void | ide_runner_run_async () |
gboolean | ide_runner_run_finish () |
GSubprocessFlags | ide_runner_get_flags () |
void | ide_runner_set_flags () |
const gchar * | ide_runner_get_cwd () |
void | ide_runner_set_cwd () |
gboolean | ide_runner_get_clear_env () |
void | ide_runner_set_clear_env () |
void | ide_runner_prepend_argv () |
void | ide_runner_append_argv () |
void | ide_runner_push_args () |
gchar ** | ide_runner_get_argv () |
void | ide_runner_set_argv () |
gint | ide_runner_take_fd () |
GOutputStream * | ide_runner_get_stdin () |
GInputStream * | ide_runner_get_stdout () |
GInputStream * | ide_runner_get_stderr () |
gboolean | ide_runner_get_run_on_host () |
void | ide_runner_set_run_on_host () |
void | ide_runner_set_tty () |
gint | ide_runner_steal_tty () |
IdeBuildTarget * | ide_runner_get_build_target () |
void | ide_runner_set_build_target () |
GStrv | argv | Read / Write |
IdeBuildTarget * | build-target | Read / Write |
gboolean | clear-env | Read / Write |
gchar * | cwd | Read / Write |
IdeEnvironment * | environment | Read |
gboolean | failed | Read / Write |
gboolean | run-on-host | Read / Write |
IdeRuntime *
ide_runner_get_runtime (IdeRunner *self
);
This function will get the IdeRuntime that will be used to execute the application. Consumers may want to use this to determine if a particular program is available (such as gdb, perf, strace, etc).
void ide_runner_run_async (IdeRunner *self
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
gboolean ide_runner_run_finish (IdeRunner *self
,GAsyncResult *result
,GError **error
);
void ide_runner_set_cwd (IdeRunner *self
,const gchar *cwd
);
Sets the directory to use when spawning the runner.
Since: 3.28
void ide_runner_push_args (IdeRunner *self
,const gchar * const *args
);
Helper to call ide_runner_append_argv()
for every argument
contained in args
.
Since: 3.28
gchar **
ide_runner_get_argv (IdeRunner *self
);
Gets the argument list as a newly allocated string array.
gint ide_runner_take_fd (IdeRunner *self
,gint source_fd
,gint dest_fd
);
This will ensure that source_fd
is mapped into the new process as dest_fd
.
If dest_fd
is -1, then the next fd will be used and that value will be
returned. Note that this is not a valid fd in the calling process, only
within the destination process.
void ide_runner_set_run_on_host (IdeRunner *self
,gboolean run_on_host
);
IdeBuildTarget *
ide_runner_get_build_target (IdeRunner *self
);
The IdeBuildTarget
associated with this IdeRunner
, or NULL
.
See “build-target” for details.
[nullable][transfer none]
Since: 3.28
void ide_runner_set_build_target (IdeRunner *self
,IdeBuildTarget *build_target
);
Sets the build target associated with this runner.
Since: 3.28
struct IdeRunnerClass { IdeObjectClass parent; void (*force_quit) (IdeRunner *self); GOutputStream *(*get_stdin) (IdeRunner *self); GInputStream *(*get_stdout) (IdeRunner *self); GInputStream *(*get_stderr) (IdeRunner *self); void (*run_async) (IdeRunner *self, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean (*run_finish) (IdeRunner *self, GAsyncResult *result, GError **error); void (*set_tty) (IdeRunner *self, int tty_fd); IdeSubprocessLauncher *(*create_launcher) (IdeRunner *self); void (*fixup_launcher) (IdeRunner *self, IdeSubprocessLauncher *launcher); IdeRuntime *(*get_runtime) (IdeRunner *self); };
“build-target”
property“build-target” IdeBuildTarget *
The IdeBuildTarget
from which this IdeRunner
was constructed.
This is useful to retrieve various properties related to the program that will be launched, such as what programming language it uses, or whether it's a graphical application, a command line tool or a test program.
Flags: Read / Write
Since: 3.28
“clear-env”
property “clear-env” gboolean
If the environment should be cleared before applying overrides.
Flags: Read / Write
Default value: FALSE
“cwd”
property “cwd” gchar *
The directory to use as the working directory for the process.
Flags: Read / Write
Default value: NULL
“environment”
property“environment” IdeEnvironment *
The environment variables for the command.
Flags: Read
“failed”
property “failed” gboolean
If the runner has "failed". This should be set if a plugin can determine that the runner cannot be executed due to an external issue. One such example might be a debugger plugin that cannot locate a suitable debugger to run the program.
Flags: Read / Write
Default value: FALSE