2 * Copyright (C) 2010 Andreas Steffen
3 * HSR Hochschule fuer Technik Rapperswil
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License as published by the
7 * Free Software Foundation; either version 2 of the License, or (at your
8 * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
12 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 * @defgroup imv_manager imv_manager
21 #ifndef IMV_MANAGER_H_
22 #define IMV_MANAGER_H_
25 #include "imv_recommendations.h"
29 typedef struct imv_manager_t imv_manager_t
;
32 * The IMV manager controls all IMV instances.
34 struct imv_manager_t
{
39 * @param imv IMV instance
40 * @return TRUE if initialization successful
42 bool (*add
)(imv_manager_t
*this, imv_t
*imv
);
45 * Remove an IMV instance from the list and return it
47 * @param id ID of IMV instance
48 * @return removed IMC instance
50 imv_t
* (*remove
)(imv_manager_t
*this, TNC_IMVID id
);
53 * Get the configured recommendation policy
55 * @return configured recommendation policy
57 recommendation_policy_t (*get_recommendation_policy
)(imv_manager_t
*this);
60 * Create an empty set of IMV recommendations and evaluations
62 * @return instance of a recommendations_t list
64 recommendations_t
* (*create_recommendations
)(imv_manager_t
*this);
67 * Enforce the TNC recommendation on the IKE_SA by either inserting an
68 * allow|isolate group membership rule (TRUE) or by blocking access (FALSE)
70 * @param void TNC action recommendation
71 * @return TRUE for allow|isolate, FALSE for none
73 bool (*enforce_recommendation
)(imv_manager_t
*this,
74 TNC_IMV_Action_Recommendation rec
);
77 * Notify all IMV instances
79 * @param state communicate the state a connection has reached
81 void (*notify_connection_change
)(imv_manager_t
*this,
83 TNC_ConnectionState state
);
86 * Sets the supported message types reported by a given IMV
88 * @param id ID of reporting IMV
89 * @param supported_types list of messages type supported by IMV
90 * @param type_count number of supported message types
91 * @return TNC result code
93 TNC_Result (*set_message_types
)(imv_manager_t
*this,
95 TNC_MessageTypeList supported_types
,
96 TNC_UInt32 type_count
);
99 * Solicit recommendations from IMVs that have not yet provided one
101 * @param id connection ID
103 void (*solicit_recommendation
)(imv_manager_t
*this, TNC_ConnectionID id
);
106 * Delivers a message to interested IMVs.
108 * @param connection_id ID of connection over which message was received
109 * @param message message
110 * @param message_len message length
111 * @param message_type message type
113 void (*receive_message
)(imv_manager_t
*this,
114 TNC_ConnectionID connection_id
,
115 TNC_BufferReference message
,
116 TNC_UInt32 message_len
,
117 TNC_MessageType message_type
);
120 * Notify all IMVs that all IMC messages received in a batch have been
121 * delivered and this is the IMVs last chance to send a message in the
122 * batch of IMV messages currently being collected.
124 * @param id connection ID
126 void (*batch_ending
)(imv_manager_t
*this, TNC_ConnectionID id
);
129 * Destroy an IMV manager and all its controlled instances.
131 void (*destroy
)(imv_manager_t
*this);
134 #endif /** IMV_MANAGER_H_ @}*/