doc: net: sockets: Add table summarizing supported socket types

Add a table in sockets documentation summarizing what socket types are
being supported.

Signed-off-by: Robert Lubos <[email protected]>

Author: rlubos

doc/connectivity/networking/api/sockets.rst

@@ -57,6 +57,45 @@ there is a table mapping file descriptors to internal object pointers.
 The file descriptor table is used by the BSD Sockets API even if the rest
 of the POSIX subsystem (filesystem, stdin/stdout) is not enabled.
 
+Zephyr supports multiple types of BSD sockets, the following table summarizes
+what socket types are available:
+
++-----------+-------------+------------------+-----------------------------------------------------+
+| Family    | Type        | Protocol         | Description                                         |
++===========+=============+==================+=====================================================+
+| AF_INET   | SOCK_DGRAM  | IPPROTO_UDP      | Enabled if CONFIG_NET_UDP is set.                   |
+| AF_INET6  |             |                  | Allows to send and receive UDP datagrams.           |
+|           |             +------------------+-----------------------------------------------------+
+|           |             | IPPROTO_DTLS_1_x | Enabled if CONFIG_NET_SOCKETS_ENABLE_DTLS is set.   |
+|           |             |                  | Allows to send and receive DTLS datagrams.          |
+|           +-------------+------------------+-----------------------------------------------------+
+|           | SOCK_STREAM | IPPROTO_TCP      | Enabled if CONFIG_NET_TCP is set.                   |
+|           |             |                  | Allows to send and receive TCP data stream.         |
+|           |             +------------------+-----------------------------------------------------+
+|           |             | IPPROTO_TLS_1_x  | Enabled if CONFIG_NET_SOCKETS_SOCKOPT_TLS is set.   |
+|           |             |                  | Allows to send and receive TLS data stream.         |
+|           +-------------+------------------+-----------------------------------------------------+
+|           | SOCK_RAW    | IPPROTO_IP       | Enabled if CONFIG_NET_SOCKETS_INET_RAW is set.      |
+|           |             | <proto>          | Allows to send and receive IPv4/IPv6 datagrams.     |
+|           |             |                  | Packets are filtered by L4 protocol specified.      |
+|           |             |                  | IPPROTO_IP is a wildcard protocol to receive all IP |
+|           |             |                  | datagrams.                                          |
++-----------+-------------+------------------+-----------------------------------------------------+
+| AF_PACKET | SOCK_DGRAM  | ETH_P_ALL        | Enabled if CONFIG_NET_SOCKETS_PACKET_DGRAM is set.  |
+|           |             | <proto>          | Allows to send and receive packets without L2       |
+|           |             |                  | header.                                             |
+|           |             |                  | Packets are filtered by L3 protocol specified.      |
+|           |             |                  | ETH_P_ALL is a wildcard protocol to receive all     |
+|           |             |                  | packets.                                            |
+|           +-------------+------------------+-----------------------------------------------------+
+|           | SOCK_RAW    | ETH_P_ALL        | Enabled if CONFIG_NET_SOCKETS_PACKET is set.        |
+|           |             |                  | Allows to send and receive packets with L2 header   |
+|           |             |                  | included.                                           |
++-----------+-------------+------------------+-----------------------------------------------------+
+| AF_CAN    | SOCK_RAW    | CAN_RAW          | Enabled if CONFIG_NET_SOCKETS_CAN is set.           |
+|           |             |                  | Allows to send and receive CAN packets.             |
++-----------+-------------+------------------+-----------------------------------------------------+
+
 See :zephyr:code-sample:`sockets-echo-server` and :zephyr:code-sample:`sockets-echo-client`
 sample applications to learn how to create a simple server or client BSD socket based
 application.