| .TH "auto_reconnect" 3 "Thu Sep 13 2018" "Paho Asynchronous MQTT C Client Library" \" -*- nroff -*- |
| .ad l |
| .nh |
| .SH NAME |
| auto_reconnect \- Automatic Reconnect |
| The ability for the client library to reconnect automatically in the event of a connection failure was added in 1\&.1\&. The connection lost callback allows a flexible response to the loss of a connection, so almost any behaviour can be implemented in that way\&. Automatic reconnect does have the advantage of being a little simpler to use\&. |
| .PP |
| To switch on automatic reconnect, the connect options field automaticReconnect should be set to non-zero\&. The minimum and maximum times before the next connection attempt can also be set, the defaults being 1 and 60 seconds\&. At each failure to reconnect, the retry interval is doubled until the maximum value is reached, and there it stays until the connection is successfully re-established whereupon it is reset\&. |
| .PP |
| When a reconnection attempt is successful, the \fBMQTTAsync_connected\fP callback function is invoked, if set by calling \fBMQTTAsync_setConnected\fP\&. This allows the application to take any actions needed, such as amending subscriptions\&. |
