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

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

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

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

18861N/A%commonents;

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

18861N/A%booktitles;

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

18861N/A]>

18861N/A<?Pub UDT _bookmark _target>

18861N/A<?Pub Inc>

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

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

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

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

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

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

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

18861N/A</refmeta>

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

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

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

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

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

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

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

18861N/AGNOME environment.</para>

18861N/A</refsect1>

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

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

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

18861N/Aas follows:</para>

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

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

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

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

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

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

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

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

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

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

19821N/Achunks listed.</para>

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

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

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

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

18861N/A$PATH.</para>

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

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

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

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

18861N/A</refsect1>

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

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

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

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

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

18861N/A</listitem></varlistentry>

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

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

19142N/A</listitem></varlistentry>

18861N/A</variablelist></refsect1>

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

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

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

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

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

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

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

18861N/A<thead>

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

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

18861N/A</thead>

18861N/A<tbody>

18861N/A<row><entry><para>Availability</para></entry><entry><para>SUNWgnome-session

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

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

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

18861N/A</tbody>

18861N/A</tgroup>

18861N/A</informaltable>

18861N/A</refsect1>

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

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

18861N/A<para>

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

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

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

18861N/A</refsect1>

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

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

18861N/A</refsect1>

18861N/A</refentry>

18861N/A