aboutsummaryrefslogtreecommitdiffstats
path: root/man3/libaxl_generate_id.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2020-06-21 12:09:51 +0200
committerMattias Andrée <maandree@kth.se>2020-06-21 12:09:51 +0200
commit0007c3f8d17fb4b397d6d4e42b10f2ceee5b0d6a (patch)
tree73cc9f3704a934d05e8086fad9e6d906b7871131 /man3/libaxl_generate_id.3
parentImplement & format token in libaxl_receive (diff)
downloadlibaxl-0007c3f8d17fb4b397d6d4e42b10f2ceee5b0d6a.tar.gz
libaxl-0007c3f8d17fb4b397d6d4e42b10f2ceee5b0d6a.tar.bz2
libaxl-0007c3f8d17fb4b397d6d4e42b10f2ceee5b0d6a.tar.xz
Move man pages into a separate directory
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man3/libaxl_generate_id.3')
-rw-r--r--man3/libaxl_generate_id.338
1 files changed, 38 insertions, 0 deletions
diff --git a/man3/libaxl_generate_id.3 b/man3/libaxl_generate_id.3
new file mode 100644
index 0000000..aa055f1
--- /dev/null
+++ b/man3/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)