package picos
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=0f2dcc67ddd127c68f388f2c36a8725a15723e6aeba7d1ddfcf4e016b54a4674
sha512=bee2a99458a451be285e2f13cc3a9deda8eed4e118bcdfc51c256d2da5bae92eec3386c318fe42dcf451421543b519dc064967158b3f417c9b7b44ce97c5fb75
doc/picos.fd/Picos_fd/index.html
Module Picos_fd
Source
Externally reference counted file descriptors.
If !report_leaks = true
then undisposed file descriptors will be reported at exit.
include Picos_rc.S with type Resource.t = Unix.file_descr
Resource type.
Opaque type alias for the resource type.
create resource
adds an entry for the resource with an initial reference count of 1
to the table for the resource and returns the resource as a value of the opaque alias type.
The optional dispose
argument defaults to true
. When explicitly specified as ~dispose:false
, the resource will not be disposed when the reference count becomes zero. This is intended for special cases where a resource is e.g. managed outside of the control of the user program.
unsafe_get opaque_resource
casts the opaque alias type back to the resource type.
⚠️ This should only be called and the resource used either after creating the reference counting entry or after incrementing the reference count and before the matching decrement.
incr opaque_resource
tries to find the entry for the resource and increment the reference count.
decr opaque_resource
tries to find the entry for the resource and decrement the reference count. If the reference count becomes zero, the entry for the resource will be removed and the resource will be disposed, unless ~dispose:false
was specified for create
.
The optional close
argument defaults to false
. When explicitly specified as ~close:true
the resource will be marked as closed and attempts to increment the reference could will fail.
type info = {
resource : Resource.t;
(*The resource.
*)count : int;
(*Reference count. This may be
*)0
.closed : bool;
dispose : bool;
bt : Printexc.raw_backtrace;
}
Information on a resource.