<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY cmd "default.session">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2003,2006 Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="defaultsession-5">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>default.session.5</refentrytitle><manvolnum>5</manvolnum>
<refmiscinfo class="date">11 Jan 2003</refmiscinfo>
<refmiscinfo class="sectdesc">&man5;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>default.session</primary></indexterm><indexterm><primary>
GNOME default session configuration file</primary></indexterm><refnamediv
id="defaultsession-5-name"><refname>default.session</refname><refpurpose>GNOME default
session configuration file</refpurpose></refnamediv>
<refsect1 id="defaultsession-5-desc"><title>&desc-tt;</title>
<para>The <filename>/usr/share/gnome/default.session</filename> file contains
a list of programs to be launched the first time that a user logs into the
GNOME environment.</para>
</refsect1>
<refsect1 id="defaultsession-5-exde"><title>&exde-tt;</title>
<para>The format of the <filename>/usr/share/gnome/default.session</filename>
file is the same as that used by the <filename>gnome_config</filename> libraries,
as follows:</para>
<para><screen><computeroutput>[Section]
SEQID,id=<replaceable>uniqueid</replaceable>
SEQID,Priority=<replaceable>prio</replaceable>
SEQID,RestartCommand=<replaceable>command</replaceable>
num_clients=<replaceable>top</replaceable></computeroutput></screen></para>
<para>A section with the predefined name of Default specifies the session
to load by default.</para>
<para>As the <filename>gnome_config</filename> file format is not very flexible,
an array of data is emulated by listing, starting from 0, chunks of "id,Priority,RestartCommand".
At the end, the <literal>num_clients</literal> variable lists the number of
chunks listed.</para>
<para>The <literal>uniqueid</literal> key provides a name that is unique within
this file and passed to the application as the client id, which it must use
to register with <filename>gnome-session</filename>.</para>
<para>The <literal>RestartCommand</literal> specifies the command to run from
$PATH.</para>
<para>The <literal>Priority</literal> determines the order in which the commands
are started (with Priority = 0 first) and defaults to 50.</para>
<para>The clients must be  numbered from 0 to the value of {<literal>
num_clients</literal>-1}.</para>
</refsect1>
<refsect1 id="defaultsession-5-file"><title>&file-tt;</title>
<para>The following files are used by this application:</para>
<variablelist termlength="wholeline">
<varlistentry><term><filename>/usr/share/gnome/&cmd;</filename> 
</term><listitem><para>Location of default session file.</para>
</listitem></varlistentry>
<varlistentry><term><filename>~/.gnome2/session</filename></term><listitem>
<para>User session file.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="defaultsession-5-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>gnome/gnome-session
</para></entry></row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Volatile</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="defaultsession-5-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.</para>
<para>
<citerefentry><refentrytitle>gnome-session</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-session-remove</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-session-save</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
</refsect1>
<refsect1 id="defaultsession-5-note"><title>&note-tt;</title>
<para>Written by Brian Cameron, Sun Microsystems Inc., 2003, 2006.</para>
</refsect1>
</refentry>
