:orphan:

.. index:: pair: page; Create a connection with connection oriented sockets
.. _doxid-lib-stream_client_server:

Create a connection with connection oriented sockets
====================================================

#. Call **socket()** on ``srvr`` PCO with the following parameters: ``domain``, ``SOCK_STREAM``, ``proto``. Created socket is referred as ``srvr_s`` below;

#. If ``srvr_wild`` is true, fill in network address part of ``srvr_bind_addr`` with wildcard network address;

#. Copy port part of ``srvr_addr`` to port part of ``srvr_bind_addr`` address;

#. Bind ``srvr_s`` socket to ``srvr_bind_addr`` address.

#. If port part of ``srvr_addr`` is zero (not specified), then call **getsockname()** on ``srvr_s`` socket to obtain the assigned port and set it to the port part of ``srvr_addr``.

#. Call **listen()** for ``srvr_s`` socket with default *backlog*.

``SOCK_STREAM``



#. Call **socket()** on *clnt* PCO with the following parameters: ``domain``, ``SOCK_STREAM``, ``proto``. Created socket is referred as ``clnt_s`` below.

#. If ``clnt_addr`` is not equal to ``NULL``, **bind()** ``clnt_s`` socket to ``clnt_addr`` address.

#. Initiate **accept()** for ``srvr_s`` socket;

#. Call **connect()** to connect client socket ``clnt_s`` to server with ``srvr_addr`` address;

#. Wait for **accept()** completion to get ``accepted_s`` socket;

#. Close srvr_s socket

#. Set ``accepted_s`` to ``srvr_s`` variable.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- srvr

		- PCO for server

	*
		- clnt

		- PCO for client

	*
		- domain

		- Domain used in the connection

	*
		- proto

		- Protocol used in the connection

	*
		- srvr_addr

		- server address (cannot be ``NULL``) to be used as a template for **bind()** on server side and for **connect()** on client side. Network address part of the ``srvr_addr`` must be specified, but it is allowed to left port part of ``srvr_addr`` unspecified, which means we do not mind which address the server is bound to (on return the actual port used in established connection is set to the port part of ``srvr_addr``).

	*
		- srvr_wild

		- bind server to wildcard address or not (although we must specify network address in ``srvr_addr`` parameter, it is still allowed to bind server socket to the wildcard address)

	*
		- clnt_addr

		- address to bind client to or ``NULL``

	*
		- srvr_s

		- ``SOCK_STREAM`` socket reside on ``srvr``

	*
		- clnt_s

		- ``SOCK_STREAM`` socket reside on ``clnt``