1 /* Substitute for <sys/random.h>.
2 Copyright (C) 2020-2022 Free Software Foundation, Inc.
4 This file is free software: you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as
6 published by the Free Software Foundation; either version 2.1 of the
7 License, or (at your option) any later version.
9 This file is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU Lesser General Public License for more details.
14 You should have received a copy of the GNU Lesser General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
18 @PRAGMA_SYSTEM_HEADER@
22 #ifndef _@GUARD_PREFIX@_SYS_RANDOM_H
24 #if @HAVE_SYS_RANDOM_H@
26 /* On uClibc < 1.0.35, <sys/random.h> assumes prior inclusion of <stddef.h>.
27 Do not use __UCLIBC__ here, as it might not be defined yet.
28 But avoid namespace pollution on glibc systems. */
32 /* On Mac OS X 10.5, <sys/random.h> assumes prior inclusion of <sys/types.h>.
33 On Max OS X 10.13, <sys/random.h> assumes prior inclusion of a file that
34 includes <Availability.h>, such as <stdlib.h> or <unistd.h>. */
35 # if defined __APPLE__ && defined __MACH__ /* Mac OS X */
36 # include <sys/types.h>
40 /* The include_next requires a split double-inclusion guard. */
41 # @INCLUDE_NEXT@ @NEXT_SYS_RANDOM_H@
45 #ifndef _@GUARD_PREFIX@_SYS_RANDOM_H
46 #define _@GUARD_PREFIX@_SYS_RANDOM_H
48 #include <sys/types.h>
50 /* Define the GRND_* constants. */
52 # define GRND_NONBLOCK 1
53 # define GRND_RANDOM 2
56 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
58 /* The definition of _GL_ARG_NONNULL is copied here. */
60 /* The definition of _GL_WARN_ON_USE is copied here. */
63 /* Declare overridden functions. */
66 #if @GNULIB_GETRANDOM@
67 /* Fill a buffer with random bytes. */
68 # if @REPLACE_GETRANDOM@
69 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
71 # define getrandom rpl_getrandom
73 _GL_FUNCDECL_RPL (getrandom
, ssize_t
,
74 (void *buffer
, size_t length
, unsigned int flags
)
75 _GL_ARG_NONNULL ((1)));
76 _GL_CXXALIAS_RPL (getrandom
, ssize_t
,
77 (void *buffer
, size_t length
, unsigned int flags
));
79 # if !@HAVE_GETRANDOM@
80 _GL_FUNCDECL_SYS (getrandom
, ssize_t
,
81 (void *buffer
, size_t length
, unsigned int flags
)
82 _GL_ARG_NONNULL ((1)));
84 _GL_CXXALIAS_SYS (getrandom
, ssize_t
,
85 (void *buffer
, size_t length
, unsigned int flags
));
87 _GL_CXXALIASWARN (getrandom
);
88 #elif defined GNULIB_POSIXCHECK
90 # if HAVE_RAW_DECL_GETRANDOM
91 _GL_WARN_ON_USE (getrandom
, "getrandom is unportable - "
92 "use gnulib module getrandom for portability");
97 #endif /* _@GUARD_PREFIX@_SYS_RANDOM_H */
98 #endif /* _@GUARD_PREFIX@_SYS_RANDOM_H */