Docs/defensive-coding-guide
2
0
Fork 0
Code Issues 3 Pull requests 1 Projects Releases Packages Wiki Activity Actions

getrandom: documented addition to glibc

Browse source
This commit is contained in:
Nikos Mavrogiannopoulos 2017-03-29 15:18:57 +02:00
parent 0b6f28ab9a
commit 15fcf5de6b
1 changed files with 4 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
en-US/Tasks-Cryptography.xml
View file

@ -86,7 +86,7 @@
<para><function>os.urandom</function> in Python</para>
</listitem>
<listitem>
<para>The <function>getrandom</function> system call</para>
<para>The <function>getrandom</function> system call since glibc 2.25</para>
</listitem>
<listitem>
<para>The <function>getentropy</function> call since glibc 2.25</para>
@ -122,10 +122,10 @@
return values, hence requires careful error checking.
</para>
<para>
It was introduced in Linux kernel 3.17, but as of glibc 2.22 no API wrappers are
provided. As such one can only use it via the syscall interface
It was introduced in Linux kernel 3.17, but before glibc 2.25 no API wrappers were
provided. As such one could only use it via the syscall interface
as <function>syscall(SYS_getrandom, (void*)dest, (size_t)size, (unsigned int)0)</function>.
For portable code targetting older kernel versions one has to check
For portable code targetting multiple kernel versions one has to check
for the function being available on run-time, and switch to another
facility if the running kernel doesn't support this call.
</para>