From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

DAGOLDEN / UUID-URandom-0.001 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

              
NAME
    UUID::URandom - UUIDs based on /dev/urandom or the Windows Crypto API
VERSION
    version 0.001
SYNOPSIS
        use UUID::URandom qw/create_uuid/;
        my $uuid = create_uuid();
DESCRIPTION
    This module provides a portable, secure generator of RFC-4122
    <https://tools.ietf.org/html/rfc4122> version 4 (random) UUIDs. It is a
    thin wrapper around Crypt::URandom to set the UUID version and variant
    bits required by the RFC.
USAGE
    No functions are exported by default.
FUNCTIONS
  create_uuid
        my $uuid = create_uuid();
        # "\x95\x5a\xe4\x96\x8b\xb2\x45\x0b\x9c\x7e\x99\xf5\x01\xdf\x90\xfe"
    This returns a new UUID as a 16 byte 'binary' string.
  create_uuid_hex
        my $uuid = create_uuid_hex();
        # "955ae4968bb2450b9c7e99f501df90fe"
    This returns a new UUID as a 32-byte hexadecimal string.
  create_uuid_string
        my $uuid = create_uuid_string();
        # "955ae496-8bb2-450b-9c7e-99f501df90fe"
    This returns a new UUID in the 36-byte RFC-4122 canonical string
    representation. (N.B. The canonical representation is lower-case.)
FORK AND THREAD SAFETY
    The underlying Crypt::URandom is believed to be fork and thread safe.
SEE ALSO
    There are a number of other modules that provide version 4 UUIDs. Many
    rely on insecure or non-crypto-strength random number generators.
    *   Data::GUID::Any
    *   Data::UUID::LibUUID
    *   UUID
    *   UUID::Tiny
    *   Data::UUID::MT
SUPPORT
  Bugs / Feature Requests
    Please report any bugs or feature requests through the issue tracker at
    <https://github.com/dagolden/UUID-URandom/issues>. You will be notified
    automatically of any progress on your issue.
  Source Code
    This is open source software. The code repository is available for
    public review and contribution under the terms of the license.
    <https://github.com/dagolden/UUID-URandom>
      git clone https://github.com/dagolden/UUID-URandom.git
AUTHOR
    David Golden <dagolden@cpan.org>
COPYRIGHT AND LICENSE
    This software is Copyright (c) 2018 by David Golden.
    This is free software, licensed under:
      The Apache License, Version 2.0, January 2004