libmodbus/doc/modbus_receive.txt

modbus_receive(3)
=================


NAME
----
modbus_receive - receive a indication request


SYNOPSIS
--------
*int modbus_receive(modbus_t *'ctx', uint8_t *'req');*


DESCRIPTION
-----------
The _modbus_receive()_ function shall receive an indication request from the
socket of the context 'ctx'. This function is used by Modbus slave/server to
receive and analyze indication request sent by the masters/clients.

If you need to use another socket or file descriptor than the one defined in the
context 'ctx', see the function linkmb:modbus_set_socket[3].


RETURN VALUE
------------
The _modbus_receive()_ function shall store the indication request in 'req' and
return the request 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.


SEE ALSO
--------
linkmb:modbus_set_socket[3]
linkmb:modbus_reply[3]


AUTHORS
-------
The libmodbus documentation was written by Stéphane Raimbault
<stephane.raimbault@gmail.com>