DOKK / manpages / debian 10 / libmsv-dev / msv.h.3.en
msv/msv.h(3) Library Functions Manual msv/msv.h(3)

msv/msv.h - main public libmsv header file

#include <unistd.h>


struct msv_query
a query to the MSVA struct msv_response
a response from the MSVA


#define LIBMSV_ERROR_SUCCESS 0
Success or absence of error. #define LIBMSV_ERROR_INVALID 1
Use of certificate could not be determined valid or was determined invalid. #define LIBMSV_ERROR_NOENVVAR 2
Environment variable was needed but was not set. #define LIBMSV_ERROR_CURLINIT_FAILED 3
curl_easy_init() failed for unknown reason #define LIBMSV_ERROR_CURLCODE 4
an unspecified curl function failed #define LIBMSV_ERROR_INCOMPATIBLE_AGENT 5
MSVA was perceived as incompatible. #define LIBMSV_ERROR_BADARG 6
An argument to the function was invalid. #define LIBMSV_ERROR_UNEXPECTED_RESPONSE 7
The response from MSVA was unexpected. #define LIBMSV_ERROR_NOMEM 8
necessary memory allocation failed #define MSV_DEPRECATED(X) X


typedef struct msv_ctxt * msv_ctxt_t
opaque MSVA context


msv_ctxt_t msv_ctxt_init (const char *url)
Return an MSV context. void msv_ctxt_destroy (msv_ctxt_t ctx)
Destroy an MSV context. const char * msv_strerror (msv_ctxt_t ctx, int error_code)
Return string describing libmsv error code. int msv_check_msva (msv_ctxt_t ctx)
Check suitability of Monkeysphere Validation Agent. int msv_query_agent (msv_ctxt_t ctx, struct msv_query q, struct msv_response **response_ptr)
Query validation agent for certificate validity. void msv_response_destroy (struct msv_response *response)
Destroy an MSV response.

main public libmsv header file

an unspecified curl function failed The MSV context retains the curl error code for the last operation run within that context

Check suitability of Monkeysphere Validation Agent.

Parameters:

ctx the MSV context

Returns:

0 for success, or libmsv error code

Destroy an MSV context.

Parameters:

ctx the MSV context to destroy

msv_ctxt_t msv_ctxt_init (const char * url)

Return an MSV context.

Parameters:

url URL for MSVA or NULL to use MONKEYSPHERE_VALIDATION_AGENT_SOCKET environment variable

Returns:

MSV context

Query validation agent for certificate validity.

Parameters:

ctx the MSV context
q msv_query struct representing the MSVA query
response_ptr pointer to pointer to msv_response struct that the caller is responsible for destroying via msv_response_destroy

Returns:

0 for valid use of certificate, 1 for invalid use of certificate, or libmsv error code

Destroy an MSV response.

Parameters:

response the MSV response to destroy

Return string describing libmsv error code.

Parameters:

ctx the relevant MSV context
error_code return value of libmsv function

Returns:

string describing error

Generated automatically by Doxygen for libmsv from the source code.

Wed Feb 27 2019 libmsv