1UUID::URandom(3)      User Contributed Perl Documentation     UUID::URandom(3)
2
3
4

NAME

6       UUID::URandom - UUIDs based on /dev/urandom or the Windows Crypto API
7

VERSION

9       version 0.001
10

SYNOPSIS

12           use UUID::URandom qw/create_uuid/;
13
14           my $uuid = create_uuid();
15

DESCRIPTION

17       This module provides a portable, secure generator of RFC-4122
18       <https://tools.ietf.org/html/rfc4122> version 4 (random) UUIDs.  It is
19       a thin wrapper around Crypt::URandom to set the UUID version and
20       variant bits required by the RFC.
21

USAGE

23       No functions are exported by default.
24

FUNCTIONS

26   create_uuid
27           my $uuid = create_uuid();
28
29           # "\x95\x5a\xe4\x96\x8b\xb2\x45\x0b\x9c\x7e\x99\xf5\x01\xdf\x90\xfe"
30
31       This returns a new UUID as a 16 byte 'binary' string.
32
33   create_uuid_hex
34           my $uuid = create_uuid_hex();
35
36           # "955ae4968bb2450b9c7e99f501df90fe"
37
38       This returns a new UUID as a 32-byte hexadecimal string.
39
40   create_uuid_string
41           my $uuid = create_uuid_string();
42
43           # "955ae496-8bb2-450b-9c7e-99f501df90fe"
44
45       This returns a new UUID in the 36-byte RFC-4122 canonical string
46       representation.  (N.B. The canonical representation is lower-case.)
47

FORK AND THREAD SAFETY

49       The underlying Crypt::URandom is believed to be fork and thread safe.
50

SEE ALSO

52       There are a number of other modules that provide version 4 UUIDs.  Many
53       rely on insecure or non-crypto-strength random number generators.
54
55       •   Data::GUID::Any
56
57       •   Data::UUID::LibUUID
58
59       •   UUID
60
61       •   UUID::Tiny
62
63       •   Data::UUID::MT
64

SUPPORT

66   Bugs / Feature Requests
67       Please report any bugs or feature requests through the issue tracker at
68       <https://github.com/dagolden/UUID-URandom/issues>.  You will be
69       notified automatically of any progress on your issue.
70
71   Source Code
72       This is open source software.  The code repository is available for
73       public review and contribution under the terms of the license.
74
75       <https://github.com/dagolden/UUID-URandom>
76
77         git clone https://github.com/dagolden/UUID-URandom.git
78

AUTHOR

80       David Golden <dagolden@cpan.org>
81

83       This software is Copyright (c) 2018 by David Golden.
84
85       This is free software, licensed under:
86
87         The Apache License, Version 2.0, January 2004
88
89
90
91perl v5.38.0                      2023-07-21                  UUID::URandom(3)
Impressum