Ubuntu Manpage: ioth_newstack, ioth_newstackl, ioth_newstackv, ioth_delstack, ioth_msocket, ioth_set

Provided by: libioth-dev_0.1.2-3build2_amd64

NAME

       ioth_newstack,    ioth_newstackl,   ioth_newstackv,   ioth_delstack,   ioth_msocket,   ioth_set_defstack,
       ioth_get_defstack,  ioth_socket,   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,   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 - Internet of Threads (IoTh) library

SYNOPSIS

       #include <ioth.h>

       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);

       int ioth_msocket(struct ioth *iothstack, int domain, int type, int protocol);

       void ioth_set_defstack(struct ioth *iothstack);

       struct ioth *ioth_get_defstack(void);

       int ioth_socket(int domain, int type, int protocol);

       • Berkeley Sockets API

       int ioth_close(int fd);

       int ioth_bind(int sockfd, const struct sockaddr *addr, socklen_t addrlen);

       int ioth_connect(int sockfd, const struct sockaddr *addr, socklen_t addrlen);

       int ioth_listen(int sockfd, int backlog);

       int ioth_accept(int sockfd, struct sockaddr *restrict addr, socklen_t *restrict addrlen);

       int ioth_getsockname(int sockfd, struct sockaddr *restrict addr, socklen_t *restrict addrlen);

       int ioth_getpeername(int sockfd, struct sockaddr *restrict addr, socklen_t *restrict addrlen);

       int  ioth_getsockopt(int  sockfd,  int  level,  int  optname,  void *restrict optval, socklen_t *restrict
       optlen);

       int ioth_setsockopt(int sockfd, int level, int optname, const void *optval, socklen_t optlen);

       int ioth_shutdown(int sockfd, int how);

       int ioth_ioctl(int fd, unsigned long request, ...);

       int ioth_fcntl(int fd, int cmd, ... /* arg */ );

       ssize_t ioth_read(int fd, void *buf, size_t count);

       ssize_t ioth_readv(int fd, const struct iovec *iov, int iovcnt);

       ssize_t ioth_recv(int sockfd, void *buf, size_t len, int flags);

       ssize_t ioth_recvfrom(int sockfd, void *restrict buf, size_t len, int flags,  struct  sockaddr  *restrict
       src_addr, socklen_t *restrict addrlen);

       ssize_t ioth_recvmsg(int sockfd, struct msghdr *msg, int flags);

       ssize_t ioth_write(int fd, const void *buf, size_t count);

       ssize_t ioth_writev(int fd, const struct iovec *iov, int iovcnt);

       ssize_t ioth_send(int sockfd, const void *buf, size_t len, int flags);

       ssize_t ioth_sendto(int sockfd, const void *buf, size_t len, int flags, const struct sockaddr *dest_addr,
       socklen_t addrlen);

       ssize_t ioth_sendmsg(int sockfd, const struct msghdr *msg, int flags);

       • nlinline+ API

       int ioth_if_nametoindex(const char *ifname);

       int ioth_linksetupdown(unsigned int ifindex, int updown);

       int ioth_ipaddr_add(int family, void *addr, int prefixlen, unsigned int ifindex);

       int ioth_ipaddr_del(int family, void *addr, int prefixlen, unsigned int ifindex);

       int ioth_iproute_add(int family, void *dst_addr, int dst_prefixlen, void *gw_addr, unsigned int ifindex);

       int ioth_iproute_del(int family, void *dst_addr, int dst_prefixlen, void *gw_addr, unsigned int ifindex);

       int ioth_iplink_add(const char *ifname, unsigned int ifindex, const char *type, const char *data);

       int ioth_iplink_del(const char *ifname, unsigned int ifindex`);

       int ioth_linksetaddr(unsigned int ifindex, void *macaddr`);

       int ioth_linkgetaddr(unsigned int ifindex, void *macaddr`);

DESCRIPTION

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_newstack creates a new stack without any interface if vnl is 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_newstackl, ioth_newstackv
ioth_newstacklandioth_newstackv` (l = list, v = vector) support the creation of a new stack with
several interfaces. It is possible to provide the VNLs as a sequence of arguments (as in
execl(3)) or as a NULL terminated array of VNLs (as the arguments in execv(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_socket opens 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)

AUTHOR

       VirtualSquare.  Project leader: Renzo Davoli

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUE

SEE ALSO

AUTHOR