Top | ![]() |
![]() |
![]() |
![]() |
GStrv | argv | Read / Write |
IdeBuildTarget * | build-target | Read / Write |
gboolean | clear-env | Read / Write |
char * | cwd | Read / Write |
gboolean | disable-pty | 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).
Since: 3.32
IdeEnvironment *
ide_runner_get_environment (IdeRunner *self
);
Since: 3.32
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.32
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.32
gchar **
ide_runner_get_argv (IdeRunner *self
);
Gets the argument list as a newly allocated string array.
Since: 3.32
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.
Since: 3.32
void ide_runner_set_run_on_host (IdeRunner *self
,gboolean run_on_host
);
void ide_runner_set_pty (IdeRunner *self
,VtePty *pty
);
Sets the VtePty to use for the runner.
This is equivalent to calling ide_runner_set_tty()
with the
result of vte_pty_get_fd()
.
Since: 3.32
VtePty *
ide_runner_get_pty (IdeRunner *self
);
Gets the VtePty that was assigned.
Since: 3.34
void ide_runner_set_disable_pty (IdeRunner *self
,gboolean disable_pty
);
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.32
void ide_runner_set_build_target (IdeRunner *self
,IdeBuildTarget *build_target
);
Sets the build target associated with this runner.
Since: 3.32
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); IdeSubprocessLauncher *(*create_launcher) (IdeRunner *self); void (*fixup_launcher) (IdeRunner *self, IdeSubprocessLauncher *launcher); IdeRuntime *(*get_runtime) (IdeRunner *self); };
“argv”
property“argv” GStrv
The argument list for the command.
Owner: IdeRunner
Flags: Read / Write
“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.
Owner: IdeRunner
Flags: Read / Write
Since: 3.32
“clear-env”
property“clear-env” gboolean
If the environment should be cleared before applying overrides.
Owner: IdeRunner
Flags: Read / Write
Default value: FALSE
“cwd”
property “cwd” char *
The directory to use as the working directory for the process.
Owner: IdeRunner
Flags: Read / Write
Default value: NULL
“disable-pty”
property“disable-pty” gboolean
If the pty should be disabled from use.
Owner: IdeRunner
Flags: Read / Write
Default value: FALSE
“environment”
property“environment” IdeEnvironment *
The environment variables for the command.
Owner: IdeRunner
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.
Owner: IdeRunner
Flags: Read / Write
Default value: FALSE
Since: 3.32
“run-on-host”
property“run-on-host” gboolean
The "run-on-host" property indicates the program should be run on the host machine rather than inside the application sandbox.
Owner: IdeRunner
Flags: Read / Write
Default value: FALSE
Since: 3.32