aboutsummaryrefslogtreecommitdiffstats
path: root/libaxl_generate_id.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-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)