libar2_init.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

.TH LIBAR2_INIT 3 LIBAR2
.SH NAME
libar2_init - Initialise libar2

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

void libar2_init(void);
.fi
.PP
Link with
.IR -lar2 .

.SH DESCRIPTION
The
.BR libar2_init ()
function initialises the library. Specifically
it selects which versions of different functions
the library shall use, based on the capabilities
of the machine that executes the function.
.PP
The
.BR libar2_init ()
function is called automatically by the
.BR libar2_hash (3)
function, but it is desirable, but not necessary,
for multi-threaded applications to call it manually.
Additionally, depending on the capabilities of the
compiler and linker that was used to create the
library, the
.BR libar2_init ()
function may be called automatically at load-time.

.SH RETURN VALUES
None.

.SH ERRORS
The
.BR libar2_init ()
function cannot fail.

.SH SEE ALSO
.BR libar2 (7),
.BR libar2_hash (3)