sx/sx.1

83 lines
1.5 KiB
Groff
Raw Normal View History

.TH SX 1 "21 October 2018"
2017-12-01 14:14:54 -06:00
.SH NAME
sx \- start an xorg server
2017-12-01 14:14:54 -06:00
.SH SYNOPSIS
.B sx
.RI [ "command " [ "arguments " ...]]
2017-12-01 14:14:54 -06:00
.SH DESCRIPTION
.B sx
can be used to replace both
.BR xinit (1)
and
.BR startx (1)
for starting an Xorg server. By default
.B sx
will attempt to execute
2017-12-01 14:14:54 -06:00
.I sxrc
unless a
.I command
is provided. The
.I command
may have additional
.IR arguments .
2017-12-01 14:14:54 -06:00
.SH ENVIRONMENT
.TP
.B XAUTHORITY
2017-12-04 05:58:00 -06:00
This environment references a file which stores authorisation entries
used to secure
2017-12-01 14:14:54 -06:00
.BR Xorg (1) .
If this environment is not set then
.B sx
will create and use
.B \%XDG_DATA_HOME/sx/xauthority
2017-12-04 05:58:00 -06:00
instead while also exporting this value to
.BR XAUTHORITY .
.TP
.B XDG_CONFIG_HOME
The directory used when searching for
.IR sxrc .
.B \%HOME/.config
will be used if not set.
.TP
.B XDG_DATA_HOME
The directory used for storing the
.I xauthority
file.
.B \%HOME/.local/share
will be used if not set.
2017-12-01 14:14:54 -06:00
.SH FILES
.TP
.B XDG_CONFIG_HOME/sx/sxrc
The default command started by
2017-12-01 14:14:54 -06:00
.BR sx .
This file must be executable.
.TP
.B XDG_DATA_HOME/sx/xauthority
The default authority used by
.B sx
if an alternative file is not provided with
.BR XAUTHORITY .
.SH NOTES
Since the addition of
.BR Xorg.wrap (1)
it may be necessary to set
.I allowed_users
to
.I anybody
in
.BR \%/etc/X11/Xwrapper.config .
This is due to
.B sx
attempting to run commands from within a subshell and is thusly not considered
a console user.
2017-12-01 14:14:54 -06:00
.SH SOURCE
.UR https://github.com/Earnestly/sx
.UE
.SH SEE ALSO
.BR startx (1),
.BR X (7),
.BR xinit (1),
.BR Xorg (1),
2017-12-04 05:58:00 -06:00
.BR Xsecurity (7),
.BR Xwrapper.config (5)