src/libimcv/imc/imc_agent.h

   1 /*
   2  * Copyright (C) 2011 Andreas Steffen, HSR Hochschule fuer Technik Rapperswil
   3  *
   4  * This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the GNU General Public License as published by the
   6  * Free Software Foundation; either version 2 of the License, or (at your
   7  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  11  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * for more details.
  13  */
  14
  15 /**
  16  *
  17  * @defgroup imc_agent_t imc_agent
  18  * @{ @ingroup imc_agent
  19  */
  20
  21 #ifndef IMC_AGENT_H_
  22 #define IMC_AGENT_H_
  23
  24 #include "imc_state.h"
  25 #include "pa_tnc/pa_tnc_msg.h"
  26
  27 #include <tncifimc.h>
  28 #include <pen/pen.h>
  29
  30 #include <library.h>
  31
  32 typedef struct imc_agent_t imc_agent_t;
  33
  34 /**
  35  * Core functions of an Integrity Measurement Verifier (IMC)
  36  */
  37 struct imc_agent_t {
  38
  39         /**
  40          * Ask a TNCC to retry an Integrity Check Handshake
  41          *
  42          * @param imc_id                        IMC ID assigned by TNCC
  43          * @param connection_id         network connection ID assigned by TNCC
  44          * @param reason                        IMC retry reason
  45          * @return                                      TNC result code
  46          */
  47         TNC_Result (*request_handshake_retry)(TNC_IMCID imc_id,
  48                                                                                   TNC_ConnectionID connection_id,
  49                                                                                   TNC_RetryReason reason);
  50
  51         /**
  52          * Bind TNCC functions
  53          *
  54          * @param bind_function         function offered by the TNCC
  55          * @return                                      TNC result code
  56          */
  57         TNC_Result (*bind_functions)(imc_agent_t *this,
  58                                                                  TNC_TNCC_BindFunctionPointer bind_function);
  59
  60         /**
  61          * Create the IMC state for a TNCCS connection instance
  62          *
  63          * @param state                         internal IMC state instance
  64          * @return                                      TNC result code
  65          */
  66         TNC_Result (*create_state)(imc_agent_t *this, imc_state_t *state);
  67
  68         /**
  69          * Delete the IMC state for a TNCCS connection instance
  70          *
  71          * @param connection_id         network connection ID assigned by TNCS
  72          * @return                                      TNC result code
  73          */
  74         TNC_Result (*delete_state)(imc_agent_t *this,
  75                                                            TNC_ConnectionID connection_id);
  76
  77         /**
  78          * Change the current state of a TNCCS connection
  79          *
  80          * @param connection_id         network connection ID assigned by TNCS
  81          * @param new_state                     new state of TNCCS connection
  82          * @param state_p                       internal IMC state instance [optional argument]
  83          * @return                                      TNC result code
  84          */
  85         TNC_Result (*change_state)(imc_agent_t *this,
  86                                                            TNC_ConnectionID connection_id,
  87                                                            TNC_ConnectionState new_state,
  88                                                            imc_state_t **state_p);
  89
  90         /**
  91          * Get the IMC state for a TNCCS connection instance
  92          *
  93          * @param connection_id         network connection ID assigned by TNCS
  94          * @param state                         internal IMC state instance
  95          * @return                                      TRUE if the state was found
  96          */
  97         bool (*get_state)(imc_agent_t *this,
  98                                           TNC_ConnectionID connection_id, imc_state_t **state);
  99
 100         /**
 101          * Call when an PA-TNC message is to be sent
 102          *
 103          * @param connection_id         network connection ID assigned by TNCC
 104          * @param msg                           message to send
 105          * @return                                      TNC result code
 106          */
 107         TNC_Result (*send_message)(imc_agent_t *this,
 108                                                            TNC_ConnectionID connection_id,
 109                                                            chunk_t msg);
 110
 111         /**
 112          * Call when a PA-TNC message was received
 113          *
 114          * @param connection_id         network connection ID assigned by TNCC
 115          * @param msg                           received unparsed message
 116          * @param msg_type                      message type of the received message
 117          * @param pa_tnc_message        parsed PA-TNC message or NULL if an error occurred
 118          * @return                                      TNC result code
 119          */
 120         TNC_Result (*receive_message)(imc_agent_t *this,
 121                                                                   TNC_ConnectionID connection_id, chunk_t msg,
 122                                                                   TNC_MessageType msg_type,
 123                                                                   pa_tnc_msg_t **pa_tnc_msg);
 124
 125         /**
 126          * Destroys an imc_agent_t object
 127          */
 128         void (*destroy)(imc_agent_t *this);
 129 };
 130
 131 /**
 132  * Create an imc_agent_t object
 133  *
 134  * @param name                          name of the IMC
 135  * @param vendor_id                     vendor ID of the IMC
 136  * @param subtype                       message subtype of the IMC
 137  * @param id                            ID of the IMC as assigned by the TNCS
 138  * @param actual_version        actual version of the IF-IMC API
 139  *
 140  */
 141 imc_agent_t *imc_agent_create(const char *name,
 142                                                           pen_t vendor_id, u_int32_t subtype,
 143                                                           TNC_IMCID id, TNC_Version *actual_version);
 144
 145 #endif /** IMC_AGENT_H_ @}*/