initial getrandom wrapper to provide getentropy for LibreSSL
RFC PATCH 1/1 initial getrandom wrapper to provide getentropy for LibreSSL
From: Brent Cook <[email protected]>
This is not a kernel patch, but rather an initial test of the API to see how it might mesh LibreSSL's expectations for how getentropy works.
It is a bit more code to carefully handle the extra return values, as not reading enough bytes, because there is an unhandled EINTR, might lead to an unseeded CSPRNG.
The syscall may return EAGAIN depending on the version of getrandom(2) (this will go away later), but this should give a good example of what its use would look like in practice.
--- src/lib/libcrypto/crypto/getentropy_linux.c | 42 ++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-)
src/lib/libcrypto/crypto/getentropy_linux.c +41 -1
@@ -1,4 +1,4 @@ -/* $OpenBSD: getentropy_linux.c,v 1.24 2014/07/13 13:37:38 deraadt Exp $ */ +/* $OpenBSD: getentropy_linux.c,v 1.25 2014/07/16 14:26:47 kettenis Exp $ */ /* * Copyright (c) 2014 Theo de Raadt <[email protected]>
@@ -73,10 +73,21 @@int getentropy (void *buf,size_t len); +#ifndef SYS__getrandom +#ifdef __LP64__ +#define SYS__getrandom 317 +#else +#define SYS__getrandom 354 +#endif +#endif +#if 0 extern int main (int ,char *argv[]);#endif static int gotdata (char *buf,size_t len); +#ifdef SYS__getrandom +static int getentropy_getrandom (void *buf,size_t len); +#endif static int getentropy_urandom (void *buf,size_t len);#ifdef CTL_MAXNAME static int getentropy_sysctl (void *buf,size_t len);
@@ -95,6 +106,13 @@ getentropy(void *buf, size_t len) }/* +* Brand new system call in Linux. Interface not yet settled. +*/ + ret =getentropy_getrandom (buf, len); +if (ret !=-1 ) +return (ret); + +/* * Try to get entropy with /dev/urandom * * This can fail if the process is inside a chroot or if file
@@ -180,6 +198,28 @@ gotdata(char *buf, size_t len) }static int +getentropy_getrandom (void *buf,size_t len) +{ +size_t i =0 ; + +#ifdef SYS__getrandom +ssize_t ret; + +for (i =0 ; i < len; ) { +size_t wanted = len - i; + ret =syscall (SYS__getrandom, (char *)buf + i, wanted,0 ); +if (ret ==-1 ) { +if (errno ==EAGAIN || errno ==EINTR ) +continue ; +return (-1 ); + } + i += ret; + } +#endif +return (i == len ?0 :-1 ); +} + +static int getentropy_urandom (void *buf,size_t len) {struct stat st;
Signature · 1 line
2.0.1
Quoted 5 lines · Brent Cook
From: Brent Cook <[email protected]>
This is not a kernel patch, but rather an initial test of the API to see how it might mesh LibreSSL's expectations for how getentropy works.
Quoted 7 lines
It is a bit more code to carefully handle the extra return values, as not reading enough bytes, because there is an unhandled EINTR, might lead to an unseeded CSPRNG.
The syscall may return EAGAIN depending on the version of getrandom(2) (this will go away later), but this should give a good example of what its use would look like in practice.
While I think we can wrap the currently-proposed getrandom() interface to provide a safe emulation of getentropy()’s semantics, I would not be surprised to eventually find software that gets it wrong.
I am a little concerned that the interface is evolving into a Bradley Fighting Vehicle :)
https://www.youtube.com/watch?v=aXQ2lO3ieBA
Quoted 82 lines
---
src/lib/libcrypto/crypto/getentropy_linux.c| 42 ++++++++++++++++++++++++++++-1 file changed, 41 insertions(+), 1 deletion(-)src/lib/libcrypto/crypto/getentropy_linux.c +19
-1@@ -1,4 +1,4 @@ -/* $OpenBSD: getentropy_linux.c,v 1.24 2014/07/13 13:37:38 deraadt Exp $ */ +/* $OpenBSD: getentropy_linux.c,v 1.25 2014/07/16 14:26:47 kettenis Exp $ */ /* * Copyright (c) 2014 Theo de Raadt <[email protected]> @@ -73,10 +73,21 @@int getentropy (void *buf,size_t len); +#ifndef SYS__getrandom +#ifdef __LP64__ +#define SYS__getrandom 317 +#else +#define SYS__getrandom 354 +#endif +#endif +#if 0 extern int main (int ,char *argv[]);#endif static int gotdata (char *buf,size_t len); +#ifdef SYS__getrandom +static int getentropy_getrandom (void *buf,size_t len); +#endif static int getentropy_urandom (void *buf,size_t len);#ifdef CTL_MAXNAME static int getentropy_sysctl (void *buf,size_t len);@@ -95,6 +106,13 @@ getentropy(void *buf, size_t len) }/* +* Brand new system call in Linux. Interface not yet settled. +*/ + ret =getentropy_getrandom (buf, len); +if (ret !=-1 ) +return (ret); + +/* * Try to get entropy with /dev/urandom * * This can fail if the process is inside a chroot or if file @@ -180,6 +198,28 @@ gotdata(char *buf, size_t len) }static int
src/lib/libcrypto/crypto/getentropy_linux.c +22
-0+getentropy_getrandom(void *buf, size_t len) +{ +size_t i =0 ; + +#ifdef SYS__getrandom +ssize_t ret; + +for (i =0 ; i < len; ) { +size_t wanted = len - i; + ret =syscall (SYS__getrandom, (char *)buf + i, wanted,0 ); +if (ret ==-1 ) { +if (errno ==EAGAIN || errno ==EINTR ) +continue ; +return (-1 ); + } + i += ret; + } +#endif +return (i == len ?0 :-1 ); +} + +static int
getentropy_urandom(void *buf, size_t len){ struct stat st;Signature · 1 line
2.0.1
Quoted 10 lines · Brent Cook
Quoted 8 lines · Brent Cook
From: Brent Cook <[email protected]>
This is not a kernel patch, but rather an initial test of the API to see how it might mesh LibreSSL's expectations for how getentropy works.
It is a bit more code to carefully handle the extra return values, as not reading enough bytes, because there is an unhandled EINTR, might lead to an unseeded CSPRNG.
Take a look at the latest patch for getrandom. It contains a suggested wrapper which should be sufficient for emulation of OpenBSD's getentropy(), and a lot of discussion of when you don't need to worry about getting the EINTR.
http://lists.openwall.net/linux-kernel/2014/07/18/329
Again, please don't commit anything until the syscall number and interface is finalized. What is out here is for review, and I already have in the git commit a suggested wrapper to provide getentropy(2). If you don't think it's good enough, please let me know what your concerns might be. (And yes, I've fixed the obvious missing open brace already. :-)
- Ted
Quoted 19 lines · Theodore Ts'o
Quoted 10 lines · Brent Cook
Quoted 8 lines · Brent Cook
From: Brent Cook <[email protected]>
This is not a kernel patch, but rather an initial test of the API to see how it might mesh LibreSSL's expectations for how getentropy works.
It is a bit more code to carefully handle the extra return values, as not reading enough bytes, because there is an unhandled EINTR, might lead to an unseeded CSPRNG.
Take a look at the latest patch for getrandom. It contains a suggested wrapper which should be sufficient for emulation of OpenBSD's
getentropy(), and a lot of discussion of when you don't need to worry about getting the EINTR.
Quoted 8 lines
Again, please don't commit anything until the syscall number and interface is finalized. What is out here is for review, and I already have in the git commit a suggested wrapper to provide getentropy(2). If you don't think it's good enough, please let me know what your concerns might be. (And yes, I've fixed the obvious missing open brace already. :-)
- Ted
Ah, that looks good to me.
I had just stubbed in the placeholder numbers for local testing purposes, no problem holding until it is finalized.
Thanks!
- Brent