summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKaleb Keithley <kaleb@freedesktop.org>2003-11-25 19:28:09 +0000
committerKaleb Keithley <kaleb@freedesktop.org>2003-11-25 19:28:09 +0000
commit345fbee57dc02964c90e8e232cb9274860276d27 (patch)
treec8ee21ea6f3c2738b8934517afa24c4b41e6744c
parent8379290050be8b8fcbdcc74e11cebbc637ff96ba (diff)
downloadxorg-lib-libXRes-345fbee57dc02964c90e8e232cb9274860276d27.tar.gz
Initial revisionXORG-STABLE
-rw-r--r--man/XRes.man139
1 files changed, 139 insertions, 0 deletions
diff --git a/man/XRes.man b/man/XRes.man
new file mode 100644
index 0000000..5bba729
--- /dev/null
+++ b/man/XRes.man
@@ -0,0 +1,139 @@
+.\"
+.\" $XFree86: xc/lib/XRes/XRes.man,v 1.2 2003/10/13 21:22:54 herrb Exp $
+.\"
+.\" Copyright (C) 1994-2003 The XFree86 Project, Inc. All Rights Reserved.
+.\"
+.\" Permission is hereby granted, free of charge, to any person obtaining
+.\" a copy of this software and associated documentation files (the
+.\" "Software"), to deal in the Software without restriction, including
+.\" without limitation the rights to use, copy, modify, merge, publish,
+.\" distribute, sublicense, and/or sell copies of the Software, and to
+.\" permit persons to whom the Software is furnished to do so, subject to
+.\" the following conditions:
+.\"
+.\" The above copyright notice and this permission notice shall be
+.\" included in all copies or substantial portions of the Software.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+.\" IN NO EVENT SHALL THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES
+.\" OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+.\"
+.\" Except as contained in this notice, the name of the XFree86 Project
+.\" shall not be used in advertising or otherwise to promote the sale, use
+.\" or other dealings in this Software without prior written authorization
+.\" from the XFree86 Project.
+.\"
+.TH XRes 3 __vendorversion__
+.SH NAME
+XRes \- X-Resource extension client library
+.SH SYNOPSIS
+.B #include <X11/extension/XRres.h>
+.PP
+.nf
+.ta .5i 2i
+typedef struct {
+ XID resource_base;
+ XID resource_mask;
+} XResClient;
+
+typedef struct {
+ Atom resource_type;
+ unsigned int count;
+} XResType;
+.fi
+.HP
+Bool XResQueryExtension(Display *\fIdpy\fP,
+int *\fIevent_basep\fP, int *\fIerror_basep\fP\^);
+.HP
+Status XResQueryVersion(Display *\fIdpy\fP, int *\fImajor_versionp\fP,
+int *\fIminor_versionp\fP\^);
+.HP
+Status XResQueryClients(Display *\fIdpy\fP, int *\fInum_clients\fP,
+XResClient **\fIclients\fP\^);
+.HP
+Status XResQueryClientResources(Display *\fIdpy\fP, XID \fIxid\fP,
+int *\fInum_types\fP, XResType **\fItypes\fP\^);
+.HP
+Status XResQueryClientPixmapBytes(Display *\fIdpy\fP, XID \fIxid\fP,
+unsigned long *\fIbytes\fP\^);
+.PP
+.SH DESCRIPTION
+.B X-Resource
+is an extension that allows a client to query the X
+server about its usage of various resources. It should not be mixed
+with the X resource database access functions.
+.PP
+.B XResQueryExtension
+returns
+.B True
+if the
+.I XRes
+extension is available on the given display.
+A client must call
+.B XResQueryExtension
+before calling any other XRes function in order
+to negotiate a compatible protocol version; otherwise the client will
+get undefined behavior (XRes may or may not work).
+.PP
+.B XResQueryVersion
+returns
+.B True
+if the request succeeded; the values of the major and minor protocol
+versions supported by the server are returned in
+.I major_versionp
+and
+.I minor_versionp .
+.PP
+.PP
+.B XResQueryClients
+fills a list of clients of the given display. For each client it
+returns in the
+.I XResClient
+structure a mask and a base value of the resources used by these
+clients.
+Returns
+.B True
+on success or
+.B False
+on failure.
+.PP
+.B XResQueryClientResources
+fills a list of
+XResType
+structures, indicating for each resource type allocated by the client its
+name (as an Atom) and the number of resources of this type allocated.
+Returns
+.B True
+on success or
+.B False
+on failure.
+.PP
+.B XresQueryClientPixmapBytes
+gives, for resources of type
+.I PIXMAP
+the total number of bytes allocated in the X server by the given
+client.
+Returns
+.B True
+on success or
+.B False
+on failure.
+.SH "ERRORS"
+.B XResQueryClientResources
+and
+.B XResQueryClientPixmapBytes
+will return
+.I BadValue
+if passed an illegal client identifier.
+.SH "SEE ALSO"
+Xlib(1), X(7)
+.SH AUTHOR
+Mark Vojkovich, for The XFree86 Project Inc.
+.SH STABILITY
+This API is considered as experimental. The XRes library major
+revision may be incremented whenever incompatible changes are done to
+the API without notice. Use with care.