<!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">

<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>

<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>