Xdp.Portal.spawn

### Method

# Xdp Portalspawn

#### Declaration [src]

    void
    xdp_portal_spawn (
      XdpPortal* portal,
      const char* cwd,
      const char* const* argv,
      int* fds,
      int* map_to,
      int n_fds,
      const char* const* env,
      XdpSpawnFlags flags,
      const char* const* sandbox_expose,
      const char* const* sandbox_expose_ro,
      GCancellable* cancellable,
      GAsyncReadyCallback callback,
      gpointer data
    )

#### Description [src]

Creates a new copy of the applications sandbox, and runs a process in, with the given arguments.

The learn when the spawned process exits, connect to the `XdpPortal::spawn-exited` signal.

This method completes asynchronously. Use `xdp_portal_spawn_finish()` inside the `GAsyncReadyCallback` to obtain the result of the operation.

#### Parameters

`cwd`

  Type: `const char*`

  The cwd for the new process.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`argv`

  Type: An array of `char*`

  The argv for the new process.

  The array must be `NULL`-terminated.
  The data is owned by the caller of the method.
  Each element is a NUL terminated UTF-8 string.

`fds`

  Type: An array of `int`

  An array of open fds to pass to the new process, or `NULL`.

  The argument can be `NULL`.
  The length of the array is specified in the `n_fds` argument.
  The data is owned by the caller of the method.

`map_to`

  Type: An array of `int`

  An array of integers to map the `fds` to, or `NULL`. Must be the same length as `fds`.

  The argument can be `NULL`.
  The length of the array is specified in the `n_fds` argument.
  The data is owned by the caller of the method.

`n_fds`

  Type: `int`

  The length of `fds` and `map_to` arrays.

`env`

  Type: An array of `char*`

  An array of KEY=VALUE environment settings, or `NULL`.

  The argument can be `NULL`.
  The array must be `NULL`-terminated.
  The data is owned by the caller of the method.
  Each element is a NUL terminated UTF-8 string.

`flags`

  Type: `XdpSpawnFlags`

  Flags influencing the spawn operation.

`sandbox_expose`

  Type: An array of `char*`

  Paths to expose rw in the new sandbox, or `NULL`.

  The argument can be `NULL`.
  The array must be `NULL`-terminated.
  The data is owned by the caller of the method.
  Each element is a NUL terminated UTF-8 string.

`sandbox_expose_ro`

  Type: An array of `char*`

  Paths to expose ro in the new sandbox, or `NULL`.

  The argument can be `NULL`.
  The array must be `NULL`-terminated.
  The data is owned by the caller of the method.
  Each element is a NUL terminated UTF-8 string.

`cancellable`

  Type: `GCancellable`

  Optional `GCancellable`.

  The argument can be `NULL`.
  The data is owned by the caller of the method.

`callback`

  Type: `GAsyncReadyCallback`

  A callback to call when the request is done.

  The argument can be `NULL`.

`data`

  Type: `gpointer`

  Data to pass to `callback`.

  The argument can be `NULL`.
  The data is owned by the caller of the method.