1 /*############################################################################
2   # Copyright 2016-2017 Intel Corporation
3   #
4   # Licensed under the Apache License, Version 2.0 (the "License");
5   # you may not use this file except in compliance with the License.
6   # You may obtain a copy of the License at
7   #
8   #     http://www.apache.org/licenses/LICENSE-2.0
9   #
10   # Unless required by applicable law or agreed to in writing, software
11   # distributed under the License is distributed on an "AS IS" BASIS,
12   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   # See the License for the specific language governing permissions and
14   # limitations under the License.
15   ############################################################################*/
16 #ifndef EPID_COMMON_1_1_SRC_GROUPPUBKEY_H_
17 #define EPID_COMMON_1_1_SRC_GROUPPUBKEY_H_
18 /*!
19  * \file
20  * \brief Intel(R) EPID 1.1 group public key interface.
21  * \addtogroup EpidCommon
22  * @{
23  */
24 #include "epid/common/1.1/types.h"
25 #include "epid/common/errors.h"
26 #include "epid/common/math/ecgroup.h"
27 
28 /// Internal representation of Epid11GroupPubKey
29 typedef struct Epid11GroupPubKey_ {
30   Epid11GroupId gid;  ///< group ID
31   EcPoint* h1;        ///< an element in G1
32   EcPoint* h2;        ///< an element in G1
33   EcPoint* w;         ///< an element in G2
34 } Epid11GroupPubKey_;
35 
36 /// Constructs internal representation of Intel(R) EPID 1.1 group public key
37 /*!
38   Allocates memory and initializes gid, h1, h2, w parameters. Use
39   DeleteEpid11GroupPubKey() to deallocate memory
40 
41   \param[in] pub_key_str
42   Oct string representation of group public key
43   \param[in] G1
44   EcGroup containing elements h1 and h2
45   \param[in] G2
46   EcGroup containing element w
47   \param[out] pub_key
48   Group public key: (gid, h1, h2, w)
49 
50   \returns ::EpidStatus
51   \see DeleteEpid11GroupPubKey
52 */
53 EpidStatus CreateEpid11GroupPubKey(Epid11GroupPubKey const* pub_key_str,
54                                    EcGroup* G1, EcGroup* G2,
55                                    Epid11GroupPubKey_** pub_key);
56 
57 /// Deallocates storage for internal representation Intel(R) EPID 1.1 group
58 /// public key
59 /*!
60   Frees memory pointed to by Epid11GroupPubKey. Nulls the pointer.
61 
62   \param[in] pub_key
63   Epid11GroupPubKey to be freed
64 
65   \see CreateEpid11GroupPubKey
66 */
67 void DeleteEpid11GroupPubKey(Epid11GroupPubKey_** pub_key);
68 /*! @} */
69 #endif  // EPID_COMMON_1_1_SRC_GROUPPUBKEY_H_
70