GVirSandboxContext

GVirSandboxContext — Application sandbox context

Functions

Properties

GVirSandboxConfig * config Read / Write / Construct Only
GVirConnection * connection Read / Write / Construct Only
GVirDomain * domain Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GVirSandboxContext
        ├── GVirSandboxContextInteractive
        ╰── GVirSandboxContextService

Includes

#include <libvirt-sandbox/libvirt-sandbox.h>

Description

Provides a base class for implementing console based application sandboxes

The GVirSandboxContext object takes a GVirSandboxConfig instance, passing it to GVirSandboxBuilder instance to create a virtual machine, and then provides access to a GVirSandboxConsole instance for interacting with the sandboxed application's stdio.

Functions

gvir_sandbox_context_get_config ()

GVirSandboxConfig *
gvir_sandbox_context_get_config (GVirSandboxContext *ctxt);

Retrieves the sandbox configuration

Parameters

ctxt

the sandbox context.

[transfer none]

Returns

the current configuration.

[transfer full]


gvir_sandbox_context_start ()

gboolean
gvir_sandbox_context_start (GVirSandboxContext *ctxt,
                            GError **error);

gvir_sandbox_context_stop ()

gboolean
gvir_sandbox_context_stop (GVirSandboxContext *ctxt,
                           GError **error);

gvir_sandbox_context_attach ()

gboolean
gvir_sandbox_context_attach (GVirSandboxContext *ctxt,
                             GError **error);

gvir_sandbox_context_detach ()

gboolean
gvir_sandbox_context_detach (GVirSandboxContext *ctxt,
                             GError **error);

gvir_sandbox_context_is_attached ()

gboolean
gvir_sandbox_context_is_attached (GVirSandboxContext *ctxt);

gvir_sandbox_context_get_domain ()

GVirDomain *
gvir_sandbox_context_get_domain (GVirSandboxContext *ctxt,
                                 GError **error);

Retrieves the sandbox domain (if running)

Parameters

ctxt

the sandbox context.

[transfer none]

Returns

the current domain or NULL.

[transfer full]


gvir_sandbox_context_get_connection ()

GVirConnection *
gvir_sandbox_context_get_connection (GVirSandboxContext *ctxt);

Retrieves the sandbox connection

Parameters

ctxt

the sandbox context.

[transfer none]

Returns

the current connection or NULL.

[transfer full]


gvir_sandbox_context_get_log_console ()

GVirSandboxConsole *
gvir_sandbox_context_get_log_console (GVirSandboxContext *ctxt,
                                      GError **error);

Parameters

ctxt

the sandbox context.

[transfer none]

Returns

the sandbox console (or NULL).

[transfer full][allow-none]


gvir_sandbox_context_get_shell_console ()

GVirSandboxConsole *
gvir_sandbox_context_get_shell_console
                               (GVirSandboxContext *ctxt,
                                GError **error);

Parameters

ctxt

the sandbox context.

[transfer none]

Returns

the sandbox console (or NULL).

[transfer full][allow-none]

Types and Values

GVIR_SANDBOX_TYPE_CONTEXT_HANDLE

#define GVIR_SANDBOX_TYPE_CONTEXT_HANDLE      (gvir_sandbox_context_handle_get_type ())

struct GVirSandboxContext

struct GVirSandboxContext;

struct GVirSandboxContextClass

struct GVirSandboxContextClass {
    GObjectClass parent_class;

    /* Class method overrides */
    gboolean (*start)(GVirSandboxContext *ctxt, GError **error);
    gboolean (*stop)(GVirSandboxContext *ctxt, GError **error);
    gboolean (*attach)(GVirSandboxContext *ctxt, GError **error);
    gboolean (*detach)(GVirSandboxContext *ctxt, GError **error);

    gpointer padding[LIBVIRT_SANDBOX_CLASS_PADDING];
};

GVirSandboxContextPrivate

typedef struct _GVirSandboxContextPrivate GVirSandboxContextPrivate;

Property Details

The “config” property

  “config”                   GVirSandboxConfig *

The sandbox configuration.

Flags: Read / Write / Construct Only


The “connection” property

  “connection”               GVirConnection *

The sandbox connection.

Flags: Read / Write / Construct Only


The “domain” property

  “domain”                   GVirDomain *

The sandbox domain.

Flags: Read / Write