<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2006/350 GNOME System Tools-->
<!ENTITY cmd "time-admin">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="time-admin-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>time-admin</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">6 Nov 2006</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>time-admin</primary></indexterm>
<indexterm><primary>Basic configuration of system time, date, timezone and NTP client.</primary></indexterm>

<refnamediv id="time-admin-1-name">
  <refname>time-admin</refname>
  <refpurpose>Basic configuration of system time, date, timezone and NTP client.</refpurpose>
</refnamediv>

<refsynopsisdiv id="time-admin-1-synp">
  <title>&synp-tt;</title>
  <cmdsynopsis>
    <command>&cmd;</command>
    <arg><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>
  </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="time-admin-1-desc">
  <title>&desc-tt;</title>
  <para><command>&cmd;</command> enables the user to configure the default timezone and current date/time on the system. It also enables the user to turn on auto-synchronisation of this using NTP.</para>
</refsect1>

<refsect1 id="time-admin-1-opts">
  <title>&opts-tt;</title>
  <para>The following options are supported:</para>
  <variablelist termlength="wide">
    <varlistentry>
      <term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>
      <listitem>
        <para>Standard options available for use with most GNOME applications. See <citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</para>
      </listitem>
    </varlistentry>
  </variablelist>
</refsect1>

<refsect1 id="time-admin-1-exam">
  <title>&exam-tt;</title>
  <example role="example">
    <title>Running the main application.</title>
    <para><screen>example% <userinput>&cmd;</userinput></screen></para>
  </example>
</refsect1>

<refsect1 id="time-admin-1-exit"><title>&exit-tt;</title>
<para>The following exit values are returned:</para>
<variablelist termlength="xtranarrow">
  <varlistentry>
    <term><returnvalue>0</returnvalue></term>
    <listitem><para>Application exited successfully</para></listitem>
  </varlistentry>
  <varlistentry>
    <term><returnvalue>&gt;0</returnvalue></term>
    <listitem><para>Application exited with failure</para></listitem>
  </varlistentry>
</variablelist></refsect1>

<refsect1 id="time-admin-1-file">
  <title>&file-tt;</title>
  <para>The following files are used by this application:</para>
  <variablelist termlength="wide">
    <varlistentry>
      <term><filename>/usr/bin/&cmd;</filename></term>
      <listitem>
        <para>Executable for time and date configuration.</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><filename>/var/spool/setup-tool-backends/backup/time</filename></term>
      <listitem>
        <para></para>
        <para>Backup directory for files that are modified.</para> 
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><filename>/var/run/setup-tool-backends/debug/time</filename></term>
      <listitem>
        <para></para>
        <para>Debug logs can be found under here.</para> 
      </listitem>
    </varlistentry>
  </variablelist>
</refsect1>

<refsect1 id="time-admin-1-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>desktop/administration/gnome-system-tools</para></entry>
        </row>
        <row> 
          <entry colname="COLSPEC0"><para>Interface stability</para></entry>
          <entry colname="COLSPEC1"><para>Uncommitted</para></entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>
</refsect1>

<refsect1 id="time-admin-1-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>users-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>shares-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>services-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>network-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>rtc</refentrytitle><manvolnum>1M</manvolnum></citerefentry>,
<citerefentry><refentrytitle>ntpdate</refentrytitle><manvolnum>1M</manvolnum></citerefentry>,
<citerefentry><refentrytitle>xntpd</refentrytitle><manvolnum>1M</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</refsect1>

<refsect1 id="time-admin-1-note"><title>&note-tt;</title>
    <para></para>
    <para>Written by Darren Kenny, Sun Microsystems Inc., 2006.</para>
</refsect1>

</refentry>

