blob: e74ebc654aa3642cb34949bb0735c3f88c4bd4c0 [file] [log] [blame]
sp_ipc(7)
=========
NAME
----
sp_ipc - inter-process transport mechanism
SYNOPSIS
--------
*#include <sp/sp.h>*
*#include <sp/ipc.h>*
DESCRIPTION
-----------
Inter-process transport allows for sending messages between processes within
a single box. The implementation uses native IPC mechanism provided by the local
operating system and the IPC addresses are thus OS-specific.
On POSIX-compliant systems, UNIX domain sockets are used and IPC addresses are
file references. Note that both relative (ipc://test.ipc) and absolute
(ipc:///tmp/test.ipc) paths may be used. Also note that access rights on the IPC
files must be set in such a way that the appropriate applications can actually
use them.
On Windows, named pipes are used for IPC. IPC address is an arbitrary
case-insensitive string containing any character except for backslash.
Internally, address ipc://test means that named pipe \\.\pipe\test will be used.
EXAMPLE
-------
----
sp_bind (s1, "ipc:///tmp/test.ipc");
sp_connect (s2, "ipc:///tmp/test.ipc");
----
SEE ALSO
--------
linknanomsg:sp_inproc[7]
linknanomsg:sp_tcp[7]
linknanomsg:sp_bind[3]
linknanomsg:sp_connect[3]
linknanomsg:nanomsg[7]
AUTHORS
-------
Martin Sustrik <sustrik@250bpm.com>