package datakit-server

  1. Overview
  2. Docs

Module Vfs.FileSource

File operations.

Sourcetype fd

The type for open files, e.g. file descriptors.

Sourceval create_fd : read:(offset:int64 -> count:int -> Cstruct.t or_err) -> write:(offset:int64 -> Cstruct.t -> unit or_err) -> fd

Create an open file object.

Sourceval read : fd -> offset:int64 -> count:int -> Cstruct.t or_err

read f ~offset ~count reads an open file.

Sourceval write : fd -> offset:int64 -> Cstruct.t -> unit or_err

write f ~offset writes in a open file.

Sourcetype t

The type for files.

Sourceval pp : t Fmt.t

pp is the pretty-printer for files.

Sourceval create : stat:(unit -> metadata or_err) -> open_:(unit -> fd or_err) -> remove:(unit -> unit or_err) -> truncate:(int64 -> unit or_err) -> chmod:(perm -> unit or_err) -> t

create is the file t such that FIXME.

Sourceval stat : t -> metadata or_err

stat t is t's metadata.

Sourceval size : t -> int64 or_err

size t is t's size.

Sourceval open_ : t -> fd or_err

open_ t if a file-descriptor for t.

Sourceval remove : t -> unit or_err

remove t removes t.

Sourceval truncate : t -> int64 -> unit or_err

truncate t len sets the length of t to len. If the new length is shorter, the file is truncated. If longer, it is padded with zeroes.

Sourceval chmod : t -> perm -> unit or_err

chmod t mode changes the mode of t.

Basic constructors

Sourceval ro_of_string : ?perm:perm -> string -> t

ro_of_string s is the static file containing s.

Sourceval rw_of_string : string -> t * (unit -> string)

rw_of_string init is a mutable file that initially contains init and a function which can be called to get the current contents.

Sourceval status : ?length:(unit -> int Lwt.t) -> (unit -> string Lwt.t) -> t

status f is the file containing the result of f. f is evaluated everytime the file is open. If length is not set, f will also be called during stat queries.

Sourceval command : ?init:string -> (string -> string or_err) -> t

command ?init f is the file containing the result of f. f is evaluated on every write, with the contents of the file as argument. Initially the file contains init.

K/V stores.

Sourceval of_kv : read:(unit -> Cstruct.t option or_err) -> write:(Cstruct.t -> unit or_err) -> stat:(unit -> metadata or_err) -> remove:(unit -> unit or_err) -> chmod:(perm -> unit or_err) -> t

of_kv ~read ~write ~remove ~stat interprets values from a k/v store as files. Handles reading and writing regions of the file.

Sourceval of_kvro : read:(unit -> Cstruct.t option or_err) -> stat:(unit -> metadata or_err) -> t

of_kvro is similar to of_kv but for read-only values.

Sourceval stat_of : read:(unit -> Cstruct.t option or_err) -> unit -> metadata or_err

stat_of ~read makes a stat function from read. The function reads the file to get the length, and reports the type as `Normal.

Streams

Sourcemodule Stream : sig ... end
Sourceval of_stream : (unit -> Stream.t Lwt.t) -> t

of_stream s is the file which will be, once opened, similar to the stream s ().

Errors

Sourceval err_no_entry : 'a or_err
Sourceval err_read_only : 'a or_err