random.h 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. //
  2. // Copyright 2026 Aarav Ravindra Kharade
  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. /* Interfaces for obtaining random bytes.
  17. Copyright (C) 2016-2026 Free Software Foundation, Inc.
  18. This file is part of the GNU C Library.
  19. The GNU C Library is free software; you can redistribute it and/or
  20. modify it under the terms of the GNU Lesser General Public
  21. License as published by the Free Software Foundation; either
  22. version 2.1 of the License, or (at your option) any later version.
  23. The GNU C Library is distributed in the hope that it will be useful,
  24. but WITHOUT ANY WARRANTY; without even the implied warranty of
  25. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  26. Lesser General Public License for more details.
  27. You should have received a copy of the GNU Lesser General Public
  28. License along with the GNU C Library; if not, see
  29. <https://www.gnu.org/licenses/>. */
  30. #ifndef _SYS_RANDOM_H
  31. #define _SYS_RANDOM_H 1
  32. #include <features.h>
  33. #include <sys/types.h>
  34. /* Flags for use with getrandom. */
  35. #define GRND_NONBLOCK 0x01
  36. #define GRND_RANDOM 0x02
  37. #define GRND_INSECURE 0x04
  38. __BEGIN_DECLS
  39. /* Write LENGTH bytes of randomness starting at BUFFER. Return the
  40. number of bytes written, or -1 on error. */
  41. ssize_t getrandom (void *__buffer, size_t __length,
  42. unsigned int __flags) __wur
  43. __attr_access ((__write_only__, 1, 2));
  44. /* Write LENGTH bytes of randomness starting at BUFFER. Return 0 on
  45. success or -1 on error. */
  46. int getentropy (void *__buffer, size_t __length) __wur
  47. __attr_access ((__write_only__, 1, 2));
  48. __END_DECLS
  49. #endif /* _SYS_RANDOM_H */