/usr/include/mpath_cmd.h is in multipath-tools 0.7.4-2ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 | /*
* Copyright (C) 2015 Red Hat, Inc.
*
* This file is part of the device-mapper multipath userspace tools.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIB_MPATH_CMD_H
#define LIB_MPATH_CMD_H
#ifdef __cpluscplus
extern "C" {
#endif
#define DEFAULT_SOCKET "/org/kernel/linux/storage/multipathd"
#define DEFAULT_REPLY_TIMEOUT 4000
/*
* DESCRIPTION:
* Connect to the running multipathd daemon. On systems with the
* multipathd.socket systemd unit file installed, this command will
* start multipathd if it is not already running. This function
* must be run before any of the others in this library
*
* RETURNS:
* A file descriptor on success. -1 on failure (with errno set).
*/
int mpath_connect(void);
/*
* DESCRIPTION:
* Disconnect from the multipathd daemon. This function must be
* run after after processing all the multipath commands.
*
* RETURNS:
* 0 on success. -1 on failure (with errno set).
*/
int mpath_disconnect(int fd);
/*
* DESCRIPTION
* Send multipathd a command and return the reply. This function
* does the same as calling mpath_send_cmd() and then
* mpath_recv_reply()
*
* RETURNS:
* 0 on successs, and reply will either be NULL (if there was no
* reply data), or point to the reply string, which must be freed by
* the caller. -1 on failure (with errno set).
*/
int mpath_process_cmd(int fd, const char *cmd, char **reply,
unsigned int timeout);
/*
* DESCRIPTION:
* Send a command to multipathd
*
* RETURNS:
* 0 on success. -1 on failure (with errno set)
*/
int mpath_send_cmd(int fd, const char *cmd);
/*
* DESCRIPTION:
* Return a reply from multipathd for a previously sent command.
* This is equivalent to calling mpath_recv_reply_len(), allocating
* a buffer of the appropriate size, and then calling
* mpath_recv_reply_data() with that buffer.
*
* RETURNS:
* 0 on success, and reply will either be NULL (if there was no
* reply data), or point to the reply string, which must be freed by
* the caller, -1 on failure (with errno set).
*/
int mpath_recv_reply(int fd, char **reply, unsigned int timeout);
/*
* DESCRIPTION:
* Return the size of the upcoming reply data from the sent multipath
* command. This must be called before calling mpath_recv_reply_data().
*
* RETURNS:
* The required size of the reply data buffer on success. -1 on
* failure (with errno set).
*/
ssize_t mpath_recv_reply_len(int fd, unsigned int timeout);
/*
* DESCRIPTION:
* Return the reply data from the sent multipath command.
* mpath_recv_reply_len must be called first. reply must point to a
* buffer of len size.
*
* RETURNS:
* 0 on success, and reply will contain the reply data string. -1
* on failure (with errno set).
*/
int mpath_recv_reply_data(int fd, char *reply, size_t len,
unsigned int timeout);
#ifdef __cplusplus
}
#endif
#endif /* LIB_MPATH_CMD_H */
|