haven/nexgb
aarzilli 8d343cfd3a
Handle wildcard values in Xauthority file
Some field values in the Xauthority file have special meanings:
- a value of 65535 in the 'family' field means that the entry will
match a connection of any family on any address
- an empty string in the 'display number' field means that the entry
will match a connection on any display number

This behaviour is documented at:
https://cgit.freedesktop.org/xorg/lib/libXau/tree/AuGetBest.c#n109
2018-09-08 16:49:25 +02:00
..
bigreq Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
composite Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
damage Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
dpms Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
dri2 Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
examples Formatting and 80 cols. 2018-09-08 16:49:23 +02:00
ge Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
glx Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
randr Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
record Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
render Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
res Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
screensaver Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
shape Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
shm Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xcmisc Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xevie Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xf86dri Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xf86vidmode Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xfixes Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xgbgen Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xinerama Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xprint Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xproto Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xselinux Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xtest Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xv Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
xvmc Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00
.gitignore last commit before i tear everything down 2012-04-29 14:09:03 -04:00
AUTHORS initial commit. not currently in a working state. 2012-04-28 23:25:57 -04:00
CONTRIBUTORS initial commit. not currently in a working state. 2012-04-28 23:25:57 -04:00
LICENSE initial commit. not currently in a working state. 2012-04-28 23:25:57 -04:00
Makefile shortcuts for the lazy 2018-09-08 16:49:20 +02:00
README Tests were move to xproto package a long time ago. Update README. 2018-09-08 16:49:15 +02:00
STYLE Add some style guidelines. 2018-09-08 16:49:07 +02:00
auth.go Handle wildcard values in Xauthority file 2018-09-08 16:49:25 +02:00
conn.go add a new api: NewConnNet 2018-09-08 16:49:23 +02:00
cookie.go Remove panics/fatal errors. 2018-09-08 16:49:24 +02:00
doc.go gofmt 2018-09-08 16:49:16 +02:00
help.go Doc fix. 2018-09-08 16:49:14 +02:00
sync.go docs 2012-05-12 21:36:31 -04:00
xgb.go Read/Write mutex for Extensions map 2018-09-08 16:49:24 +02:00

README

XGB is the X Go Binding, which is a low-level API to communicate with the
core X protocol and many of the X extensions. It is closely modeled after
XCB and xpyb.

It is thread safe and gets immediate improvement from parallelism when
GOMAXPROCS > 1. (See the benchmarks in xproto/xproto_test.go for evidence.)

Please see doc.go for more info.

Note that unless you know you need XGB, you can probably make your life
easier by using a slightly higher level library: xgbutil.

Quick Usage
===========
go get github.com/BurntSushi/xgb
go run go/path/src/github.com/BurntSushi/xgb/examples/create-window/main.go

BurntSushi's Fork
=================
I've forked the XGB repository from Google Code due to inactivty upstream.

Godoc documentation can be found here:
http://godoc.burntsushi.net/pkg/github.com/BurntSushi/xgb/

Much of the code has been rewritten in an effort to support thread safety
and multiple extensions. Namely, go_client.py has been thrown away in favor
of an xgbgen package.

The biggest parts that *haven't* been rewritten by me are the connection and
authentication handshakes. They're inherently messy, and there's really no
reason to re-work them. The rest of XGB has been completely rewritten.

I like to release my code under the WTFPL, but since I'm starting with someone
else's work, I'm leaving the original license/contributor/author information
in tact.

I suppose I can legitimately release xgbgen under the WTFPL. To be fair, it is
at least as complex as XGB itself. *sigh*

What follows is the original README:

XGB README
==========
XGB is the X protocol Go language Binding.

It is the Go equivalent of XCB, the X protocol C-language Binding
(http://xcb.freedesktop.org/).

Unless otherwise noted, the XGB source files are distributed
under the BSD-style license found in the LICENSE file.

Contributions should follow the same procedure as for the Go project:
http://golang.org/doc/contribute.html