aboutsummaryrefslogtreecommitdiffstats
path: root/libaxl_deallocate_id.3
blob: a7e7ddebc39e0c11c02e2d7f6ec628ac19b81800 (plain) (blame)
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
.TH libaxl_deallocate_id 3 libaxl
.SH NAME
libaxl_deallocate_id - Mark a resource ID as reusable
.SH SYNOPSIS
.nf
#include <libaxl.h>

int libaxl_deallocate_id(LIBAXL_CONTEXT *\fIctx\fP, libaxl_id_t \fIid\fP);
.fi
.SH DESCRIPTION
The
.BR libaxl_deallocate_id ()
function marks that the resource ID
specified in the
.I id
parameter is reusable. The value of the
.I ctx
parameter must be
.RI non- NULL
(the function will assume this to be
the case) and must be created for the
same connection as the ID was generated
for.
.SH RETURN VALUE
The
.BR libaxl_deallocate_id ()
function returns 0 on successful completion
and a negative libaxl error code on failure.
.SH ERRORS
The
.BR libaxl_deallocate_id ()
function may fail if
.TP
.IR LIBAXL_ERROR_SYSTEM " with " ENOMEM
Enough memory could not be allocated to add the
resource ID to the pool of reusable resource IDs.
.SH NOTES
None.
.SH SEE ALSO
.BR libaxl_generate_id (3)