doc/subsystems/networking/networking-api-usage.rst

.. _networking_api_usage:

Network Connectivity API
########################

Applications can use the connectivity API defined in :file:`net_context.h`
to create a connection, send or receive data, and close a connection.
The same API can be used when working with UDP or TCP data.

The net_context API is similar to the BSD socket API and mapping between these
two is possible. The main difference between net_context API and BSD socket
API is that the net_context API uses the fragmented network buffers (net_buf)
defined in :file:`include/net/buf.h` and BSD socket API uses linear memory buffers.

This example creates a simple server that listens to incoming UDP connections
and sends the received data back. You can download the example application
source file here `connectivity-example-app.c <https://raw.githubusercontent.com/zephyrproject-rtos/zephyr/master/doc/subsystems/networking/connectivity-example-app.c>`_

This example application begins with some initialization. (Use this as an
example; you may need to do things differently in your own application.)

.. literalinclude:: connectivity-example-app.c
    :linenos:
    :language: c
    :lines: 2-54

After initialization, first thing application needs to create a context.
Context is similar to a socket.

.. literalinclude:: connectivity-example-app.c
    :linenos:
    :language: c
    :lines: 57-66

Then you need to define the local end point for a connection.

.. literalinclude:: connectivity-example-app.c
    :linenos:
    :language: c
    :lines: 69-83

Wait until the connection data is received.

.. literalinclude:: connectivity-example-app.c
    :linenos:
    :language: c
    :lines: 86-202

Close the context when finished.

.. literalinclude:: connectivity-example-app.c
    :linenos:
    :language: c
    :lines: 204-215

.. toctree::
   :maxdepth: 1