1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
|
# modbus_receive
## Name
modbus_receive - receive an indication request
## Synopsis
```c
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 a 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 [modbus_set_socket](modbus_set_socket.md).
## Return value
The function shall store the indication request in `req` and return the request
length if successful. 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
- [modbus_set_socket](modbus_set_socket.md)
- [modbus_reply](modbus_reply.md)
|