ioth_readv3
Internet of threads (ioth) library
Part of ioth(3).
Usage
struct ioth
*ioth_newstack(const
char
*stack,
const
char
*vnl);
struct ioth
*ioth_newstackl(const
char
*stack,
const
char
*vnl, ...
);
struct ioth
*ioth_newstackv(const
char
*stack,
const
char
*vnlv
[]
);
int ioth_delstack(struct
ioth
*iothstack);
void ioth_set_defstack(struct
ioth
*iothstack);
struct ioth
*ioth_get_defstack(void);
int ioth_close(int
fd);
int ioth_if_nametoindex(const
char
*ifname);
int ioth_iplink_del(const
char
*ifname,
unsigned
int
ifindex`);
Overview
libioth is the API for the Internet of Threads. TCP-IP networking stacks can be loaded as dynamic libraries at run time.
- •
-
the API is minimal: Berkeley Sockets + msocket + newstack/delstack.
- •
-
the stack implementation can be chosen as a plugin at run time.
- •
-
netlink based stack/interface/ip configuration via nlinline.
- •
-
ioth sockets are real file descriptors, poll/select/ppoll/pselect/epoll friendly
- •
-
plug-ins can be loaded in private address namespaces: libioth supports several stacks of the same type (same plugin) even if the stack implementation library was designed to provide just one stack.
libioth provides the following functions:
ioth_newstack-
ioth_newstackcreates a new stack without any interface ifvnlis NULL, otherwise the new stack has a virtual interface connected to the vde network identified by the VNL (Virtual Network Locator, see vde_open(3) ).
ioth_delstack-
This function terminates/deletes a stack.
ioth_msocket-
This is the multi-stack supporting extension of socket(2). It behaves exactly as socket except for the added heading argument that allows the choice of the stack among those currently available (previously created by a
ioth_newstack*).
ioth_set_defstack,ioth_get_defstack-
These functions define and retrieve the default stack, respectively. The default stack is implicitly used by ioth_msocket when its first argument iothstack is NULL. The default stack is initially defined as the native stack provided by the kernel. Use ioth_set_defstack(mystack) to define mystack as the current default stack. ioth_set_defstack(NULL) to revert the default stack to the native stack.
ioth_socket-
ioth_socketopens a socket using the default stack: ioth_socket(d, t, p) is an alias for ioth_msocket(NULL, d, t, p)
ioth_close,ioth_bind,ioth_connect,ioth_listen,ioth_accept,ioth_getsockname,ioth_getpeername,ioth_setsockopt,ioth_getsockopt,ioth_shutdown,ioth_ioctl,ioth_fcntl,ioth_read,ioth_readv,ioth_recv,ioth_recvfrom,ioth_recvmsg,ioth_write,ioth_writev,ioth_send,ioth_sendto,ioth_sendmsg-
these functions have the same signature and functionalities of their counterpart in (2) and (3) without the
ioth_prefix.
ioth_if_nametoindex,ioth_linksetupdown,ioth_ipaddr_add,ioth_ipaddr_del,ioth_iproute_add,ioth_iproute_del,ioth_iplink_add,ioth_iplink_del,ioth_linksetaddr,ioth_linkgetaddr-
these functions have the same signature and functionnalities described in nlinline(3).
Return value
ioth_newstack, ioth_newstackl, ioth_newstackv return a struct stack pointer, NULL in case of error. This address is used as a descriptor of the newly created stack and is later passed as parameter to ioth_msocket, ioth_set_defstack or ioth_delstack.
ioth_msocket and ioth_socket return the file descriptor of the new socket, -1 in case of errore.
ioth_delstack returns -1 in case of error, 0 otherwise. If there are file descriptors already in use, this function fails and errno is EBUSY.
ioth_get_defstack returns the stack descriptor of the default stack.
The return values of all the other functions are defined in the man pages of the corresponding functions provided by the GNU C library or nlinline(3)