aboutsummaryrefslogtreecommitdiffstats
path: root/libaxl_generate_id.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2020-05-10 13:44:06 +0200
committerMattias Andrée <maandree@kth.se>2020-05-10 13:44:06 +0200
commit4a968d807d2ec611f443d704ae875911894c04e2 (patch)
treea7c1d4f178842bb6971c7a4b2c159049df794dd0 /libaxl_generate_id.3
parentFix struct for ClientMessage event (diff)
downloadlibaxl-4a968d807d2ec611f443d704ae875911894c04e2.tar.gz
libaxl-4a968d807d2ec611f443d704ae875911894c04e2.tar.bz2
libaxl-4a968d807d2ec611f443d704ae875911894c04e2.tar.xz
A few things
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'libaxl_generate_id.3')
-rw-r--r--libaxl_generate_id.338
1 files changed, 38 insertions, 0 deletions
diff --git a/libaxl_generate_id.3 b/libaxl_generate_id.3
new file mode 100644
index 0000000..aa055f1
--- /dev/null
+++ b/libaxl_generate_id.3
@@ -0,0 +1,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)