Tizen Sockets Extension API References

This topic lists methods provided by the Tizen Sockets Extension for WebAssembly.

---

Related Info

• The Open Group Base Specifications Issue 7
• The Linux Documentation Project
• Die.net
• man7.org

---

When possible, the semantics of these functions conform to the POSIX.1-2017 standard. The most notable differences are:

• lack of signals support in Emscripten and in a web environment.
• Tizen Sockets Extension APIs cannot be called from the main thread, which is usually the one running the main function unless -s PROXY_TO_PTHREAD or --proxy-to-worker flags are provided to Emscripten during link time. See Additional flags in the Emscripten documentation.
• Socket functions that accept multiple descriptors can accept only one descriptor type at a time. Descriptor types cannot be mixed (meaning that a method can be called with either socket descriptors or file descriptors, but not both). In particular, this applies to poll() and select() methods.
• select() method can be slow due to its internal implementation in Emscripten. It is recommended to use poll() method instead.

The following extensions to sockets are provided:

• SOCK_NONBLOCK and SOCK_CLOEXEC flags when creating socket()
• accept4() method
• IPv4 multicast options in getsockopt() and setsockopt() methods.
• gethostbyaddr() method
• gethostbyname() method

Method	Argument Value	Reference
accept()	-	The Open Group Base Specifications Issue 7, 2018 edition - accept
accept4()	Values in flags: SOCK_NONBLOCK SOCK_CLOEXEC	Die.net - accept4
bind()	-	Die.net - accept4 The Open Group Base Specifications Issue 7, 2018 edition - bind
close()	-	The Open Group Base Specifications Issue 7, 2018 edition - close
connect()	-	The Open Group Base Specifications Issue 7, 2018 edition - connect
freeaddrinfo()	-	The Open Group Base Specifications Issue 7, 2018 edition - freeaddrinfo
getaddrinfo()	-	The Open Group Base Specifications Issue 7, 2018 edition - getaddrinfo
gethostbyaddr()	-	Die.net - gethostbyaddr
gethostbyname()	-	Die.net - gethostbyname
getpeername()	-	The Open Group Base Specifications Issue 7, 2018 edition - getpeername
getsockname()	-	The Open Group Base Specifications Issue 7, 2018 edition - getsockname
getsockopt()	Combinations of level and optname: SOL_SOCKET, SO_DEBUG SOL_SOCKET, SO_ERROR SOL_SOCKET, SO_BROADCAST SOL_SOCKET, SO_REUSEADDR SOL_SOCKET, SO_KEEPALIVE SOL_SOCKET, SO_OOBINLINE SOL_SOCKET, SO_SNDBUF SOL_SOCKET, SO_RCVBUF SOL_SOCKET, SO_DONTROUTE SOL_SOCKET, SO_RCVLOWAT SOL_SOCKET, SO_SNDLOWAT SOL_SOCKET, SO_RCVTIMEO SOL_SOCKET, SO_SNDTIMEO SOL_SOCKET, SO_LINGER IPPROTO_TCP, TCP_NODELAY IPPROTO_IP, IP_MULTICAST_LOOP IPPROTO_IP, IP_MULTICAST_TTL IPPROTO_IPV6, IPV6_MULTICAST_HOPS IPPROTO_IPV6, IPV6_MULTICAST_LOOP	The Open Group Base Specifications Issue 7, 2018 edition - getsockopt The Linux Documentation Project - Multicast programming man7.org - ip
listen()	-	The Open Group Base Specifications Issue 7, 2018 edition - listen
poll()	Supported event flags: POLLIN POLLRDNORM POLLRDBAND POLLPRI POLLOUT POLLWRNORM POLLWRBAND POLLERR POLLHUP POLLNVAL Usage notes: The Tizen Sockets Extension for WebAssembly does not support mixing descriptor types in poll() calls. An application must use only one type of descriptors each time it calls poll() (to pass either socket descriptors or file descriptors as arguments of a single call, never both). It is recommended to use poll() over select(), because the internalselect() implementation in the Samsung Emscripten SDK can be slow.	The Open Group Base Specifications Issue 7, 2018 edition - poll
read()	-	The Open Group Base Specifications Issue 7, 2018 edition - read
recv()	Values in flags: MSG_PEEK MSG_OOB MSG_WAITALL	The Open Group Base Specifications Issue 7, 2018 edition - recv
recvfrom()	Values in flags: MSG_PEEK MSG_OOB MSG_WAITALL	The Open Group Base Specifications Issue 7, 2018 edition - recvfrom
recvmsg()	Values in flags: MSG_PEEK MSG_OOB MSG_WAITALL	The Open Group Base Specifications Issue 7, 2018 edition - recvmsg
select()	Usage notes: TThe Tizen Sockets Extension for WebAssembly does not support mixing descriptor types in select() calls. An application must use only one type of descriptors each time it calls select() (to pass either socket descriptors or file descriptors as arguments of a single call, never both). The select() method can be slow due to its internal implementation in the Samsung Emscripten SDK. It is recommended to use poll() instead.	The Open Group Base Specifications Issue 7, 2018 edition - select
send()	Values in flags: MSG_EOR MSG_OOB MSG_NOSIGNAL	The Open Group Base Specifications Issue 7, 2018 edition - send
sendmsg()	Values in flags: MSG_EOR MSG_OOB MSG_NOSIGNAL	The Open Group Base Specifications Issue 7, 2018 edition - sendmsg
sendto()	Values in flags: MSG_EOR MSG_OOB MSG_NOSIGNAL	The Open Group Base Specifications Issue 7, 2018 edition - sendto
setsockopt()	Combinations of level and optname: SOL_SOCKET, SO_DEBUG, SOL_SOCKET, SO_BROADCAST SOL_SOCKET, SO_REUSEADDR SOL_SOCKET, SO_KEEPALIVE SOL_SOCKET, SO_OOBINLINE SOL_SOCKET, SO_SNDBUF SOL_SOCKET, SO_RCVBUF SOL_SOCKET, SO_DONTROUTE SOL_SOCKET, SO_RCVLOWAT SOL_SOCKET, SO_SNDLOWAT SOL_SOCKET, SO_RCVTIMEO SOL_SOCKET, SO_SNDTIMEO SOL_SOCKET, SO_LINGER IPPROTO_TCP, TCP_NODELAY IPPROTO_IP, IP_MULTICAST_LOOP IPPROTO_IP, IP_MULTICAST_TTL IPPROTO_IP, IP_ADD_MEMBERSHIP IPPROTO_IP, IP_ADD_SOURCE_MEMBERSHIP IPPROTO_IP, IP_BLOCK_SOURCE IPPROTO_IP, IP_DROP_MEMBERSHIP IPPROTO_IP, IP_DROP_SOURCE_MEMBERSHIP IPPROTO_IP, IP_UNBLOCK_SOURCE IPPROTO_IPV6, IPV6_MULTICAST_HOPS IPPROTO_IPV6, IPV6_MULTICAST_LOOP IPPROTO_IPV6, IPV6_JOIN_GROUP IPPROTO_IPV6, IPV6_LEAVE_GROUP	The Open Group Base Specifications Issue 7, 2018 edition - setsockopt The Linux Documentation Product - Multicast programming map7.org - ip
shutdown()	Values in how: SHUT_RD SHUT_WR SHUT_RDWR	The Open Group Base Specifications Issue 7, 2018 edition - shutdown
socket()	Values in domain: AF_INET AF_INET6 Values in type: SOCK_STREAM SOCK_DGRAM Flags bitwise ORed with type argument: SOCK_CLOEXEC SOCK_NONBLOCK	The Open Group Base Specifications Issue 7, 2018 edition - socket man7.org - socket
write()	-	The Open Group Base Specifications Issue 7, 2018 edition - write

Table 1: Tizen Sockets Extension Methods