msv.h (3)

#include <unistd.h>

Data Structures

struct msv_query

a query to the MSVA struct msv_response

a response from the MSVA

Macros

#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

Typedefs

typedef struct msv_ctxt * msv_ctxt_t

opaque MSVA context

Functions

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

#define LIBMSV_ERROR_CURLCODE 4

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

int msv_check_msva (\fBmsv_ctxt_t\fPctx)

Check suitability of Monkeysphere Validation Agent.

Parameters:

ctx the MSV context

Returns:

0 for success, or libmsv error code

void msv_ctxt_destroy (\fBmsv_ctxt_t\fPctx)

Destroy an MSV context.

Parameters:

ctx the MSV context to destroy

\fBmsv_ctxt_t\fP 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

int msv_query_agent (\fBmsv_ctxt_t\fPctx, struct \fBmsv_query\fPq, struct \fBmsv_response\fP **response_ptr)

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

void msv_response_destroy (struct \fBmsv_response\fP *response)

Destroy an MSV response.

Parameters:

response the MSV response to destroy

const char * msv_strerror (\fBmsv_ctxt_t\fPctx, interror_code)

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.