Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

gnome-session (1)

Name

gnome-session - Start the GNOME desktop environment

Synopsis

gnome-session  [-a|--autostart=DIR] [--session=SESSION] [--failsafe|-f]
[--debug] [--whale]

Description

GNOME-SESSION(1)            General Commands Manual           GNOME-SESSION(1)



NAME
       gnome-session - Start the GNOME desktop environment

SYNOPSIS
       gnome-session  [-a|--autostart=DIR] [--session=SESSION] [--failsafe|-f]
       [--debug] [--whale]

DESCRIPTION
       The gnome-session program starts up the GNOME desktop environment. This
       command  is  typically executed by your login manager (either gdm, xdm,
       or from your X startup scripts). It will load either  your  saved  ses-
       sion,  or  it will provide a default session for the user as defined by
       the system administrator (or the default  GNOME  installation  on  your
       system).

       The  default  session is defined in gnome.session, a .desktop-like file
       that  is   looked   for   in   $XDG_CONFIG_HOME/gnome-session/sessions,
       $XDG_CONFIG_DIRS/gnome-session/sessions  and  $XDG_DATA_DIRS/gnome-ses-
       sion/sessions.

       When saving a session, gnome-session saves the currently running appli-
       cations in the $XDG_CONFIG_HOME/gnome-session/saved-session directory.

       gnome-session is an X11R6 session manager. It can manage GNOME applica-
       tions as well as any X11R6 SM compliant application.

OPTIONS
       The following options are supported:

       --autostart=DIR
              Start all applications defined in DIR, instead of  starting  the
              applications  defined  in  gnome.session,  or  via the --session
              option. Multiple --autostart options can be passed.

       --session=SESSION
              Use the applications defined in SESSION.session. If  not  speci-
              fied, gnome.session will be used.

       --failsafe
              Run  in  fail-safe mode. User-specified applications will not be
              started.

       --debug
              Enable debugging code.

       --whale
              Show the fail whale in a dialog for debugging it.

SESSION DEFINITION
       Sessions are defined in .session files, that are using a  .desktop-like
       format, with the following keys in the GNOME Session group:

       Name   Name of the session. This can be localized.

       RequiredComponents
              List  of component identifiers (desktop files) that are required
              by the session. The required components will always run  in  the
              session.

       Here is an example of a session definition:

           [GNOME Session]
           Name=GNOME
           RequiredComponents=gnome-shell;gnome-settings-daemon;

       The  .session  files  are  looked  for  in  $XDG_CONFIG_HOME/gnome-ses-
       sion/sessions,       $XDG_CONFIG_DIRS/gnome-session/sessions        and
       $XDG_DATA_DIRS/gnome-session/sessions.

ENVIRONMENT
       gnome-session  sets  several  environment  variables for the use of its
       child processes:

       SESSION_MANAGER

              This variable is used by session-manager aware clients  to  con-
              tact gnome-session.

       DISPLAY

              This  variable  is set to the X display being used by gnome-ses-
              sion. Note that if the --display option is used  this  might  be
              different  from  the  setting  of  the environment variable when
              gnome-session is invoked.

FILES
       $XDG_CONFIG_HOME/config/autostart     $XDG_CONFIG_DIRS/config/autostart
       /usr/share/gnome/autostart

              The applications defined in those directories will be started on
              login.

       $XDG_CONFIG_HOME/gnome-session/sessions     $XDG_CONFIG_DIRS/gnome-ses-
       sion/sessions $XDG_DATA_DIRS/gnome-session/sessions

              These  directories  contain  the .session files that can be used
              with the --session option.

       $XDG_CONFIG_HOME/gnome-session/saved-session

              This directory contains the list of applications  of  the  saved
              session.

BUGS
       If  you  find bugs in the gnome-session program, please report these on
       https://bugzilla.gnome.org.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | gnome/gnome-session   |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+
SEE ALSO
       gnome-session-quit(1)



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded  from   https://download.gnome.org/sources/gnome-
       session/3.24/gnome-session-3.24.0.tar.xz

       Further information about this software can be found on the open source
       community website at https://wiki.gnome.org/Projects/SessionManagement.



                                     GNOME                    GNOME-SESSION(1)