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

FreeBSD Manual Pages

  
 
  

home | help
modbus_new_tcp_pi()					   modbus_new_tcp_pi()

Name
       modbus_new_tcp_pi  -  create a libmodbus	context	for TCP	Protocol Inde-
       pendent

Synopsis
       *modbus_t *modbus_new_tcp_pi(const char *node, const char *service);

Description
       The modbus_new_tcp_pi() function	shall allocate and initialize  a  mod-
       bus_t structure to communicate with a Modbus TCP	IPv4 or	IPv6 server.

       The  node argument specifies the	host name or IP	address	of the host to
       connect to, eg. "192.168.0.5" , "::1" or	"server.com". A	NULL value can
       be used to listen any addresses in server mode.

       because it's not	necessary to have administrator	privileges.

       because it's not	necessary to have administrator	privileges.

       because it's not	necessary to have administrator	privileges.

       because it's not	necessary to have administrator	privileges.

       e it's not necessary to have administrator privileges.

       :octicons-tag-24: v3.1.8	handles	NULL value for service (no EINVAL  er-
       ror).

Return value
       The function shall return a pointer to a	modbus_t structure if success-
       ful.  Otherwise it shall	return NULL and	set errno to one of the	values
       defined below.

Errors
        ENOMEM, out of	memory.	Possibly,  the	application  hits  its	memory
	 limit and/or whole system is running out of memory.

Example
       modbus_t	*ctx;

       ctx = modbus_new_tcp_pi("::1", "502");
       if (ctx == NULL)	{
	   fprintf(stderr, "Unable to allocate libmodbus context\n");
	   return -1;
       }

       if (modbus_connect(ctx) == -1) {
	   fprintf(stderr, "Connection failed: %s\n", modbus_strerror(errno));
	   modbus_free(ctx);
	   return -1;
       }

See also
        modbus_new_tcp	<modbus_new_tcp.md>

        modbus_tcp_pi_listen <modbus_tcp_pi_listen.md>

        modbus_free <modbus_free.md>

							   modbus_new_tcp_pi()

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=modbus_new_tcp_pi&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help