Up  Next

Module Libvirt.Connect

module Connect: sig .. end

Module dealing with connections. Connect.t is the connection object.

type 'rw t

Connection. Read-only connections have type ro Connect.t and read-write connections have type rw Connect.t.

type node_info = {
   model : string; (*

CPU model

*)
   memory : int64; (*

memory size in kilobytes

*)
   cpus : int; (*

number of active CPUs

*)
   mhz : int; (*

expected CPU frequency

*)
   nodes : int; (*

number of NUMA nodes (1 = UMA)

*)
   sockets : int; (*

number of CPU sockets per node

*)
   cores : int; (*

number of cores per socket

*)
   threads : int; (*

number of threads per core

*)
} 
val connect : ?name:string -> unit -> Libvirt.rw t
val connect_readonly : ?name:string -> unit -> Libvirt.ro t

connect ~name () connects to the hypervisor with URI name.

connect () connects to the default hypervisor.

connect_readonly is the same but connects in read-only mode.

val close : [> `R ] t -> unit

close conn closes and frees the connection object in memory.

The connection is automatically closed if it is garbage collected. This function just forces it to be closed and freed right away.

val get_type : [> `R ] t -> string

Returns the name of the driver (hypervisor).

val get_version : [> `R ] t -> int

Returns the driver version major * 1_000_000 + minor * 1000 + release

val get_hostname : [> `R ] t -> string

Returns the hostname of the physical server.

val get_uri : [> `R ] t -> string

Returns the canonical connection URI.

val get_max_vcpus : [> `R ] t -> ?type_:string -> unit -> int

Returns the maximum number of virtual CPUs supported by a guest VM of a particular type.

val list_domains : [> `R ] t -> int -> int array

list_domains conn max returns the running domain IDs, up to a maximum of max entries.

Call Libvirt.Connect.num_of_domains first to get a value for max.

See also: Libvirt.Domain.get_domains, Libvirt.Domain.get_domains_and_infos.

val num_of_domains : [> `R ] t -> int

Returns the number of running domains.

val get_capabilities : [> `R ] t -> Libvirt.xml

Returns the hypervisor capabilities (as XML).

val num_of_defined_domains : [> `R ] t -> int

Returns the number of inactive (shutdown) domains.

val list_defined_domains : [> `R ] t -> int -> string array

list_defined_domains conn max returns the names of the inactive domains, up to a maximum of max entries.

Call Libvirt.Connect.num_of_defined_domains first to get a value for max.

See also: Libvirt.Domain.get_domains, Libvirt.Domain.get_domains_and_infos.

val num_of_networks : [> `R ] t -> int

Returns the number of networks.

val list_networks : [> `R ] t -> int -> string array

list_networks conn max returns the names of the networks, up to a maximum of max entries. Call Libvirt.Connect.num_of_networks first to get a value for max.

val num_of_defined_networks : [> `R ] t -> int

Returns the number of inactive networks.

val list_defined_networks : [> `R ] t -> int -> string array

list_defined_networks conn max returns the names of the inactive networks, up to a maximum of max entries. Call Libvirt.Connect.num_of_defined_networks first to get a value for max.

val num_of_pools : [> `R ] t -> int

Returns the number of storage pools.

val list_pools : [> `R ] t -> int -> string array

Return list of storage pools.

val num_of_defined_pools : [> `R ] t -> int

Returns the number of storage pools.

val list_defined_pools : [> `R ] t -> int -> string array

Return list of storage pools.

val get_node_info : [> `R ] t -> node_info

Return information about the physical server.

val node_get_free_memory : [> `R ] t -> int64

node_get_free_memory conn returns the amount of free memory (not allocated to any guest) in the machine.

val node_get_cells_free_memory : [> `R ] t -> int -> int -> int64 array

node_get_cells_free_memory conn start max returns the amount of free memory on each NUMA cell in kilobytes. start is the first cell for which we return free memory. max is the maximum number of cells for which we return free memory. Returns an array of up to max entries in length.

val maxcpus_of_node_info : node_info -> int

Calculate the total number of CPUs supported (but not necessarily active) in the host.

val cpumaplen : int -> int

Calculate the length (in bytes) required to store the complete CPU map between a single virtual and all physical CPUs of a domain.

val use_cpu : bytes -> int -> unit

use_cpu cpumap cpu marks cpu as usable in cpumap.

val unuse_cpu : bytes -> int -> unit

unuse_cpu cpumap cpu marks cpu as not usable in cpumap.

val cpu_usable : bytes -> int -> int -> int -> bool

cpu_usable cpumaps maplen vcpu cpu checks returns true iff the cpu is usable by vcpu.

val set_keep_alive : [> `R ] t -> int -> int -> unit

set_keep_alive conn interval count starts sending keepalive messages after interval seconds of inactivity and consider the connection to be broken when no response is received after count keepalive messages. Note: the client has to implement and run an event loop to be able to use keep-alive messages.

val const : [> `R ] t -> Libvirt.ro t

const conn turns a read/write connection into a read-only connection. Note that the opposite operation is impossible.