Documentation -> Manuals -> Manual devel -> Binary Internal Interface
Pages for other versions: devel 3.3 3.2 3.1 Older versions: 3.0 2.4 2.3 2.2 2.1 1.11 1.10
The Binary Internal Interface is an OpenSIPS core interface which offers an efficient way for communication between individual OpenSIPS instances. This is especially useful in scenarios where realtime data (such as dialogs) cannot be simply stored in a database anymore, because failover would require entire minutes to complete. This issue can be solved with the new internal binary interface by replicating all the events related to the runtime data (creation / updating / deletion) to a backup OpenSIPS instance.
Configuring the Binary Internal Interface listeners
In order to listen for incoming Binary Packets, a bin: interface must be specified. Its number of listener processes can be tuned with tcp_workers core parameter.
listen = bin:10.0.0.150:5062 ... loadmodule "proto_bin.so"
Examples of cluster-enabled modules which use the binary interface are dialog and usrloc, as they can now replicate all run-time events (creation/updating/deletion of dialogs/contacts) to one or more OpenSIPS instances. Configuration can be done as follows:
modparam("dialog", "dialog_replication_cluster", 1) modparam("dialog", "profile_replication_cluster", 2) ... modparam("usrloc", "location_cluster", 2)
More details can be found in the dialog and usrloc documentation pages.
C Interface Overview (for module developers)
The interface allows the module writer to build and send compact Binary Packets in an intuitive way.
In order to send packets, the interface provides the following primitives: