Skip to contentSkip to conversation

initial getrandom wrapper to provide getentropy for LibreSSL

RFC PATCH In review Brent Cook 2 participants 4 messages Jul 18, 2014

lore
Share & tools
lore

Brent Cook

author
#0 lore raw

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
index c16b289..b717d91 100644
@@ -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
author
#1 lore raw
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
index c16b289..b717d91 100644
@@ -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
#2 lore raw
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

author
#3 lore raw
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.

http://lists.openwall.net/linux-kernel/2014/07/18/329

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