Debian Codegraph @

src/fido/credman.h

raw
1 /*
2 * Copyright (c) 2019-2021 Yubico AB. All rights reserved.
3 * SPDX-License-Identifier: BSD-2-Clause
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met:
8 *
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in
13 * the documentation and/or other materials provided with the
14 * distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29 #ifndef _FIDO_CREDMAN_H
30 #define _FIDO_CREDMAN_H
31
32 #include <stdint.h>
33 #include <stdlib.h>
34
35 #ifdef _FIDO_INTERNAL
36 #include "blob.h"
37 #include "fido/err.h"
38 #include "fido/param.h"
39 #include "fido/types.h"
40 #else
41 #include <fido.h>
42 #include <fido/err.h>
43 #include <fido/param.h>
44 #endif
45
46 #ifdef __cplusplus
47 extern "C" {
48 #endif /* __cplusplus */
49
50 #ifdef _FIDO_INTERNAL
51 struct fido_credman_metadata {
52 uint64_t rk_existing;
53 uint64_t rk_remaining;
54 };
55
56 struct fido_credman_single_rp {
57 fido_rp_t rp_entity;
58 fido_blob_t rp_id_hash;
59 };
60
61 struct fido_credman_rp {
62 struct fido_credman_single_rp *ptr;
63 size_t n_alloc; /* number of allocated entries */
64 size_t n_rx; /* number of populated entries */
65 };
66
67 struct fido_credman_rk {
68 fido_cred_t *ptr;
69 size_t n_alloc; /* number of allocated entries */
70 size_t n_rx; /* number of populated entries */
71 };
72 #endif
73
74 typedef struct fido_credman_metadata fido_credman_metadata_t;
75 typedef struct fido_credman_rk fido_credman_rk_t;
76 typedef struct fido_credman_rp fido_credman_rp_t;
77
78 const char *fido_credman_rp_id(const fido_credman_rp_t *, size_t);
79 const char *fido_credman_rp_name(const fido_credman_rp_t *, size_t);
80
81 const fido_cred_t *fido_credman_rk(const fido_credman_rk_t *, size_t);
82 const unsigned char *fido_credman_rp_id_hash_ptr(const fido_credman_rp_t *,
83 size_t);
84
85 fido_credman_metadata_t *fido_credman_metadata_new(void);
86 fido_credman_rk_t *fido_credman_rk_new(void);
87 fido_credman_rp_t *fido_credman_rp_new(void);
88
89 int fido_credman_del_dev_rk(fido_dev_t *, const unsigned char *, size_t,
90 const char *);
91 int fido_credman_get_dev_metadata(fido_dev_t *, fido_credman_metadata_t *,
92 const char *);
93 int fido_credman_get_dev_rk(fido_dev_t *, const char *, fido_credman_rk_t *,
94 const char *);
95 int fido_credman_get_dev_rp(fido_dev_t *, fido_credman_rp_t *, const char *);
96 int fido_credman_set_dev_rk(fido_dev_t *, fido_cred_t *, const char *);
97
98 size_t fido_credman_rk_count(const fido_credman_rk_t *);
99 size_t fido_credman_rp_count(const fido_credman_rp_t *);
100 size_t fido_credman_rp_id_hash_len(const fido_credman_rp_t *, size_t);
101
102 uint64_t fido_credman_rk_existing(const fido_credman_metadata_t *);
103 uint64_t fido_credman_rk_remaining(const fido_credman_metadata_t *);
104
105 void fido_credman_metadata_free(fido_credman_metadata_t **);
106 void fido_credman_rk_free(fido_credman_rk_t **);
107 void fido_credman_rp_free(fido_credman_rp_t **);
108
109 #ifdef __cplusplus
110 } /* extern "C" */
111 #endif /* __cplusplus */
112
113 #endif /* !_FIDO_CREDMAN_H */