13623N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

13623N/A<!--ArborText, Inc., 1988-1999, v.4002-->

13623N/A<!ENTITY cmd "default.session">

13623N/A<!ENTITY % commonents SYSTEM "smancommon.ent">

13623N/A%commonents;

13623N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">

13623N/A%booktitles;

13623N/A<!ENTITY suncopy "Copyright (c) 2003,2006 Sun Microsystems, Inc. All Rights Reserved.">

13623N/A]>

13623N/A<?Pub UDT _bookmark _target>

13623N/A<?Pub Inc>

13623N/A<refentry id="defaultsession-5">

13623N/A<refmeta><refentrytitle>default.session.5</refentrytitle><manvolnum>5</manvolnum>

13623N/A<refmiscinfo class="date">11 Jan 2003</refmiscinfo>

13623N/A<refmiscinfo class="sectdesc">&man5;</refmiscinfo>

13623N/A<refmiscinfo class="software">&release;</refmiscinfo>

13623N/A<refmiscinfo class="arch">generic</refmiscinfo>

13623N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

13623N/A</refmeta>

13623N/A<indexterm><primary>default.session</primary></indexterm><indexterm><primary>

13623N/AGNOME default session configuration file</primary></indexterm><refnamediv

13623N/Aid="defaultsession-5-name"><refname>default.session</refname><refpurpose>GNOME default

13623N/Asession configuration file</refpurpose></refnamediv>

13623N/A<refsect1 id="defaultsession-5-desc"><title>&desc-tt;</title>

13623N/A<para>The <filename>/usr/share/gnome/default.session</filename> file contains

13623N/Aa list of programs to be launched the first time that a user logs into the

13623N/AGNOME environment.</para>

13623N/A</refsect1>

13623N/A<refsect1 id="defaultsession-5-exde"><title>&exde-tt;</title>

13623N/A<para>The format of the <filename>/usr/share/gnome/default.session</filename>

13623N/Afile is the same as that used by the <filename>gnome_config</filename> libraries,

13623N/Aas follows:</para>

13623N/A<para><screen><computeroutput>[Section]

13623N/ASEQID,id=<replaceable>uniqueid</replaceable>

13623N/ASEQID,Priority=<replaceable>prio</replaceable>

13623N/ASEQID,RestartCommand=<replaceable>command</replaceable>

13623N/Anum_clients=<replaceable>top</replaceable></computeroutput></screen></para>

13623N/A<para>A section with the predefined name of Default specifies the session

13623N/Ato load by default.</para>

13623N/A<para>As the <filename>gnome_config</filename> file format is not very flexible,

13623N/Aan array of data is emulated by listing, starting from 0, chunks of "id,Priority,RestartCommand".

13623N/AAt the end, the <literal>num_clients</literal> variable lists the number of

13623N/Achunks listed.</para>

13623N/A<para>The <literal>uniqueid</literal> key provides a name that is unique within

13623N/Athis file and passed to the application as the client id, which it must use

13623N/Ato register with <filename>gnome-session</filename>.</para>

13623N/A<para>The <literal>RestartCommand</literal> specifies the command to run from

13623N/A$PATH.</para>

13623N/A<para>The <literal>Priority</literal> determines the order in which the commands

13623N/Aare started (with Priority = 0 first) and defaults to 50.</para>

13623N/A<para>The clients must be numbered from 0 to the value of {<literal>

13623N/Anum_clients</literal>-1}.</para>

13623N/A</refsect1>

13623N/A<refsect1 id="defaultsession-5-file"><title>&file-tt;</title>

13623N/A<para>The following files are used by this application:</para>

13623N/A<variablelist termlength="wholeline">

13623N/A<varlistentry><term><filename>/usr/share/gnome/&cmd;</filename>

13623N/A</term><listitem><para>Location of default session file.</para>

13623N/A</listitem></varlistentry>

13623N/A<varlistentry><term><filename>~/.gnome2/session</filename></term><listitem>

13623N/A<para>User session file.</para>

13623N/A</listitem></varlistentry>

13623N/A</variablelist></refsect1>

13623N/A<refsect1 id="defaultsession-5-attr"><title>&attr-tt;</title>

13623N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

13623N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

13623N/Afor descriptions of the following attributes:</para>

13623N/A<informaltable frame="all">

13623N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

13623N/A<colspec colname="COLSPEC1" colwidth="1*">

13623N/A<thead>

13623N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

13623N/Avalign="middle">ATTRIBUTE VALUE</entry></row>

13623N/A</thead>

13623N/A<tbody>

18745N/A<row><entry><para>Availability</para></entry><entry><para>gnome/gnome-session

13623N/A</para></entry></row>

13623N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

13623N/Acolname="COLSPEC1"><para>Volatile</para></entry></row>

13623N/A</tbody>

13623N/A</tgroup>

13623N/A</informaltable>

13623N/A</refsect1>

13623N/A<refsect1 id="defaultsession-5-also"><title>&also-tt;</title>

13623N/A<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.</para>

13623N/A<para>

13623N/A<citerefentry><refentrytitle>gnome-session</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

13623N/A<citerefentry><refentrytitle>gnome-session-remove</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

13623N/A<citerefentry><refentrytitle>gnome-session-save</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>

13623N/A</refsect1>

13623N/A<refsect1 id="defaultsession-5-note"><title>&note-tt;</title>

13623N/A<para>Written by Brian Cameron, Sun Microsystems Inc., 2003, 2006.</para>

13623N/A</refsect1>

13623N/A</refentry>