nuttx/libs/libc/misc/lib_getrandom.c
Juha Niskanen 449cf4d076 getrandom: fix comment contradicting code
Signed-off-by: Juha Niskanen <juha.niskanen@haltian.com>
2022-06-15 11:18:04 -03:00

101 lines
3.1 KiB
C

/****************************************************************************
* libs/libc/misc/lib_getrandom.c
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
/****************************************************************************
* Included Files
****************************************************************************/
#include <sys/random.h>
#include <fcntl.h>
#include <unistd.h>
#include <nuttx/fs/fs.h>
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: getrandom
*
* Description:
* Fill a buffer of arbitrary length with randomness. This uses
* either /dev/random (if GRND_RANDOM flag) or /dev/urandom device and
* is therefore susceptible for things like the attacker exhausting file
* descriptors on purpose.
*
* Input Parameters:
* bytes - Buffer for returned random bytes
* nbytes - Number of bytes requested.
* flags - Bit mask that can contain zero or more of the ORed values
* together.
*
* Returned Value:
* On success, getrandom() returns the number of bytes that were copied
* to the buffer bytes. This may be less than the number of bytes
* requested via nbytes if either GRND_RANDOM was specified in flags and
* insufficient entropy was present in the random source or the system
* call was interrupted by a signal.
*
* On error, -1 is returned, and errno is set appropriately.
*
****************************************************************************/
ssize_t getrandom(FAR void *bytes, size_t nbytes, unsigned int flags)
{
int oflags = O_RDONLY;
FAR const char *dev;
int fd;
if ((flags & GRND_NONBLOCK) != 0)
{
oflags |= O_NONBLOCK;
}
if ((flags & GRND_RANDOM) != 0)
{
dev = "/dev/random";
}
else
{
dev = "/dev/urandom";
}
fd = _NX_OPEN(dev, oflags);
if (fd < 0)
{
_NX_SETERRNO(fd);
return fd;
}
nbytes = _NX_READ(fd, bytes, nbytes);
if (nbytes < 0)
{
/* An error occurred on the read. */
_NX_SETERRNO(nbytes);
nbytes = ERROR;
}
_NX_CLOSE(fd);
return nbytes;
}