description

D-Bus is a projects that permis program to communicate with each other, using a simple IPC protocol

Wikipedia article

download

documentation

 
type bus
type message
type pending_call
type ty =
	| Byte of char
	| Bool of bool
	| Int16 of int
	| UInt16 of int
	| Int32 of int32
	| UInt32 of int32
	| Int64 of int64
	| UInt64 of int64
	| Double of float
	| String of string

module Bus :
sig
	type ty = Session | System | Starter
	type flags = Replace_existing

	val get : ty -> bus
	val get_private : ty -> bus
	val register : bus -> bool
	val set_unique_name : bus -> string -> bool
	val get_unique_name : bus -> string
	val request_name : bus -> string -> int -> unit
	val release_name : bus -> string -> unit
	val has_owner : bus -> string -> bool
	val add_match : bus -> string -> unit
	val remove_match : bus -> string -> unit
end

module Message :
sig
	type message_type =
		| Invalid
		| Method_call
		| Method_return
		| Error
		| Signal
	val create : message_type -> message
	val new_method_call : string -> string -> string -> string -> message
	val new_method_return : message -> message
	val new_signal : string -> string -> string -> message
	val new_error : message -> string -> string -> message
	val append : message -> ty list -> unit
	val get_rev : message -> ty list
	val get : message -> ty list
	val set_path : message -> string -> unit
	val set_interface : message -> string -> unit
	val set_member : message -> string -> unit
	val set_error_name : message -> string -> unit
	val set_destination : message -> string -> unit
	val set_sender : message -> string -> unit
	val set_reply_serial : message -> int32 -> unit
	val set_auto_start : message -> bool -> unit
	val has_path : message -> string -> bool
	val has_interface : message -> string -> bool
	val has_member : message -> string -> bool
	val has_destination : message -> string -> bool
	val has_sender : message -> string -> bool
	val has_signature : message -> string -> bool
	val get_type : message -> message_type
	val get_path : message -> string option
	val get_interface : message -> string option
	val get_member : message -> string option
	val get_error_name : message -> string option
	val get_destination : message -> string option
	val get_sender : message -> string option
	val get_signature : message -> string option
	val get_serial : message -> int32
	val get_reply_serial : message -> int32
	val get_auto_start : message -> bool
	val is_signal : message -> string -> string -> bool
	val is_method_call : message -> string -> string -> bool
	val is_error : message -> string -> bool
end

module Connection :
sig
	val send : bus -> message -> int32
	val send_with_reply : bus -> message -> int -> pending_call
	val send_with_reply_and_block : bus -> message -> int -> message
	val add_filter : bus -> (bus -> message -> bool) -> unit
	val flush : bus -> unit
	val read_write : bus -> int -> bool
	val read_write_dispatch : bus -> int -> bool
	val pop_message : bus -> message option
	val get_fd : bus -> Unix.file_descr
end

module PendingCall :
sig
	val block : pending_call -> unit
	val cancel : pending_call -> unit
	val get_completed : pending_call -> bool
	val steal_reply : pending_call -> message
end

Changelog
  • 0.09: basic support for struct. add basic module for watch. not-for-production use yet.
  • 0.08: support of arrays, significantly change the API to be less close to the C version and more close to normal ocaml library. add small networkmanager client example.
  • 0.07: couple of license mismatch fix and build fixes thanks to Sylvain Le Gall.
  • 0.06: really remove a failwith, where it should not fail anymore.
  • 0.05: few issues fixes, mostly related to dbus closing connection. credit to Richard.
  • 0.04: a bunch of different fixes, thanks to Richard W.M. Jones.
  • 0.03: 2 small makefile fixes to build on ALT linux, thanks to Alex Myltsev.
  • 0.02: Extends Bus and Pending calls stuff. add a package.
  • 0.01: initial implementation.