GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
IPC_LISTEN(3) libdill Library Functions IPC_LISTEN(3)

ipc_listen - starts listening for incoming IPC connections


#include <libdill.h>
int ipc_listen(
    const char* addr,
    int backlog);

    

IPC protocol is a bytestream protocol for transporting data among processes on the same machine. It is an equivalent to POSIX AF_LOCAL sockets.

This function starts listening for incoming IPC connections. The connections can be accepted using ipc_accept function.

addr: The filename to listen on.

backlog: Maximum number of connections that can be kept open without accepting them.

The socket can be closed either by hclose or ipc_close. Both ways are equivalent.

This function is not available if libdill is compiled with --disable-sockets option.

In case of success the function returns newly created socket. In case of error it returns -1 and sets errno to one of the values below.

EACCES: The process does not have appropriate privileges.
EADDRINUSE: The specified address is already in use.
EINVAL: Invalid argument.
ELOOP: A loop exists in symbolic links encountered during resolution of the pathname in address.
EMFILE: The maximum number of file descriptors in the process are already open.
ENAMETOOLONG: A component of a pathname exceeded NAME_MAX characters, or an entire pathname exceeded PATH_MAX characters.
ENFILE: The maximum number of file descriptors in the system are already open.
ENOENT: A component of the pathname does not name an existing file or the pathname is an empty string.
ENOMEM: Not enough memory.
ENOTDIR: A component of the path prefix of the pathname in address is not a directory.


int ls = ipc_listen("/tmp/test.ipc", 10);
int s = ipc_accept(ls, -1);
bsend(s, "ABC", 3, -1);
char buf[3];
brecv(s, buf, sizeof(buf), -1);
ipc_close(s);
ipc_close(ls);

    

brecv(3) brecvl(3) bsend(3) bsendl(3) hclose(3) ipc_accept(3) ipc_accept_mem(3) ipc_close(3) ipc_connect(3) ipc_connect_mem(3) ipc_done(3) ipc_fromfd(3) ipc_fromfd_mem(3) ipc_listen_mem(3) ipc_listener_fromfd(3) ipc_listener_fromfd_mem(3) ipc_pair(3) ipc_pair_mem(3)
libdill

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.