cinnamon-session(1)

1GNOME-SESSION(1)            General Commands Manual           GNOME-SESSION(1)
2
3
4

NAME

6       cinnamon-session - Start the GNOME desktop environment
7

SYNOPSIS

9       cinnamon-session   [-a|--autostart=DIR]   [--session=SESSION]  [--fail‐
10       safe|-f] [--debug] [--whale]
11

DESCRIPTION

13       The cinnamon-session program starts up the GNOME  desktop  environment.
14       This  command  is typically executed by your login manager (either mdm,
15       xdm, or from your X startup scripts). It will load  either  your  saved
16       session,  or  it will provide a default session for the user as defined
17       by the system administrator (or the default GNOME installation on  your
18       system).
19
20       The  default  session is defined in gnome.session, a .desktop-like file
21       that  is  looked  for  in   $XDG_CONFIG_HOME/cinnamon-session/sessions,
22       $XDG_CONFIG_DIRS/cinnamon-session/sessions and $XDG_DATA_DIRS/cinnamon-
23       session/sessions.
24
25       When saving a session, cinnamon-session  saves  the  currently  running
26       applications   in  the  $XDG_CONFIG_HOME/cinnamon-session/saved-session
27       directory.
28
29       cinnamon-session is an X11R6  session  manager.  It  can  manage  GNOME
30       applications as well as any X11R6 SM compliant application.
31

OPTIONS

33       The following options are supported:
34
35       --autostart=DIR
36              Start  all  applications defined in DIR, instead of starting the
37              applications defined in  gnome.session,  or  via  the  --session
38              option. Multiple --autostart options can be passed.
39
40       --session=SESSION
41              Use  the  applications defined in SESSION.session. If not speci‐
42              fied, gnome.session will be used.
43
44       --failsafe
45              Run in fail-safe mode. User-specified applications will  not  be
46              started.
47
48       --debug
49              Enable debugging code.
50
51       --whale
52              Show the fail whale in a dialog for debugging it.
53

SESSION DEFINITION

55       Sessions  are defined in .session files, that are using a .desktop-like
56       format, with the following keys in the GNOME Session group:
57
58       Name   Name of the session. This can be localized.
59
60       RequiredComponents
61              List of component identifiers (desktop files) that are  required
62              by  the  session. The required components will always run in the
63              session.
64
65       RequiredProviders
66              List of task providers that  are  required  by  the  session.  A
67              default provider for each task has to be defined with a Default‐
68              Provider-TASK key; the provider can be  overridden  by  required
69              components,  the  saved  session  or autostart applications. The
70              task providers will always run in the session.
71
72       DefaultProvider-TASK
73              Identifier (desktop file) of the default provider for  TASK.  If
74              no  provider  for  TASK is found in the required components, the
75              saved session and in the  autostart  applications,  the  default
76              provider will be started.
77
78       Here is an example of a session definition:
79
80           [GNOME Session]
81           Name=GNOME fallback
82           RequiredComponents=gnome-panel;metacity;gnome-settings-daemon;
83           RequiredProviders=notifications;
84           DefaultProvider-notifications=notification-daemon
85
86       The  .session  files  are  looked for in $XDG_CONFIG_HOME/cinnamon-ses‐
87       sion/sessions,      $XDG_CONFIG_DIRS/cinnamon-session/sessions      and
88       $XDG_DATA_DIRS/cinnamon-session/sessions.
89

ENVIRONMENT

91       cinnamon-session  sets several environment variables for the use of its
92       child processes:
93
94       SESSION_MANAGER
95
96              This variable is used by session-manager aware clients  to  con‐
97              tact cinnamon-session.
98
99       DISPLAY
100
101              This  variable  is  set to the X display being used by cinnamon-
102              session. Note that if the --display option is used this might be
103              different from the setting of the environment variable when cin‐
104              namon-session is invoked.
105

FILES

107       $XDG_CONFIG_HOME/config/autostart     $XDG_CONFIG_DIRS/config/autostart
108       /usr/share/gnome/autostart
109
110              The applications defined in those directories will be started on
111              login.  cinnamon-settings(1) can be  used  to  easily  configure
112              them.
113
114       $XDG_CONFIG_HOME/cinnamon-session/sessions   $XDG_CONFIG_DIRS/cinnamon-
115       session/sessions $XDG_DATA_DIRS/cinnamon-session/sessions
116
117              These directories contain the .session files that  can  be  used
118              with the --session option.
119
120       $XDG_CONFIG_HOME/cinnamon-session/saved-session
121
122              This  directory  contains  the list of applications of the saved
123              session.
124