libxext libx11 libxcb libXinerama libXau pixman xserver git update 18/10/2010

10 files changed, 189 insertions, 0 deletions

diff --git a/libXau/man/Makefile.am b/libXau/man/Makefile.am
new file mode 100644
index 000000000..694c376b0
--- /dev/null
+++ b/libXau/man/Makefile.am
@@ -0,0 +1,47 @@
+#

+# Copyright (c) 2010, Oracle and/or its affiliates. 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 (including the next

+# paragraph) 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 NONINFRINGEMENT.  IN NO EVENT SHALL

+# THE AUTHORS OR COPYRIGHT HOLDERS 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.

+#

+

+libmandir = $(LIB_MAN_DIR)

+

+libman_PRE =				\

+	Xau.man				\

+	XauDisposeAuth.man		\

+	XauFileName.man			\

+	XauGetAuthByAddr.man		\

+	XauGetBestAuthByAddr.man	\

+	XauLockAuth.man			\

+	XauReadAuth.man			\

+	XauUnlockAuth.man		\

+	XauWriteAuth.man

+

+libman_DATA = $(libman_PRE:man=$(LIB_MAN_SUFFIX))

+

+EXTRA_DIST = $(libman_PRE)

+

+CLEANFILES = $(libman_DATA)

+

+# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure

+SUFFIXES = .$(LIB_MAN_SUFFIX) .man

+

+.man.$(LIB_MAN_SUFFIX):

