package obuilder

  1. Overview
  2. Docs

Module Obuilder.Native_sandboxSource

Sandbox builds.

include S.SANDBOX
Sourcetype t
Sourceval run : cancelled:unit Lwt.t -> ?stdin:Os.unix_fd -> log:Build_log.t -> t -> Config.t -> string -> (unit, [ `Cancelled | `Msg of string ]) Lwt_result.t

run ~cancelled t config dir runs the operation config in a sandbox with root filesystem dir.

  • parameter cancelled

    Resolving this kills the process (and returns `Cancelled).

  • parameter stdin

    Passed to child as its standard input.

  • parameter log

    Used for child's stdout and stderr.

Sourceval shell : t -> string list

shell t Command line for the default shell.

Sourceval tar : t -> string list

tar t Command line to invoke tar for this sandbox.

Sourcetype config

The type of sandbox configurations

Sourceval sexp_of_config : config -> Sexplib0.Sexp.t
Sourceval config_of_sexp : Sexplib0.Sexp.t -> config

cmdliner is used for command-line interfaces to generate the necessary flags and parameters to setup a specific sandbox's configuration.

Sourceval create : state_dir:string -> config -> t Lwt.t

create ~state_dir config is a sandboxing system that keeps state in state_dir and is configured using config.

Sourceval finished : unit -> unit Lwt.t

finished is a call back to the sandbox which is triggered when the current job is finished. The sandbox may choose do nothing.