Provided by: uxlaunch_0.60-1ubuntu1_amd64
uxlaunch - program to start the X desktop
uxlaunch [OPTIONS] [-- SESSION]
uxlaunch is a program that initiates the X server and desktop environment. It starts the main component of the desktop up as soon as the X server is ready and relies on autostart .desktop files for other applications to be started. uxlaunch Was designed to start the Moblin desktop but can launch Gnome, Xfce and other desktop sessions as well. uxlaunch Works as a generic session launcher and prepares dbus, ssh-agent and ConsoleKit for the user session, launches the Xorg server, and then hands over session management to a session process (usually a main component such as mutter, the window mananger or something like xfce4-session. uxlaunch Also initializes the environment variables as close as it can to what a normal shell login would set. After starting the session process, user startup applications are processed following the freedesktop.org Desktop File standard, starting up applications one by one. Finally, uxlaunch cleans up the session if any of the session process, or X server process dies, and attempts to clean up all that was started properly. uxlaunch Does not restart itself for a new session, it relies on an external watchdog or baby sitter process to relaunch itself, such ash sysvinit or upstart.
-u [USERNAME], --user=[USERNAME] specify an alternative user to start the desktop session as. By default, uxlaunch will use the first user accound found through various tests, or the user "meego" if none valid is found. -s [SESSION], --session=[SESSION] specify an alternative session to start. This overrides the default session (Moblin) and attempts to start [SESSION] instead. -t [TTY], --tty=[TTY] Specify to use tty [TTY] instead of tty1 to run the X server on. -v, --verbose Display more information on stderr. All messages go to the logfile (/var/log/uxlaunch.log) in any case. -h, --help Display terse usage information. show the help message.
uxlaunch Is designed to be started from /etc/inittab. Normally, uxlaunch should be added as a runlevel 5 task, started as root, and restarted when needed. This can be achieved by adding the following line to /etc/inttab: x:5:respawn:/usr/sbin/uxlaunch
uxlaunch configuration is done through /etc/sysconfig/uxlaunch. The file closely matches the command line options and allows you to specify most of the same parameters. The format of this file is simple "key=value" pairs: user=[USERNAME] session=[SESSION] tty=[TTY] See OPTIONS for a description of these settings. dpi=[auto|DPI VALUE] This option allows the user to override the default (120) dpi value used by uxlaunch. Either a numeric value (e.g. 96) or the special word "auto" can be used. If "auto" is specified, uxlaunch will defer the dpi setting to the XOrg server, which will attempt to autodetect your display size from the monitor and set an appropriate dpi value. xopts=[ADDITIONAL XOPTIONS] This option allows the user to set additional options to be passed to the XOrg server on invocation. For example, one could pass "-bpp 16" to specify that the server be started in 16 bit mode.
uxlaunch Supports desktop session startup by processing the files relevant to the freedesktop.org Desktop File Standard. uxlaunch Tries to honor the settings in XDG_CONFIG_HOME and XDG_CONFIG_DIRS and will retreive values from the users shell settings. After this and the session executable startup, uxlaunch will process autostart xdg files in the appropriate locations, prioritizing the users's override locations over default system wide startup file locations.
DESKTOP FILE EXTENSIONS
uxlaunch Supports a few extended key/value pairs in desktop autostart files to enhance the desktop startup process: X-MeeGo-Priority=[Highest|High|Low|Late] Prioritize startup of this application to be immediate (Highest), or in subsequent lower priority brackets (High, Low, Late). Each application in a bracket is only started after all the applications in the previous bracket are started, and a certain timeout has been waited. The time between applications becomes larger for lower priorities, and can be up to minutes for applications in the "late" bracket. X-Meego-Watchdog=[Halt|Restart|Fail] Attach a watchdog to the application. The watchdog can perform several actions based on the exit conditions of the application. Normally when an application exits, nothing happens. If "restart" is set, the application is restarted no matter what exit condition happened. If "fail" is set, the application is restarted if it returned an exit condition (non-0 exit code). If "halt" is set, the session is shut down if the application exits. This allows a critical application to generate a session restart or shutdown condition. X-MeesGo-OnlyStartIfFileExists=[path] X-MeesGo-DontStartIfFileExists=[path] Make the startup of the application conditional on whether a file exists (OnlyStartIf...) or conditional on whether a file does not exist (DontStart...).
uxlaunch Copies the user's shell environment over to the session it starts by starting a subshell for the user and preserving the environment variables. Several variables influence how uxlaunch works: XDG_CONFIG_HOME XDG_CONFIG_DIRS See the freedesktop.org standard for how these variables influence application startup. X_DESKTOP_SESSION Records the session name used in the current session. For use in programs that need to determine what session is running through this method. LANG SYSFONT These two variables are set by reading /etc/sysconfig/i18n and parsing the content.
Send bug reports to <firstname.lastname@example.org>
The program is more fully described at http://meego.com/
uxlaunch was written by Arjan van de Ven <email@example.com>, and Auke Kok <firstname.lastname@example.org>.