xref: /OK3568_Linux_fs/u-boot/include/android_avb/avb_rsa.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Copyright (C) 2016 The Android Open Source Project
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Permission is hereby granted, free of charge, to any person
5*4882a593Smuzhiyun  * obtaining a copy of this software and associated documentation
6*4882a593Smuzhiyun  * files (the "Software"), to deal in the Software without
7*4882a593Smuzhiyun  * restriction, including without limitation the rights to use, copy,
8*4882a593Smuzhiyun  * modify, merge, publish, distribute, sublicense, and/or sell copies
9*4882a593Smuzhiyun  * of the Software, and to permit persons to whom the Software is
10*4882a593Smuzhiyun  * furnished to do so, subject to the following conditions:
11*4882a593Smuzhiyun  *
12*4882a593Smuzhiyun  * The above copyright notice and this permission notice shall be
13*4882a593Smuzhiyun  * included in all copies or substantial portions of the Software.
14*4882a593Smuzhiyun  *
15*4882a593Smuzhiyun  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16*4882a593Smuzhiyun  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17*4882a593Smuzhiyun  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18*4882a593Smuzhiyun  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19*4882a593Smuzhiyun  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20*4882a593Smuzhiyun  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21*4882a593Smuzhiyun  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22*4882a593Smuzhiyun  * SOFTWARE.
23*4882a593Smuzhiyun  */
24*4882a593Smuzhiyun 
25*4882a593Smuzhiyun /* Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
26*4882a593Smuzhiyun  * Use of this source code is governed by a BSD-style license that can be
27*4882a593Smuzhiyun  * found in the LICENSE file.
28*4882a593Smuzhiyun  */
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun /*
31*4882a593Smuzhiyun #ifdef AVB_INSIDE_LIBAVB_H
32*4882a593Smuzhiyun #error "You can't include avb_rsa.h in the public header libavb.h."
33*4882a593Smuzhiyun #endif
34*4882a593Smuzhiyun */
35*4882a593Smuzhiyun 
36*4882a593Smuzhiyun /*
37*4882a593Smuzhiyun #ifndef AVB_COMPILATION
38*4882a593Smuzhiyun #error "Never include this file, it may only be used from internal avb code."
39*4882a593Smuzhiyun #endif
40*4882a593Smuzhiyun */
41*4882a593Smuzhiyun 
42*4882a593Smuzhiyun #ifndef AVB_RSA_H_
43*4882a593Smuzhiyun #define AVB_RSA_H_
44*4882a593Smuzhiyun 
45*4882a593Smuzhiyun #ifdef __cplusplus
46*4882a593Smuzhiyun extern "C" {
47*4882a593Smuzhiyun #endif
48*4882a593Smuzhiyun 
49*4882a593Smuzhiyun #include <android_avb/avb_crypto.h>
50*4882a593Smuzhiyun #include <android_avb/avb_sysdeps.h>
51*4882a593Smuzhiyun 
52*4882a593Smuzhiyun /* Using the key given by |key|, verify a RSA signature |sig| of
53*4882a593Smuzhiyun  * length |sig_num_bytes| against an expected |hash| of length
54*4882a593Smuzhiyun  * |hash_num_bytes|. The padding to expect must be passed in using
55*4882a593Smuzhiyun  * |padding| of length |padding_num_bytes|.
56*4882a593Smuzhiyun  *
57*4882a593Smuzhiyun  * The data in |key| must match the format defined in
58*4882a593Smuzhiyun  * |AvbRSAPublicKeyHeader|, including the two large numbers
59*4882a593Smuzhiyun  * following. The |key_num_bytes| must be the size of the entire
60*4882a593Smuzhiyun  * serialized key.
61*4882a593Smuzhiyun  *
62*4882a593Smuzhiyun  * Returns false if verification fails, true otherwise.
63*4882a593Smuzhiyun  */
64*4882a593Smuzhiyun bool avb_rsa_verify(const uint8_t* key,
65*4882a593Smuzhiyun                     size_t key_num_bytes,
66*4882a593Smuzhiyun                     const uint8_t* sig,
67*4882a593Smuzhiyun                     size_t sig_num_bytes,
68*4882a593Smuzhiyun                     const uint8_t* hash,
69*4882a593Smuzhiyun                     size_t hash_num_bytes,
70*4882a593Smuzhiyun                     const uint8_t* padding,
71*4882a593Smuzhiyun                     size_t padding_num_bytes) AVB_ATTR_WARN_UNUSED_RESULT;
72*4882a593Smuzhiyun 
73*4882a593Smuzhiyun #ifdef __cplusplus
74*4882a593Smuzhiyun }
75*4882a593Smuzhiyun #endif
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun #endif /* AVB_RSA_H_ */
78