266 lines
5.1 KiB
HTML
266 lines
5.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of STARTX</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>STARTX</H1>
|
|
Section: User Commands (1)<BR>Updated: xinit 1.4.1<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
startx - initialize an X session
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>startx</B>
|
|
|
|
[ [
|
|
<I>client</I>
|
|
|
|
]
|
|
<I>options</I>
|
|
|
|
... ] [
|
|
<B>--</B>
|
|
|
|
[
|
|
<I>server</I>
|
|
|
|
] [
|
|
<I>display</I>
|
|
|
|
]
|
|
<I>options</I>
|
|
|
|
... ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The <B>startx</B> script is a front end to
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1)
|
|
|
|
that provides a
|
|
somewhat nicer user interface for running a single session of the X
|
|
Window System. It is often run with no arguments.
|
|
<P>
|
|
|
|
Arguments immediately following the
|
|
<I>startx</I>
|
|
|
|
command are used to start a client in the same manner as
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1).
|
|
|
|
The special argument
|
|
'--'
|
|
|
|
marks the end of client arguments and the beginning of server options.
|
|
It may be convenient to specify server options with startx to change them on a
|
|
per-session basis.
|
|
Some examples of specifying server arguments follow; consult
|
|
the manual page for your X server to determine which arguments are legal.
|
|
<DL COMPACT><DT id="1"><DD>
|
|
<P>
|
|
|
|
startx -- -depth 16
|
|
<P>
|
|
|
|
startx -- -dpi 100
|
|
<P>
|
|
|
|
startx -- -layout Multihead
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Note that in the Debian system, what many people traditionally put in the
|
|
<I>.xinitrc</I>
|
|
|
|
file should go in
|
|
<I>.xsession</I>
|
|
|
|
instead; this permits the same X environment to be presented whether
|
|
<I>startx</I>,
|
|
|
|
<I>xdm</I>,
|
|
|
|
or
|
|
<I>xinit</I>
|
|
|
|
is used to start the X session. All discussion of the
|
|
<I>.xinitrc</I>
|
|
|
|
file in the
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></I>(1)
|
|
|
|
manual page applies equally well to
|
|
<I>.xsession.</I>
|
|
|
|
Keep in mind that
|
|
<I>.xinitrc</I>
|
|
|
|
is used only by
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></I>(1)
|
|
|
|
and completely ignored by
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1).
|
|
|
|
<P>
|
|
|
|
To determine the client to run,
|
|
<B>startx</B>
|
|
|
|
looks for the following files, in order:
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<P>
|
|
|
|
<I>$(HOME)/.startxrc</I>
|
|
|
|
<P>
|
|
|
|
<I>/usr/lib/x86_64-linux-gnu/sys.startxrc</I>
|
|
|
|
<P>
|
|
|
|
<I>$(HOME)/.xinitrc</I>
|
|
|
|
<P>
|
|
|
|
<I>/etc/X11/xinit/xinitrc</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
If command line client options are given, they override this
|
|
behavior and revert to the
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1)
|
|
|
|
behavior.
|
|
To determine the server to run,
|
|
<B>startx</B>
|
|
|
|
first looks for a file called
|
|
<I>.xserverrc</I>
|
|
|
|
in the user's home directory. If that is not found, it uses
|
|
the file
|
|
<I>xserverrc</I>
|
|
|
|
in the
|
|
<I>xinit</I>
|
|
|
|
library directory.
|
|
If command line server options are given, they override this
|
|
behavior and revert to the
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1)
|
|
|
|
behavior. Users rarely need to provide a
|
|
<I>.xserverrc</I>
|
|
|
|
file.
|
|
See the
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1)
|
|
|
|
manual page for more details on the arguments.
|
|
<P>
|
|
|
|
The system-wide
|
|
<I>xinitrc</I>
|
|
|
|
and
|
|
<I>xserverrc</I>
|
|
|
|
files are found in the
|
|
<I>/etc/X11/xinit</I>
|
|
|
|
directory.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>ENVIRONMENT VARIABLES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="3">DISPLAY<DD>
|
|
This variable gets set to the name of the display to which clients should
|
|
connect. Note that this gets
|
|
<I>set</I>,
|
|
|
|
not read.
|
|
<DT id="4">XAUTHORITY<DD>
|
|
This variable, if not already defined, gets set to
|
|
<I>$(HOME)/.Xauthority</I>.
|
|
|
|
This is to prevent the X server, if not given the
|
|
<I>-auth</I>
|
|
|
|
argument, from automatically setting up insecure host-based authentication
|
|
for the local host. See the
|
|
<B><A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A></B>(1)
|
|
|
|
and
|
|
<I><A HREF="/cgi-bin/man/man2html?7+Xsecurity">Xsecurity</A></I>(7)
|
|
|
|
manual pages for more information on X client/server authentication.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><I>$(HOME)/.xinitrc</I>
|
|
|
|
<DD>
|
|
Client to run. Typically a shell script which runs many programs in
|
|
the background.
|
|
<DT id="6"><I>$(HOME)/.xserverrc</I>
|
|
|
|
<DD>
|
|
Server to run. The default is
|
|
<I>X</I>.
|
|
|
|
<DT id="7"><I>/etc/X11/xinit/xinitrc</I>
|
|
|
|
<DD>
|
|
Client to run if the user has no
|
|
<I>.xinitrc</I>
|
|
|
|
file.
|
|
<DT id="8"><I>/etc/X11/xinit/xserverrc</I>
|
|
|
|
<DD>
|
|
Server to run if the user has no
|
|
<I>.xserverrc</I>
|
|
|
|
file.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+X">X</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+Xorg">Xorg</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+xorg.conf">xorg.conf</A></B>(5)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="12"><A HREF="#lbAE">ENVIRONMENT VARIABLES</A><DD>
|
|
<DT id="13"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="14"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:27 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|