stupidcomputer
/
sx
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
sx/README

48 lines
1.7 KiB
Plaintext
Raw Permalink Normal View History

introduce sx
2017-12-01 14:14:54 -06:00
sx <https://github.com/Earnestly/sx>
INTRODUCTION
doc: clarify purpose and bump the manual date
2017-12-07 06:03:43 -06:00
sx is a simple alternative to both xinit(1) and startx(1) for starting
an Xorg server.
introduce sx
2017-12-01 14:14:54 -06:00
It started life as a proof of concept while attempting to learn how both
doc: Further rationale Note that startx itself does call upon admins to improve the script for their particular situation. This also removes the example using DESTDIR as any package maintainer would already be familiar with this standard and expect it to work implicitly. For those who aren't familiar it merely serves as minor confusion.
2021-07-04 09:08:20 -05:00
xinit and startx worked while taking up the offer presented in startx:
> Site administrators are STRONGLY urged to write nicer versions.
introduce sx
2017-12-01 14:14:54 -06:00
It is not a direct replacement however as it provides a different, more
limited, interface.
doc: mention that the login tty is reused
2017-12-11 10:47:46 -06:00
Some of these major differences are listed here:
introduce sx
2017-12-01 14:14:54 -06:00
doc: improve the typesetting
2018-08-04 09:57:01 -05:00
* The server's command-line is hard coded and not exposed to the user.
doc: mention that we don't use -listen
2017-12-09 17:34:20 -06:00
* The server doesn't listen on anything except unix domain sockets.
doc: clarify and update README Correct the location mentioning the xauthority to XDG_DATA_HOME instead of XDG_CONFIG_HOME. Clarify why the server sets DISPLAY to 1 instead of naturally incrementing until an unused slot is found.
2018-08-04 09:34:29 -05:00
* The server starts on the same tty the user logged in on.
doc: improve the typesetting
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.
introduce sx
2017-12-01 14:14:54 -06:00
* xauth entries are overwritten if the displayname is identical.
doc: improve the typesetting
2018-08-04 09:57:01 -05:00
* Corresponding xauth entries are unconditionally removed when the
server exits.
doc: mention that the login tty is reused
2017-12-11 10:47:46 -06:00
* The server uses the -noreset flag.
doc: improve the typesetting
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.
introduce sx
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.
doc: Further rationale Note that startx itself does call upon admins to improve the script for their particular situation. This also removes the example using DESTDIR as any package maintainer would already be familiar with this standard and expect it to work implicitly. For those who aren't familiar it merely serves as minor confusion.
2021-07-04 09:08:20 -05:00
For a rationale on why this exists the author invites the reader to
doc: improve the typesetting
2018-08-04 09:57:01 -05:00
look over the source code for both xinit and startx.
introduce sx
2017-12-01 14:14:54 -06:00
REQUIRES
sx: drop dependencies on coreutils and util-linux Upon review of GNU tail I discovered that the implemention of --pid was the same method as polling kill -0 on a sleep interval, which defaults to 1 second unless -s is used. This is perhaps expected due to the lack of a pwait(2) system call, I decided to implement the same mechanic myself and drop both the requirement on GNU tail and GNU timeout at the same time. This commit also replaces mcookie from util-linux with openssl rand which is used to generate a random MD5 checksum for use in the MIT-MAGIC-COOKIE-1 value.
2017-12-07 05:58:40 -06:00
* Xorg
* xauth
sx: drop dependency on openssl Turns out openssl rand would obnoxiously create a HOME/.rnd dotfile unless told otherwise with the RANDFILE environment. Unfortunately this neither options are compelling and neither can openssl rand be told to not write this file. Instead I'm going to use /dev/urandom which appears to be available on practically every UNIX. This commit also tidies up the timeout kill logic to better express what I am doing.
2017-12-07 07:06:46 -06:00
* /dev/urandom
introduce sx
2017-12-01 14:14:54 -06:00
sx: drop dependencies on coreutils and util-linux Upon review of GNU tail I discovered that the implemention of --pid was the same method as polling kill -0 on a sleep interval, which defaults to 1 second unless -s is used. This is perhaps expected due to the lack of a pwait(2) system call, I decided to implement the same mechanic myself and drop both the requirement on GNU tail and GNU timeout at the same time. This commit also replaces mcookie from util-linux with openssl rand which is used to generate a random MD5 checksum for use in the MIT-MAGIC-COOKIE-1 value.
2017-12-07 05:58:40 -06:00
INSTALL
introduce sx
2017-12-01 14:14:54 -06:00
doc: Further rationale Note that startx itself does call upon admins to improve the script for their particular situation. This also removes the example using DESTDIR as any package maintainer would already be familiar with this standard and expect it to work implicitly. For those who aren't familiar it merely serves as minor confusion.
2021-07-04 09:08:20 -05:00
make PREFIX=/usr install