+	$(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@

diff --git a/libXau/man/Xau.man b/libXau/man/Xau.man
new file mode 100644
index 000000000..0688f49ef
--- /dev/null
+++ b/libXau/man/Xau.man
@@ -0,0 +1,134 @@
+.\" $Xorg: Xau.man,v 1.3 2000/08/17 19:41:54 cpqbld Exp $

+.\" $XdotOrg$

+.\"

+.\" Copyright (c) 1994  X Consortium

+.\"

+.\" 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 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 NONINFRINGEMENT.  IN NO EVENT SHALL

+.\" THE X CONSORTIUM 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 X Consortium shall not

+.\" be used in advertising or otherwise to promote the sale, use or other

+.\" dealing in this Software without prior written authorization from the

+.\" X Consortium.

+.\"

+.\" $XFree86: xc/doc/man/Xau/Xau.man,v 1.2 2001/01/27 18:20:19 dawes Exp $

+.\"

+.TH Xau __libmansuffix__ __xorgversion__

+.SH NAME

+Xau library: XauFileName, XauReadAuth, XauLockAuth, XauUnlockAuth,

+XauWriteAuth, XauDisposeAuth,

+XauGetAuthByAddr, XauGetBestAuthByAddr \- X authority database routines

+.SH SYNOPSIS

+.B "#include <X11/Xauth.h>"

+.PP

+.nf

+.ta .5i 2i

+typedef struct xauth {

+	unsigned short	family;

+	unsigned short	address_length;

+	char	*address;

+	unsigned short	number_length;

+	char	*number;

+	unsigned short	name_length;

+	char	*name;

+	unsigned short	data_length;

+	char	*data;

+} Xauth;

+

+.HP

+char *XauFileName (void);

+.HP

+Xauth *XauReadAuth (FILE *\fIauth_file\fP\^);

+.HP

+int XauWriteAuth (FILE *\fIauth_file\fP, Xauth *\fIauth\fP\^);

+.HP

+Xauth *XauGetAuthByAddr (unsigned short \fIfamily\fP\^, unsigned short

+\fIaddress_length\fP\^, const char *\fIaddress\fP\^, unsigned short

+\fInumber_length\fP\^, const char *\fInumber\fP\^, unsigned short

+\fIname_length\fP\^, const char *\fIname\fP\^);

+.HP

+Xauth *XauGetBestAuthByAddr (unsigned short \fIfamily\fP\^, unsigned short

+\fIaddress_length\fP\^, const char *\fIaddress\fP\^, unsigned short

+\fInumber_length\fP\^, const char *\fInumber\fP\^, int \fItypes_length\fP\^,

+char **\fItypes\fR\^, const int *\fItype_lengths\fR\^);

+.HP

+int XauLockAuth (const char *\fIfile_name\fP\^, int \fIretries\fP\^, int

+\fItimeout\fP\^, long \fIdead\fP\^);

+.HP

+int XauUnlockAuth (const char *\fIfile_name\fP\^);

+.HP

+int XauDisposeAuth (Xauth *\fIauth\fP\^);

+.ft R

+.SH DESCRIPTION

+.PP

+\fBXauFileName\fP generates the default authorization file name by first

+checking the XAUTHORITY environment variable if set, else it returns

+$HOME/.Xauthority.  This name is statically allocated and should

+not be freed.

+.PP

+\fBXauReadAuth\fP reads the next entry from \fIauth_file\fP.  The entry is

+\fBnot\fP statically allocated and should be freed by calling

+\fIXauDisposeAuth\fP.

+.PP

+\fBXauWriteAuth\fP writes an authorization entry to \fIauth_file\fP.  It

+returns 1 on success, 0 on failure.

+.PP

+\fBXauGetAuthByAddr\fP searches for an entry which matches the given network

+address/display number pair.  The entry is \fBnot\fP statically allocated

+and should be freed by calling \fIXauDisposeAuth\fP.

+.PP

+\fBXauGetBestAuthByAddr\fP is similar to \fBXauGetAuthByAddr\fP, except

+that a list of acceptable authentication methods is specified.  Xau will

+choose the file entry which matches the earliest entry in this list (e.g., the

+most secure authentication method).  The \fItypes\fP argument is an array of

+strings, one string for each authentication method.  \fItypes_length\fP

+specifies how many elements are in the \fItypes\fP array.

+\fItypes_lengths\fP is an array of integers representing the length

+of each string.

+.PP

+\fBXauLockAuth\fP does the work necessary to synchronously update an

+authorization file.  First it makes two file names, one with ``-c'' appended

+to \fIfile_name\fP, the other with ``-l'' appended.  If the ``-c'' file

+already exists and is more than \fIdead\fP seconds old, \fIXauLockAuth\fP

+removes it and the associated ``-l'' file.  To prevent possible

+synchronization troubles with NFS, a \fIdead\fP value of zero forces the

+files to be removed.  \fIXauLockAuth\fP makes \fIretries\fP attempts to

+create and link the file names, pausing \fItimeout\fP seconds between each

+attempt.  \fIXauLockAuth\fP returns a collection of values depending on the

+results:

+.nf

+.ta .5i 2i

+

+	LOCK_ERROR	A system error occurred, either a file_name

+		which is too long, or an unexpected failure from

+		a system call.  errno may prove useful.

+

+	LOCK_TIMEOUT	\fIretries\fP attempts failed

+

+	LOCK_SUCCESS	The lock succeeded.

+

+.fi

+.PP

+\fBXauUnlockAuth\fP undoes the work of \fIXauLockAuth\fP by unlinking both

+the ``-c'' and ``-l'' file names.

+.PP

+\fBXauDisposeAuth\fP frees storage allocated to hold an authorization entry.

+.SH "SEE ALSO"

+xauth(1), xdm(1)

+.SH AUTHOR

+Keith Packard, MIT X Consortium

diff --git a/libXau/man/XauDisposeAuth.man b/libXau/man/XauDisposeAuth.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauDisposeAuth.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauFileName.man b/libXau/man/XauFileName.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauFileName.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauGetAuthByAddr.man b/libXau/man/XauGetAuthByAddr.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauGetAuthByAddr.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauGetBestAuthByAddr.man b/libXau/man/XauGetBestAuthByAddr.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauGetBestAuthByAddr.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauLockAuth.man b/libXau/man/XauLockAuth.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauLockAuth.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauReadAuth.man b/libXau/man/XauReadAuth.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauReadAuth.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauUnlockAuth.man b/libXau/man/XauUnlockAuth.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauUnlockAuth.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__

diff --git a/libXau/man/XauWriteAuth.man b/libXau/man/XauWriteAuth.man
new file mode 100644
index 000000000..d20306a06
--- /dev/null
+++ b/libXau/man/XauWriteAuth.man
@@ -0,0 +1 @@
+.so man__libmansuffix__/Xau.__libmansuffix__