aboutsummaryrefslogtreecommitdiffstats
path: root/libaxl_generate_id.3
blob: aa055f1aed6ad49eb3d6a7543728365f96efb437 (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
.TH libaxl_generate_id 3 libaxl
.SH NAME
libaxl_generate_id - Generate a resource ID
.SH SYNOPSIS
.nf
#include <libaxl.h>

libaxl_id_t libaxl_generate_id(LIBAXL_CONTEXT *\fIctx\fP);
.fi
.SH DESCRIPTION
The
.BR libaxl_generate_id ()
function returns an X resource ID that
the client can assign to any resource
created for the connection for which
the object in the
.I ctx
parameter, which the function assumes is
.RI non- NULL ,
 is created for.
.SH RETURN VALUE
The
.BR libaxl_generate_id ()
function returns an unused resource ID
allocated to the connection to the
display server, or 0 on failure.
.SH ERRORS
The
.BR libaxl_generate_id ()
function can only fail if there are no
more resource IDs allocated to the
connection, which corresponds to the
.I LIBAXL_ERROR_OUT_OF_RESOURCE_IDS
error number.
.SH NOTES
None.
.SH SEE ALSO
.BR libaxl_deallocate_id (3)