kc3-lang/gnulib/doc/glibc-functions/getrandom.texi

• Show log

  Commit

• Hash : 8f4538a5
  Author :
  Date : 2021-08-14T22:07:33
  

  doc: Update for glibc 2.34.
  
  * doc/posix-functions/timespec_getres.texi: New file.
  * doc/glibc-functions/_Fork.texi: New file.
  * doc/glibc-functions/closefrom.texi: New file.
  * doc/glibc-functions/dn_comp.texi: New file.
  * doc/glibc-functions/dn_skipname.texi: New file.
  * doc/glibc-functions/execveat.texi: New file.
  * doc/glibc-functions/posix_spawn_file_actions_addclosefrom_np.texi: New
  file.
  * doc/glibc-functions/res_dnok.texi: New file.
  * doc/glibc-functions/res_hnok.texi: New file.
  * doc/glibc-functions/res_mailok.texi: New file.
  * doc/glibc-functions/res_nmkquery.texi: New file.
  * doc/glibc-functions/res_nquery.texi: New file.
  * doc/glibc-functions/res_nquerydomain.texi: New file.
  * doc/glibc-functions/res_nsearch.texi: New file.
  * doc/glibc-functions/res_nsend.texi: New file.
  * doc/glibc-functions/res_ownok.texi: New file.
  * doc/glibc-functions/res_send.texi: New file.
  * doc/gnulib.texi: Include them.
  * doc/glibc-functions/inet_neta.texi: Remove file.
  * doc/glibc-functions/malloc_get_state.texi: Remove file.
  * doc/glibc-functions/malloc_set_state.texi: Remove file.
  * doc/glibc-functions/pthread_mutex_consistent_np.texi: Remove file.
  * doc/glibc-functions/pthread_mutexattr_getrobust_np.texi: Remove file.
  * doc/glibc-functions/pthread_mutexattr_setrobust_np.texi: Remove file.
  * doc/glibc-functions/pthread_yield.texi: Remove file.
  * doc/gnulib.texi: Don't include them.
  * doc/glibc-headers/resolv.texi: Update.
  * doc/pastposix-functions/h_errno.texi: Likewise.
  * doc/posix-functions/*.texi: Likewise.
  * doc/glibc-functions/*.texi: Likewise.
  

Download

• doc/glibc-functions/getrandom.texi

• @node getrandom
  @subsection @code{getrandom}
  @findex getrandom
  
  Documentation:
  @itemize
  @item
  @ifinfo
  @ref{Unpredictable Bytes,,Generating Unpredictable Bytes,libc},
  @end ifinfo
  @ifnotinfo
  @url{https://www.gnu.org/software/libc/manual/html_node/Unpredictable-Bytes.html},
  @end ifnotinfo
  @item
  @uref{https://www.kernel.org/doc/man-pages/online/pages/man2/getrandom.2.html,,man getrandom}.
  @end itemize
  
  Gnulib module: getrandom
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function is missing on some platforms:
  glibc 2.24, macOS 11.1, FreeBSD 11.0, NetBSD 9.0, OpenBSD 6.7, Minix 3.3, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.0, Cygwin 1.7.x, mingw, MSVC 14, Android 9.0.
  @item
  This function has a different return type on some platforms:
  Solaris 11.4.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  The @code{GRND_INSECURE} flag is missing on some platforms:
  glibc 2.34, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.7,
  Minix 3.3, Haiku.
  
  @item
  The @code{GRND_RANDOM} flag has different effects on different platforms.
  Some platforms ignore the flag, or yield data that can fail to be
  random in some cases.
  @end itemize
  
  @noindent
  Although this function is intended to produce random data, the data's
  security properties may not be appropriate for your application.
  For example, identical ``random'' data streams might be produced by
  rebooted virtual machines.  If this is of concern you may need to use
  additional techniques such as hedging.@footnote{Ristenpart T, Yilek
  S@. @url{http://pages.cs.wisc.edu/~rist/papers/sslhedge.pdf, When good
  randomness goes bad: virtual machine vulnerabilities and hedging
  deployed cryptography}. NDSS 2010.}
  
  Related modules include @code{getentropy}, which has a simpler but
  more-limited API, and @code{crypto/gc-random}, which is likely a
  better match for code already using the other @code{crypto} APIs.
  

Download