Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XS_INPROC(7)		     Crossroads	I/O Manual		  XS_INPROC(7)

NAME
       xs_inproc - local in-process (inter-thread) transport

SYNOPSIS
       The in-process transport	passes messages	via memory directly between
       threads sharing a single	context.

ADDRESSING
       A Crossroads address string consists of two parts as follows:
       transport://endpoint. The transport part	specifies the underlying
       transport protocol to use, and for the in-process transport shall be
       set to inproc. The meaning of the endpoint part for the in-process
       transport is defined below.

   Assigning a local address to	a socket
       When assigning a	local address to a socket using	xs_bind() with the
       inproc transport, the endpoint shall be interpreted as an arbitrary
       string identifying the name to create. The name must be unique within
       the context associated with the socket and may be up to 256 characters
       in length. No other restrictions	are placed on the format of the	name.

   Connecting a	socket
       When connecting a socket	to a peer address using	xs_connect() with the
       inproc transport, the endpoint shall be interpreted as an arbitrary
       string identifying the name to connect to. The name must	have been
       previously created by assigning it to at	least one socket within	the
       same context as the socket being	connected.

WIRE FORMAT
       Not applicable.

EXAMPLES
       Assigning a local address to a socket.

	   /* Assign the in-process name "#1" */
	   rc =	xs_bind(socket,	"inproc://#1");
	   assert (rc != -1);
	   /* Assign the in-process name "my-endpoint" */
	   rc =	xs_bind(socket,	"inproc://my-endpoint");
	   assert (rc != -1);

       Connecting a socket.

	   /* Connect to the in-process	name "#1" */
	   rc =	xs_connect(socket, "inproc://#1");
	   assert (rc != -1);
	   /* Connect to the in-process	name "my-endpoint" */
	   rc =	xs_connect(socket, "inproc://my-endpoint");
	   assert (rc != -1);

SEE ALSO
       xs_bind(3) xs_connect(3)	xs_ipc(7) xs_tcp(7) xs_pgm(7) xs(7)

AUTHORS
       The Crossroads documentation was	written	by Martin Sustrik
       <sustrik@250bpm.com[1]> and Martin Lucina <martin@lucina.net[2]>.

NOTES
	1. sustrik@250bpm.com
	   mailto:sustrik@250bpm.com

	2. martin@lucina.net
	   mailto:martin@lucina.net

Crossroads I/O 1.2.0		  08/08/2020			  XS_INPROC(7)

NAME | SYNOPSIS | ADDRESSING | WIRE FORMAT | EXAMPLES | SEE ALSO | AUTHORS | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xs_inproc&sektion=7&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help