|
Packit Service |
e29df6 |
.\"
|
|
Packit Service |
e29df6 |
.\" gnome-session manual page.
|
|
Packit Service |
e29df6 |
.\" (C) 2000 Miguel de Icaza (miguel@helixcode.com)
|
|
Packit Service |
e29df6 |
.\" (C) 2009-2010 Vincent Untz (vuntz@gnome.org)
|
|
Packit Service |
e29df6 |
.\"
|
|
Packit Service |
e29df6 |
.TH GNOME-SESSION 1 "GNOME"
|
|
Packit Service |
e29df6 |
.SH NAME
|
|
Packit Service |
e29df6 |
gnome-session \- Start the GNOME desktop environment
|
|
Packit Service |
e29df6 |
.SH SYNOPSIS
|
|
Packit Service |
e29df6 |
.B gnome-session [\-a|\-\-autostart=DIR] [\-\-session=SESSION] [\-\-failsafe|\-f] [\-\-debug] [\-\-whale]
|
|
Packit Service |
e29df6 |
.SH DESCRIPTION
|
|
Packit Service |
e29df6 |
The \fIgnome-session\fP program starts up the GNOME desktop
|
|
Packit Service |
e29df6 |
environment. This command is typically executed by your login manager
|
|
Packit Service |
e29df6 |
(either gdm, xdm, or from your X startup scripts). It will load
|
|
Packit Service |
e29df6 |
either your saved session, or it will provide a default session for the
|
|
Packit Service |
e29df6 |
user as defined by the system administrator (or the default GNOME
|
|
Packit Service |
e29df6 |
installation on your system).
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
The default session is defined in \fBgnome.session\fP, a .desktop-like
|
|
Packit Service |
e29df6 |
file that is looked for in
|
|
Packit Service |
e29df6 |
\fB$XDG_CONFIG_HOME/gnome-session/sessions\fP,
|
|
Packit Service |
e29df6 |
\fB$XDG_CONFIG_DIRS/gnome-session/sessions\fP and
|
|
Packit Service |
e29df6 |
\fB$XDG_DATA_DIRS/gnome-session/sessions\fP.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
When saving a session, \fIgnome-session\fP saves the currently running
|
|
Packit Service |
e29df6 |
applications in the \fB$XDG_CONFIG_HOME/gnome-session/saved-session\fP
|
|
Packit Service |
e29df6 |
directory.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
\fIgnome-session\fP is an X11R6 session manager. It can manage GNOME
|
|
Packit Service |
e29df6 |
applications as well as any X11R6 SM compliant application.
|
|
Packit Service |
e29df6 |
.SH OPTIONS
|
|
Packit Service |
e29df6 |
The following options are supported:
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I "--autostart=DIR"
|
|
Packit Service |
e29df6 |
Start all applications defined in \fIDIR\fP, instead of starting the
|
|
Packit Service |
e29df6 |
applications defined in \fBgnome.session\fP, or via the \fI--session\fP
|
|
Packit Service |
e29df6 |
option. Multiple \fI--autostart\fP options can be passed.
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I "--session=SESSION"
|
|
Packit Service |
e29df6 |
Use the applications defined in \fBSESSION.session\fP. If not specified,
|
|
Packit Service |
e29df6 |
\fBgnome.session\fP will be used.
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I "--failsafe"
|
|
Packit Service |
e29df6 |
Run in fail-safe mode. User-specified applications will not be started.
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I "--debug"
|
|
Packit Service |
e29df6 |
Enable debugging code.
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I "--whale"
|
|
Packit Service |
e29df6 |
Show the fail whale in a dialog for debugging it.
|
|
Packit Service |
e29df6 |
.SH SESSION DEFINITION
|
|
Packit Service |
e29df6 |
Sessions are defined in \fB.session\fP files, that are using a .desktop-like
|
|
Packit Service |
e29df6 |
format, with the following keys in the \fBGNOME Session\fP group:
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I Name
|
|
Packit Service |
e29df6 |
Name of the session. This can be localized.
|
|
Packit Service |
e29df6 |
.TP
|
|
Packit Service |
e29df6 |
.I RequiredComponents
|
|
Packit Service |
e29df6 |
List of component identifiers (desktop files) that are required by the session. The required components will always run in the session.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
Here is an example of a session definition:
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.in +4n
|
|
Packit Service |
e29df6 |
.nf
|
|
Packit Service |
e29df6 |
[GNOME Session]
|
|
Packit Service |
e29df6 |
Name=GNOME
|
|
Packit Service |
e29df6 |
RequiredComponents=gnome-shell;gnome-settings-daemon;
|
|
Packit Service |
e29df6 |
.in
|
|
Packit Service |
e29df6 |
.fi
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
The \fB.session\fP files are looked for in
|
|
Packit Service |
e29df6 |
\fB$XDG_CONFIG_HOME/gnome-session/sessions\fP,
|
|
Packit Service |
e29df6 |
\fB$XDG_CONFIG_DIRS/gnome-session/sessions\fP and
|
|
Packit Service |
e29df6 |
\fB$XDG_DATA_DIRS/gnome-session/sessions\fP.
|
|
Packit Service |
e29df6 |
.SH ENVIRONMENT
|
|
Packit Service |
e29df6 |
\fIgnome-session\fP sets several environment variables for the use of
|
|
Packit Service |
e29df6 |
its child processes:
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.B SESSION_MANAGER
|
|
Packit Service |
e29df6 |
.IP
|
|
Packit Service |
e29df6 |
This variable is used by session-manager aware clients to contact
|
|
Packit Service |
e29df6 |
gnome-session.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.B DISPLAY
|
|
Packit Service |
e29df6 |
.IP
|
|
Packit Service |
e29df6 |
This variable is set to the X display being used by
|
|
Packit Service |
e29df6 |
\fIgnome-session\fP. Note that if the \fI--display\fP option is used
|
|
Packit Service |
e29df6 |
this might be different from the setting of the environment variable
|
|
Packit Service |
e29df6 |
when gnome-session is invoked.
|
|
Packit Service |
e29df6 |
.SH FILES
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.B $XDG_CONFIG_HOME/config/autostart
|
|
Packit Service |
e29df6 |
.B $XDG_CONFIG_DIRS/config/autostart
|
|
Packit Service |
e29df6 |
.B /usr/share/gnome/autostart
|
|
Packit Service |
e29df6 |
.IP
|
|
Packit Service |
e29df6 |
The applications defined in those directories will be started on login.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.B $XDG_CONFIG_HOME/gnome-session/sessions
|
|
Packit Service |
e29df6 |
.B $XDG_CONFIG_DIRS/gnome-session/sessions
|
|
Packit Service |
e29df6 |
.B $XDG_DATA_DIRS/gnome-session/sessions
|
|
Packit Service |
e29df6 |
.IP
|
|
Packit Service |
e29df6 |
These directories contain the \fB.session\fP files that can be used
|
|
Packit Service |
e29df6 |
with the \fI--session\fP option.
|
|
Packit Service |
e29df6 |
.PP
|
|
Packit Service |
e29df6 |
.B $XDG_CONFIG_HOME/gnome-session/saved-session
|
|
Packit Service |
e29df6 |
.IP
|
|
Packit Service |
e29df6 |
This directory contains the list of applications of the saved session.
|
|
Packit Service |
e29df6 |
.SH BUGS
|
|
Packit Service |
e29df6 |
If you find bugs in the \fIgnome-session\fP program, please report
|
|
Packit Service |
e29df6 |
these on https://bugzilla.gnome.org.
|
|
Packit Service |
e29df6 |
.SH SEE ALSO
|
|
Packit Service |
e29df6 |
.BR gnome-session-quit(1)
|