Return to pts_meas_algo.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / strongswan / src / libimcv / pts

Annotation of embedaddon/strongswan/src/libimcv/pts/pts_meas_algo.h, revision 1.1.1.1

1.1       misho       1: /*
                      2:  * Copyright (C) 2011 Sansar Choinyambuu
                      3:  * Copyright (C) 2011-2014 Andreas Steffen
                      4:  * HSR Hochschule fuer Technik Rapperswil
                      5:  *
                      6:  * This program is free software; you can redistribute it and/or modify it
                      7:  * under the terms of the GNU General Public License as published by the
                      8:  * Free Software Foundation; either version 2 of the License, or (at your
                      9:  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
                     10:  *
                     11:  * This program is distributed in the hope that it will be useful, but
                     12:  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
                     13:  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
                     14:  * for more details.
                     15:  */
                     16: 
                     17: /**
                     18:  * @defgroup pts_meas_algo pts_meas_algo
                     19:  * @{ @ingroup pts
                     20:  */
                     21: 
                     22: #ifndef PTS_MEAS_ALGO_H_
                     23: #define PTS_MEAS_ALGO_H_
                     24: 
                     25: #include <library.h>
                     26: #include <crypto/hashers/hasher.h>
                     27: 
                     28: typedef enum pts_meas_algorithms_t pts_meas_algorithms_t;
                     29: 
                     30: /**
                     31:  * PTS Measurement Algorithms
                     32:  */
                     33: enum pts_meas_algorithms_t {
                     34:        PTS_MEAS_ALGO_NONE     =      0,
                     35:        PTS_MEAS_ALGO_SHA384   = (1<<13),
                     36:        PTS_MEAS_ALGO_SHA256   = (1<<14),
                     37:        PTS_MEAS_ALGO_SHA1     = (1<<15)
                     38: };
                     39: 
                     40: /**
                     41:  * enum name for pts_meas_algorithms_t.
                     42:  */
                     43: extern enum_name_t *pts_meas_algorithm_names;
                     44: 
                     45: /**
                     46:  * Diffie-Hellman Hash Algorithm Values
                     47:  * see section 3.8.5 of PTS Protocol: Binding to TNC IF-M Specification
                     48:  *
                     49:  *                                        1
                     50:  *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
                     51:  *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                     52:  *  |1|2|3|R|R|R|R|R|R|R|R|R|R|R|R|R|
                     53:  *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                     54:  *
                     55:  */
                     56: 
                     57: /**
                     58:  * Probe available PTS measurement algorithms
                     59:  *
                     60:  * @param algorithms   set of available algorithms
                     61:  * @return                             TRUE if mandatory algorithms are available
                     62:  */
                     63: bool pts_meas_algo_probe(pts_meas_algorithms_t *algorithms);
                     64: 
                     65: /**
                     66:  * Update supported PTS measurement algorithms according to configuration
                     67:  *
                     68:  * sha1 :  PTS_MEAS_ALGO_SHA1
                     69:  * sha256: PTS_MEAS_ALGO_SHA1 | PTS_MEAS_ALGO_SHA256
                     70:  * sha384: PTS_MEAS_ALGO_SHA1 | PTS_MEAS_ALGO_SHA256 | PTS_MEAS_ALGO_SHA384
                     71:  *
                     72:  * The PTS-IMC is expected to select the strongest supported algorithm
                     73:  *
                     74:  * @param hash_alg             configured hash algorithm
                     75:  * @param algorithms   returns set of available PTS measurement algorithms
                     76:  */
                     77: bool pts_meas_algo_update(char *hash_alg, pts_meas_algorithms_t *algorithms);
                     78: 
                     79: /**
                     80:  * Select the strongest PTS measurement algorithm
                     81:  * among a set of offered PTS measurement algorithms
                     82:  *
                     83:  * @param supported_algos      set of supported PTS measurement algorithms
                     84:  * @param offered_algos                set of offered PTS measurements algorithms
                     85:  * @return                                     selected algorithm
                     86:  */
                     87: pts_meas_algorithms_t pts_meas_algo_select(pts_meas_algorithms_t supported_algos,
                     88:                                                                                   pts_meas_algorithms_t offered_algos);
                     89: 
                     90: /**
                     91:  * Convert pts_meas_algorithms_t to hash_algorithm_t
                     92:  *
                     93:  * @param algorithm            PTS measurement algorithm type
                     94:  * @return                             libstrongswan hash algorithm type
                     95:  */
                     96: hash_algorithm_t pts_meas_algo_to_hash(pts_meas_algorithms_t algorithm);
                     97: 
                     98: /**
                     99:  * Convert hash_algorithm_t to pts_meas_algorithms_t
                    100:  *
                    101:  * @param algorithm            PTS measurement algorithm type
                    102:  * @return                             libstrongswan hash algorithm type
                    103:  */
                    104: pts_meas_algorithms_t pts_meas_algo_from_hash(hash_algorithm_t algorithm);
                    105: 
                    106: /**
                    107:  * Return the hash size of a pts_meas_algorithm
                    108:  *
                    109:  * @param algorithm            PTS measurement algorithm type
                    110:  * @return                             hash size in bytes
                    111:  */
                    112: size_t pts_meas_algo_hash_size(pts_meas_algorithms_t algorithm);
                    113: 
                    114: #endif /** PTS_MEAS_ALGO_H_ @}*/