package irmin-pack
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=cd788a8d3f4a3dd18dc160a153d4aec91eaf6b0fb41ad41464d26c79c304a98e
sha512=4f97862678d35e0b4aa814a1df51d6f8c59bcf5b611c73f0a475f9b5386ca42a4a18e65ce80fc425ddad93fcdacfcb563c52f6423777610a0bc567902f4db088
doc/irmin-pack.unix/Irmin_pack_unix/Pack_store/Make/argument-1-Fm/Control/index.html
Module Fm.Control
Abstraction for irmin-pack's control file.
It is parameterized with Io, a file system abstraction (e.g. unix, mirage, eio_linux).
None of the functions raise exceptions.
module Io = Ioval create_rw :
path:string ->
overwrite:bool ->
Irmin_pack_unix__.Control_file_intf.Payload_v4.t ->
(t, [> Io.create_error | Io.write_error ]) resultCreate a rw instance of t by creating a control file.
type open_error := [ | `Corrupted_control_file| `Io_misc of Io.misc_error| `No_such_file_or_directory| `Not_a_file| `Closed| `Unknown_major_pack_version of string
]val open_ : path:string -> readonly:bool -> (t, [> open_error ]) resultCreate a rw instance of t by reading an existing file at path.
val close : t -> (unit, [> Io.close_error ]) resultval payload : t -> Irmin_pack_unix__.Control_file_intf.Payload_v4.tpayload t is the payload in t.
That function doesn't perform IO.
RW mode
payload t is the payload, as it was written to the file system.
RO mode
payload t is the payload, as it was seen during open_ or during the most recent reload.
type reload_error := [ | `Corrupted_control_file| `Io_misc of Io.misc_error| `Closed| `Rw_not_allowed| `Unknown_major_pack_version of string
]val reload : t -> (unit, [> reload_error ]) resultRW mode
Always returns an error.
RO mode
Reread the file on disk.
If the file changed since the last read, the payload in t is updated to match the content of the file.
val set_payload :
t ->
Irmin_pack_unix__.Control_file_intf.Payload_v4.t ->
(unit, [> Io.write_error ]) resultRW mode
Write a new payload on disk.
RO mode
Always returns an error.
val readonly : t -> boolval fsync : t -> (unit, [> Io.write_error ]) resultRW mode
Tell the OS to fush its internal buffers.
RO mode
Always returns Error `Ro_not_allowed.