]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/libsystemd/sd-journal/fsprg.h
d3d88aab31a05b127218a73e9ed54c4269596c8a
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
5 * fsprg v0.1 - (seekable) forward-secure pseudorandom generator
6 * Copyright © 2012 B. Poettering
7 * Contact: fsprg@point-at-infinity.org
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
26 #include <sys/types.h>
34 #define FSPRG_RECOMMENDED_SECPAR 1536
35 #define FSPRG_RECOMMENDED_SEEDLEN (96/8)
37 size_t FSPRG_mskinbytes(unsigned secpar
) _const_
;
38 size_t FSPRG_mpkinbytes(unsigned secpar
) _const_
;
39 size_t FSPRG_stateinbytes(unsigned secpar
) _const_
;
41 /* Setup msk and mpk. Providing seed != NULL makes this algorithm deterministic. */
42 void FSPRG_GenMK(void *msk
, void *mpk
, const void *seed
, size_t seedlen
, unsigned secpar
);
44 /* Initialize state deterministically in dependence on seed. */
45 /* Note: in case one wants to run only one GenState0 per GenMK it is safe to use
46 the same seed for both GenMK and GenState0.
48 void FSPRG_GenState0(void *state
, const void *mpk
, const void *seed
, size_t seedlen
);
50 void FSPRG_Evolve(void *state
);
52 uint64_t FSPRG_GetEpoch(const void *state
) _pure_
;
54 /* Seek to any arbitrary state (by providing msk together with seed from GenState0). */
55 void FSPRG_Seek(void *state
, uint64_t epoch
, const void *msk
, const void *seed
, size_t seedlen
);
57 void FSPRG_GetKey(const void *state
, void *key
, size_t keylen
, uint32_t idx
);