package octez-internal-libs

  1. Overview
  2. Docs
package octez-internal-libs
Legend:
Library
Module
Module type
Parameter
Class
Class type
include Irmin_pack.Indexable.S with type key := hash Pack_key.t with type hash := hash with type 'a t = 'a t
include Irmin.Indexable.S with type key := hash Pack_key.t with type hash := hash with type 'a t = 'a t

Read-only stores

Read-only stores are store where it is only possible to read existing values.

type 'a t = 'a t

The type for stores. The 'a phantom type carries information about the store mutability.

type value

The type for raw values.

val mem : [> Irmin.Perms.read ] t -> hash Pack_key.t -> bool Lwt.t

mem t k is true iff k is present in t.

val find : [> Irmin.Perms.read ] t -> hash Pack_key.t -> value option Lwt.t

find t k is Some v if k is associated to v in t and None is k is not present in t.

val close : 'a t -> unit Lwt.t

close t frees up all the resources associated with t. Any operations run on a closed handle will raise Closed.

val index : [> Irmin.Perms.read ] t -> hash -> hash Pack_key.t option Lwt.t

Indexing maps the hash of a value to a corresponding key of that value in the store. For stores that are addressed by hashes directly, this is typically fun _t h -> Lwt.return (Key.of_hash h); for stores with more complex addressing schemes, index may attempt a lookup operation in the store.

In general, indexing is best-effort and reveals no information about the membership of the value in the store. In particular:

  • index t hash = Some key doesn't guarantee mem t key: the value with hash hash may still be absent from the store;
  • index t hash = None doesn't guarantee that there is no key such that mem t key and Key.to_hash key = hash: the value may still be present in the store under a key that is not indexed.
val batch : Irmin.Perms.read t -> ([ Irmin.Perms.read | Irmin.Perms.write ] t -> 'a Lwt.t) -> 'a Lwt.t

batch t f applies the writes in f in a separate batch. The exact guarantees depend on the implementation.

module Key : Irmin.Key.S with type t = hash Pack_key.t and type hash = hash
val add : 'a t -> value -> hash Pack_key.t Lwt.t

Overwrite add to work with a read-only database handler.

val unsafe_add : 'a t -> hash -> value -> hash Pack_key.t Lwt.t

Overwrite unsafe_add to work with a read-only database handler.

val index_direct : _ t -> hash -> hash Pack_key.t option
val unsafe_append : ensure_unique:bool -> overcommit:bool -> 'a t -> hash -> value -> hash Pack_key.t
val unsafe_mem : 'a t -> hash Pack_key.t -> bool
val unsafe_find : check_integrity:bool -> 'a t -> hash Pack_key.t -> value option
type file_manager = file_manager
type dict = dict
type dispatcher = dispatcher
val v : config:Irmin.Backend.Conf.t -> fm:file_manager -> dict:dict -> dispatcher:dispatcher -> lru:Lru.t -> Irmin.Perms.read t
val integrity_check : offset:Optint.Int63.t -> length:int -> hash -> _ t -> (unit, [ `Wrong_hash | `Absent_value ]) Stdlib.result
module Entry_prefix : sig ... end
val read_and_decode_entry_prefix : off:Optint.Int63.t -> dispatcher -> Entry_prefix.t

Read the entry prefix at offset off.

val index_direct_with_kind : 'a t -> hash -> (hash Pack_key.t * Irmin_pack.Pack_value.Kind.t) option

Returns the key and the kind of an object indexed by hash.

val purge_lru : 'a t -> unit
val key_of_offset : 'a t -> Optint.Int63.t -> hash Pack_key.t

Returns the key associated with the offset.

val unsafe_find_no_prefetch : 'a t -> hash Pack_key.t -> value option

Similar to unsafe_find, returns the value associated with the key in the store but without prefetching the hash and length of the children (or doing any integrity check). As a result, the produced children keys only contain their offset and are not usable without calling key_of_offset first. This function only exists to optimize the GC reachability traversal.

val get_offset : 'a t -> hash Pack_key.t -> Optint.Int63.t

Returns the offset associated with the key.

val get_length : 'a t -> hash Pack_key.t -> int

Returns the length of the object associated with the key.

OCaml

Innovation. Community. Security.

GitHub Discord Twitter Peertube RSS
About
Changelog Releases Industrial Users Academic Users Why OCaml
Ecosystem
Packages Community Events OCaml Planet Jobs
Resources
Install OCaml Get Started Platform Tools Language Manual Standard Library API Books Exercises Papers OCaml Playground Logo
Policies
Carbon Footprint Governance Privacy Code of Conduct