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

FreeBSD Manual Pages

  
 
  

home | help
MODBUS_TCP_PI_LISTEN(3)	       libmodbus Manual	       MODBUS_TCP_PI_LISTEN(3)

NAME
       modbus_tcp_pi_listen - create and listen	a TCP PI Modbus	socket (IPv6)

SYNOPSIS
       int modbus_tcp_pi_listen(modbus_t *ctx, int nb_connection);

DESCRIPTION
       The modbus_tcp_pi_listen() function shall create	a socket and listen to
       maximum nb_connection incoming connections on the specified nodes. The
       context ctx must	be allocated and initialized with modbus_new_tcp_pi(3)
       before to set the node to listen, if node is set	to NULL, any addresses
       will be listen.

RETURN VALUE
       The function shall return a new socket if successful. Otherwise it
       shall return -1 and set errno.

EXAMPLE
       For detailed examples, see source files in tests	directory:

       o   unit-test-server.c, simple but handle only one connection

	   ...

	   ctx = modbus_new_tcp_pi("::0", "502");
	   s = modbus_tcp_pi_listen(ctx, 1);
	   modbus_tcp_pi_accept(ctx, &s);

	   for (;;) {
	       rc = modbus_receive(ctx,	query);
	       modbus_replay(ctx, query, rc, mb_mapping);
	   }
	   ...

	   mclose(s);
	   modbus_free(ctx);

       o   bandwidth-server-many-up.c, handles several connections at once

SEE ALSO
       modbus_new_tcp_pi(3) modbus_tcp_pi_accept(3) modbus_tcp_listen(3)

AUTHORS
       The libmodbus documentation was written by StA(C)phane Raimbault
       <stephane.raimbault@gmail.com>

libmodbus v3.1.4		  04/29/2017	       MODBUS_TCP_PI_LISTEN(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO | AUTHORS

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

home | help