MAN page from Fedora 21 xorg-x11-xinit-1.3.4-3.fc21.x86_64.rpm
Section: User Commands (1)
Updated: xinit 1.3.4Index
startx - initialize an X session
... ] [--
script is a front end toxinit
(1)that provides asomewhat nicer user interface for running a single session of the XWindow System. It is often run with no arguments.
Arguments immediately following thestartxcommand are used to start a client in the same manner asxinit(1).The special argument'--'marks the end of client arguments and the beginning of server options.By default startx passes'-nolisten tcp'to the server, the special server option'-listen'can be used to stop startx from doing this.It may be convenient to specify server options with startx to change on aper-session basis thedefault color depth, the server's notion of the number of dots-per-inch thedisplay device presents, or take advantage of a different server layout, aspermitted by theXorg(1)server and specified in thexorg.conf(5)configuration. Some examples of specifying server arguments follow; consultthe manual page for your X server to determine which arguments are legal.
startx -- -depth 16
startx -- -dpi 100
startx -- -layout Multihead
To determine the client to run,startxfirst looks for a file called.xinitrcin the user's home directory. If that is not found, it usesthe filexinitrcin thexinitlibrary directory.If command line client options are given, they override thisbehavior and revert to thexinit(1)behavior.To determine the server to run,startxfirst looks for a file called.xserverrcin the user's home directory. If that is not found, it usesthe filexserverrcin thexinitlibrary directory.If command line server options are given, they override thisbehavior and revert to thexinit(1)behavior. Users rarely need to provide a.xserverrcfile.See thexinit(1)manual page for more details on the arguments.
The system-widexinitrcandxserverrcfiles are found in the/etc/X11/xinitdirectory.
The.xinitrcis typically a shell script which starts many clients according to theuser's preference. When this shell script exits,startxkills the server and performs any other session shutdown needed.Most of the clients started by.xinitrcshould be run in the background. The last client should run in theforeground; when it exits, the session will exit. People often choosea session manager, window manager, or xterm as the ''magic'' client.
Below is a sample .xinitrc that starts several applications andleaves the window manager running as the ''last'' application. Assuming thatthe window manager has been configured properly, the userthen chooses the ''Exit'' menu item to shut down X.
xrdb -load $HOME/.Xresourcesxsetroot -solid gray &xbiff -geometry -430+5 &oclock -geometry 75x75-0-0 &xload -geometry -80-0 &xterm -geometry +0+60 -ls &xterm -geometry +0-100 &xconsole -geometry -0+0 -fn 5x7 &exec twm
- This variable gets set to the name of the display to which clients shouldconnect. Note that this getsset,not read.
- This variable, if not already defined, gets set to$(HOME)/.Xauthority.This is to prevent the X server, if not given the-authargument, from automatically setting up insecure host-based authenticationfor the local host. See theXserver(1)andXsecurity(7)manual pages for more information on X client/server authentication.
- Client to run. Typically a shell script which runs many programs inthe background.
- Server to run. The default isX.
- Client to run if the user has no.xinitrcfile.
- Server to run if the user has no.xserverrcfile.
- ENVIRONMENT VARIABLES
- SEE ALSO
This document was created byman2html,using the manual pages.