sx/README

46 lines
1.6 KiB
Plaintext
Raw Normal View History

2017-12-01 14:14:54 -06:00
sx <https://github.com/Earnestly/sx>
INTRODUCTION
sx is a simple alternative to both xinit(1) and startx(1) for starting
an Xorg server.
2017-12-01 14:14:54 -06:00
It started life as a proof of concept while attempting to learn how both
xinit and startx worked.
2017-12-01 14:14:54 -06:00
It is not a direct replacement however as it provides a different, more
limited, interface.
Some of these major differences are listed here:
2017-12-01 14:14:54 -06:00
2018-08-04 09:57:01 -05:00
* The server's command-line is hard coded and not exposed to the user.
2017-12-09 17:34:20 -06:00
* The server doesn't listen on anything except unix domain sockets.
* The server starts on the same tty the user logged in on.
2018-08-04 09:57:01 -05:00
* The first DISPLAY is 1 instead of 0 contrary to what X(7) suggests
as it is coupled to the tty number.
2017-12-01 14:14:54 -06:00
* xauth entries are overwritten if the displayname is identical.
2018-08-04 09:57:01 -05:00
* Corresponding xauth entries are unconditionally removed when the
server exits.
* The server uses the -noreset flag.
2018-08-04 09:57:01 -05:00
* While XAUTHORITY is still honoured, $XDG_DATA_HOME/sx/xauthfile is
used by default instead of $HOME/.Xauthority
* Very little proxy error checking is used preferring instead to let
each tool speak for itself.
2017-12-01 14:14:54 -06:00
* None of the typical /etc/X11/xinit infrastructure is directly used.
* Neither XINITRC is honoured nor .xinitrc used.
* The XDG_CONFIG_HOME/sx/sxrc file is used instead of .xinitrc and is
required to be executable.
2018-08-04 09:57:01 -05:00
For a rationale on why this exists, the author invites the reader to
look over the source code for both xinit and startx.
2017-12-01 14:14:54 -06:00
REQUIRES
* Xorg
* xauth
* /dev/urandom
2017-12-01 14:14:54 -06:00
INSTALL
2017-12-01 14:14:54 -06:00
make PREFIX=/usr DESTDIR=staged install