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

FreeBSD Manual Pages

  
 
  

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

NAME
       modbus_receive_confirmation - receive a confirmation request

SYNOPSIS
       int modbus_receive_confirmation(modbus_t	*ctx, uint8_t *rsp);

DESCRIPTION
       The modbus_receive_confirmation() function shall	receive	a request via
       the socket of the context ctx. This function must be used for debugging
       purposes	because	the received response isn't checked against the
       initial request.	This function can be used to receive request not
       handled by the library.

       The maximum size	of the response	depends	on the used backend, in	RTU
       the rsp array must be MODBUS_RTU_MAX_ADU_LENGTH bytes and in TCP	it
       must be MODBUS_TCP_MAX_ADU_LENGTH bytes.	If you want to write code
       compatible with both, you can use the constant MODBUS_MAX_ADU_LENGTH
       (maximum	value of all libmodbus backends). Take care to allocate	enough
       memory to store responses to avoid crashes of your server.

RETURN VALUE
       The function shall store	the confirmation request in rsp	and return the
       response	length if sucessful. The returned request length can be	zero
       if the indication request is ignored (eg. a query for another slave in
       RTU mode). Otherwise it shall return -1 and set errno.

EXAMPLE
	   uint8_t rsp[MODBUS_MAX_ADU_LENGTH];
	   rc =	modbus_receive_confirmation(ctx, rsp);

SEE ALSO
       modbus_send_raw_request(3)

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

libmodbus v3.1.6		  03/01/2021	       MODBUS_RECEIVE_CONFI(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_receive_confirmation&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help