libar2_version_to_string_proper.3


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

.TH LIBAR2_VERSION_TO_STRING_PROPER 3 LIBAR2
.SH NAME
libar2_version_to_string_proper - Convert an Argon2 version number to a string with a dot

.SH SYNOPSIS
.nf
#include <libar2.h>

enum libar2_argon2_version {
    LIBAR2_ARGON2_VERSION_10 = 0x10,
    LIBAR2_ARGON2_VERSION_13 = 0x13
};

const char *libar2_version_to_string_proper(enum libar2_argon2_version \fIversion\fP);
.fi
.PP
Link with
.IR -lar2 .

.SH DESCRIPTION
The
.BR libar2_version_to_string_proper ()
function returns a statically allocated string that
represents the value of the
.I version
parameter, which shall represent a version of the
Argon2 family. The returned string will contain
a dot
.RB ( . );
for example \(dq1.3\(dq for
.IR LIBAR2_ARGON2_VERSION_13 .

.SH RETURN VALUES
The
.BR libar2_version_to_string_proper ()
function returns a statically allocated string
as described in the
.B DESCRIPTION
section upon successful completion. On error,
.I NULL
is returned and
.I errno
is set to describe the error.

.SH ERRORS
The
.BR libar2_version_to_string_proper ()
function will fail if:
.TP
.B EINVAL
.I version
is not a supported version of Argon2.

.SH SEE ALSO
.BR libar2 (7),
.BR libar2_version_to_string (3),
.BR libar2_string_to_version (3),
.BR libar2_latest_argon2_version (3)