NAME
Sys::GetRandom::FFI - get random bytes from the system
VERSION
version v0.1.1
SYNOPSIS
use Sys::GetRandom::FFI qw( getrandom GRND_RANDOM GRND_NONBLOCK );
my $bytes = getrandom( $size, GRND_RANDOM | GRND_NONBLOCK );
if ( defined($bytes) ) {
...
}DESCRIPTION
This is a proof-of-concept module for calling the getrandom(2) system function via FFI::Platypus.
EXPORTS
getrandom
my $bytes = getrandom( $size, $options );This will return a scalar of up to $size bytes, or undef if there was an error.
It may return less than $size bytes if "GRND_RANDOM" was given as an option and there was less entropy or or if the entropy pool has not been initialised, or if it was interrupted by a signal when $size is over 256.
The $options are optional.
GRND_RANDOM
When this bit is set, it will read from /dev/random instead of /dev/urandom.
GRND_NONBLOCK
This will exit with undef when there are no random bytes available.
SEE ALSO
- getrandom(2)
- Sys::GetRandom
-
This is an XS module that calls getrandom(2) directly. It has a slightly different interface but is faster.
- Sys::GetRandom::PP
-
This is a pure-Perl module that makes syscalls to getrandom(2).
- Rand::URandom
-
This is a pure-Perl module that makes syscalls to getrandom(2), but falls back to reading from /dev/urandom.
- Crypt::URandom
-
This is a pure-Perl module that reads data from /dev/urandom. It also uses Win32::API to read random bytes on Windows.
- Random::Simple
-
This is another module that reads data from /dev/urandom or calls getrandom(2).
SUPPORT FOR OLDER PERL VERSIONS
This module requires Perl v5.20 or later.
Future releases may only support Perl versions released in the last ten (10) years.
SOURCE
The development version is on github at https://github.com/robrwo/perl-Sys-GetRandom-FFI and may be cloned from git://github.com/robrwo/perl-Sys-GetRandom-FFI.git
BUGS
Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/perl-Sys-GetRandom-FFI/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Reporting Security Vulnerabilities
Security issues should not be reported on the bugtracker website. Please see SECURITY.md for instructions how to report security vulnerabilities
AUTHOR
Robert Rothenberg <rrwo@cpan.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2024 by Robert Rothenberg <rrwo@cpan.org>.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)