blob: 9c5c71e18840c68b2984497b861091d44c201a37 [file] [log] [blame]
#ifndef MCTP_H
#define MCTP_H
#ifdef __cplusplus
extern "C" {
#endif
#include <stddef.h>
#include <stdint.h>
typedef uint8_t mctp_eid_t;
typedef enum pldm_requester_error_codes {
PLDM_REQUESTER_SUCCESS = 0,
PLDM_REQUESTER_OPEN_FAIL = -1,
PLDM_REQUESTER_NOT_PLDM_MSG = -2,
PLDM_REQUESTER_NOT_RESP_MSG = -3,
PLDM_REQUESTER_NOT_REQ_MSG = -4,
PLDM_REQUESTER_RESP_MSG_TOO_SMALL = -5,
PLDM_REQUESTER_INSTANCE_ID_MISMATCH = -6,
PLDM_REQUESTER_SEND_FAIL = -7,
PLDM_REQUESTER_RECV_FAIL = -8,
PLDM_REQUESTER_INVALID_RECV_LEN = -9,
} pldm_requester_rc_t;
/**
* @brief Connect to the MCTP socket and provide an fd to it. The fd can be
* used to pass as input to other APIs below, or can be polled.
*
* @return fd on success, pldm_requester_rc_t on error (errno may be set)
*/
pldm_requester_rc_t pldm_open();
/**
* @brief Send a PLDM request message. Wait for corresponding response message,
* which once received, is returned to the caller.
*
* @param[in] eid - destination MCTP eid
* @param[in] mctp_fd - MCTP socket fd
* @param[in] pldm_req_msg - caller owned pointer to PLDM request msg
* @param[in] req_msg_len - size of PLDM request msg
* @param[out] pldm_resp_msg - *pldm_resp_msg will point to PLDM response msg,
* this function allocates memory, caller to free(*pldm_resp_msg) on
* success.
* @param[out] resp_msg_len - caller owned pointer that will be made point to
* the size of the PLDM response msg.
*
* @return pldm_requester_rc_t (errno may be set)
*/
pldm_requester_rc_t pldm_send_recv(mctp_eid_t eid, int mctp_fd,
const uint8_t *pldm_req_msg,
size_t req_msg_len, uint8_t **pldm_resp_msg,
size_t *resp_msg_len);
/**
* @brief Send a PLDM request message, don't wait for response. Essentially an
* async API. A user of this would typically have added the MCTP fd to an
* event loop for polling. Once there's data available, the user would
* invoke pldm_recv().
*
* @param[in] eid - destination MCTP eid
* @param[in] mctp_fd - MCTP socket fd
* @param[in] pldm_req_msg - caller owned pointer to PLDM request msg
* @param[in] req_msg_len - size of PLDM request msg
*
* @return pldm_requester_rc_t (errno may be set)
*/
pldm_requester_rc_t pldm_send(mctp_eid_t eid, int mctp_fd,
const uint8_t *pldm_req_msg, size_t req_msg_len);
/**
* @brief Read MCTP socket. If there's data available, return success only if
* data is a PLDM response message that matches eid and instance_id.
*
* @param[in] eid - destination MCTP eid
* @param[in] mctp_fd - MCTP socket fd
* @param[in] instance_id - PLDM instance id of previously sent PLDM request msg
* @param[out] pldm_resp_msg - *pldm_resp_msg will point to PLDM response msg,
* this function allocates memory, caller to free(*pldm_resp_msg) on
* success.
* @param[out] resp_msg_len - caller owned pointer that will be made point to
* the size of the PLDM response msg.
*
* @return pldm_requester_rc_t (errno may be set). failure is returned even
* when data was read, but didn't match eid or instance_id.
*/
pldm_requester_rc_t pldm_recv(mctp_eid_t eid, int mctp_fd, uint8_t instance_id,
uint8_t **pldm_resp_msg, size_t *resp_msg_len);
/**
* @brief Read MCTP socket. If there's data available, return success only if
* data is a PLDM response message.
*
* @param[in] eid - destination MCTP eid
* @param[in] mctp_fd - MCTP socket fd
* @param[out] pldm_resp_msg - *pldm_resp_msg will point to PLDM response msg,
* this function allocates memory, caller to free(*pldm_resp_msg) on
* success.
* @param[out] resp_msg_len - caller owned pointer that will be made point to
* the size of the PLDM response msg.
*
* @return pldm_requester_rc_t (errno may be set). failure is returned even
* when data was read, but wasn't a PLDM response message
*/
pldm_requester_rc_t pldm_recv_any(mctp_eid_t eid, int mctp_fd,
uint8_t **pldm_resp_msg,
size_t *resp_msg_len);
#ifdef __cplusplus
}
#endif
#endif /* MCTP_H */