NAME

       msv/msv.h -

       main public libmsv header file

SYNOPSIS

   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.

   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.

Detailed Description

       main public libmsv header file

Macro Definition Documentation

   #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

Function Documentation

   int msv_check_msva (msv_ctxt_tctx)
       Check suitability of Monkeysphere Validation Agent. Parameters:
           ctx the MSV context

       Returns:
           0 for success, or libmsv error code

   void msv_ctxt_destroy (msv_ctxt_tctx)
       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

   int msv_query_agent (msv_ctxt_tctx, struct msv_queryq, struct msv_response **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 msv_response *response)
       Destroy an MSV response. Parameters:
           response the MSV response to destroy

   const char * msv_strerror (msv_ctxt_tctx, 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

Author

       Generated automatically by Doxygen for libmsv from the source code.

libmsv                                           Sun Apr 28 2013                                    msv/msv.h(3)