5f3f331d48
This change is related to patch called "net: Adapt to new behavior of net_buf_frag_add" This version removes extra net_nbuf_unref() from the code. The unref was done because net_buf_frag_del() did not remove the double ref from the list element. Because of the other patch, the list does not have double ref any more, so we need to remove the extra unref in couple of extra places. Change-Id: If90e01c24b9b4e68afbfa283850d2a1ecb3065ed Signed-off-by: Jukka Rissanen <jukka.rissanen@linux.intel.com>
58 lines
1.8 KiB
ReStructuredText
58 lines
1.8 KiB
ReStructuredText
.. _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:`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 downlow the example application
|
|
source file here `connectivity-example-app.c <https://gerrit.zephyrproject.org/r/gitweb?p=zephyr.git;a=blob;f=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
|