multipath -u: test socket connection in non-blocking mode
[multipath-tools/.git] / libmpathcmd / mpath_cmd.h
index 15aeb06..ccfd35f 100644 (file)
@@ -34,6 +34,21 @@ extern "C" {
 #define DEFAULT_REPLY_TIMEOUT  4000
 
 
+/*
+ * DESCRIPTION:
+ *     Same as mpath_connect() (see below) except for the "nonblocking"
+ *     parameter.
+ *     If "nonblocking" is set, connects in non-blocking mode. This is
+ *     useful to avoid blocking if the listening socket's backlog is
+ *     exceeded. In this case, errno will be set to EAGAIN.
+ *     In case of success, the returned file descriptor is in in blocking
+ *     mode, even if "nonblocking" was true.
+ *
+ * RETURNS:
+ *     A file descriptor on success. -1 on failure (with errno set).
+ */
+int __mpath_connect(int nonblocking);
+
 /*
  * DESCRIPTION:
  *     Connect to the running multipathd daemon. On systems with the