<!-- 
Fcron documentation
Copyright 2000-2004 Thibault Godouet <fcron@free.fr>
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation.
A copy of the license is included in gfdl.sgml.
-->

<!-- $Id: fcrontab.1.sgml,v 1.3 2007/01/01 18:53:46 thib Exp thib $ -->

  <refentry id="fcrontab.1">
    <refmeta>
      <refentrytitle>fcrontab</refentrytitle> <manvolnum>1</manvolnum>
      <refmiscinfo>Fcron &version; <![%devrelease; [
      (<emphasis>development</emphasis> release)]]></refmiscinfo>
      <refmiscinfo>&date;</refmiscinfo>
    </refmeta>
    <refnamediv>
      <refname>fcrontab</refname>
      <refpurpose>Manipuler les fichiers fcrontab utilisateur</refpurpose>
    </refnamediv>

    <refsynopsisdiv id="fcrontab.1.synopsis">
      <cmdsynopsis>
	<command>fcrontab</command>
	<arg>-c <replaceable>fichier</replaceable></arg>
	<arg>-n</arg> <arg choice="plain"><replaceable>fichier</replaceable></arg>
	<group>
	  <arg><replaceable>utilisateur</replaceable></arg>
	  <arg>-u <replaceable>utilisateur</replaceable></arg>
	</group>
      </cmdsynopsis>
      <cmdsynopsis>
	<command>fcrontab</command>
	<arg>-c <replaceable>fichier</replaceable></arg>
	<arg>-n</arg>
	<group choice="req">
	  <arg>-l</arg> <arg>-r</arg> <arg>-e</arg> <arg>-z</arg>
	</group>
	<group>
	  <arg><replaceable>utilisateur</replaceable></arg>
	  <arg>-u <replaceable>utilisateur</replaceable></arg>
	</group>
      </cmdsynopsis>
      <cmdsynopsis>
	<command>fcrontab</command> <arg>-h</arg>
      </cmdsynopsis>
    </refsynopsisdiv>

    <refsect1>
      <title>Description</title>
      <para>&Fcrontab; est le programme conçu pour installer, éditer, afficher
        et supprimer les tables utilisées par le démon <link
        linkend="fcron.8">&fcron;(8)</link>. Comme &fcron; utilise un format
        non humainement lisible (ceci est nécessaire car &fcron; enregistre
        beaucoup d'informations fournies par l'utilisateur, par exemple la
        date et l'heure de la prochaine exécution), l'utilisateur ne peut pas
        éditer directement son fichier &fcrontabf; (celui utilisé par &fcron;).
      </para>
      <para>Lorsqu'un utilisateur installe un &fcrontabf;, le fichier source
        est enregistré dans le répertoire de travail (Ndt&nbsp;: spool
        directory) (<filename>&fcrontabsdir;</filename>)
        pour permettre des éditions ultérieures, un fichier formaté est généré
        par le démon &fcron;, qui est averti dix secondes avant la minute
        suivante de toutes les modifications effectuées précédemment. Le démon
        &fcron; ne reçoit pas immédiatement le signal lui annonçant qu'un
        fichier &fcrontab; a été modifié, mais en reçoit au plus un par minute,
        de façon à éviter que des utilisateurs mal intentionnés ne gênent le
        fonctionnement de &fcron; en faisant des modifications incessantes
        d'un fichier &fcrontab; (c.-à-d. attaque en déni de service).
        Nous appellerons, dans la suite du document,
        «&nbsp;<emphasis>fcrontab</emphasis>&nbsp;» le fichier source des
        tables &fcrontabf;.</para>
      <para>Un utilisateur peut installer un &fcrontabf; si son nom est
        enregistré dans le fichier <filename>&etc;/&fcron.allow;</filename> et
        pas dans le fichier <filename>&etc;/&fcron.deny;</filename> (à moins
        qu'il n'y ait le mot clé «&nbsp;all&nbsp;»). Voir la section
        «&nbsp;<link linkend="fcrontab.1.files">FICHIERS</link>&nbsp;» plus
        loin. Si aucun des fichiers <filename>fcron.allow</filename> ou
        <filename>fcron.deny</filename> n'existe, tous les utilisateurs sont
        autorisés. Il n'est pas nécessaire que ces deux fichiers existent,
        mais s'ils existent, le fichier <filename>fcron.deny</filename> est
        prioritaire.
      </para>
      <para>La première forme de la commande est utilisée pour installer un
        nouveau fichier &fcrontabf;, à partir d'un nom de fichier ou de
        l'entrée standard si le pseudo nom de fichier «&nbsp;-&nbsp;» est
        fourni sur la ligne de commande, remplaçant le fichier précédent (s'il
        existait)&nbsp;: chaque utilisateur ne peut avoir qu'un seul fichier
        &fcrontabf;.
      </para>
      <para>Par exemple, le super-utilisateur peut créer un fichier fcrontab
        pour le système, disons <filename>/etc/fcrontab</filename>, et lancer
        «&nbsp;<command>fcrontab</command> <filename>/etc/fcrontab</filename>&nbsp;»
        pour installer la nouvelle version après chaque modification du
        fichier. Ou bien, il peut créer un nouveau fichier fcrontab en lançant
        simplement «&nbsp;<command>fcrontab</command>&nbsp;», et le maintenir
        par la suite en lançant «&nbsp;<command>fcrontab</command>
        <option>-e</option>&nbsp;». Les mêmes considérations s'appliquent à un
        utilisateur normal.
      </para>
    </refsect1>

    <refsect1>
      <title>Options</title>
      <variablelist>
	<varlistentry>
	  <term><option>-u</option> <replaceable>utilisateur</replaceable></term>
	  <listitem>
	    <para>Spécifier l'utilisateur dont le &fcrontabf; sera géré, ou
              «&nbsp;&sysfcrontab;&nbsp;» pour le fcrontab système. Ne peut
              être utilisée que par le super-utilisateur. S'il n'est pas
              fourni, le fichier &fcrontabf; de l'utilisateur qui a invoqué
              &fcrontab; sera traité. Cela peut être pratique puisque la
              commande <application>su</application>(8) peut tromper &fcrontab;.
              <note>
                <para>l'«&nbsp;<replaceable>utilisateur</replaceable>&nbsp;»
                  dans le <link linkend="fcrontab.1.synopsis">synopsys</link>
                  est équivalent à «&nbsp;<option>-u</option>
                  <replaceable>utilisateur</replaceable>&nbsp;».
                </para>
              </note>
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-l</option></term>
	  <listitem>
	    <para>Afficher sur la sortie standard le &fcrontabf; actuel de
              l'utilisateur.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-e</option></term>
	  <listitem>
            <para>Éditer le &fcrontabf; actuel de l'utilisateur en utilisant
              l'éditeur spécifié soit par la variable d'environnement
              <envar>VISUAL</envar>,  soit par la variable d'environnement
              <envar>EDITOR</envar> si <envar>VISUAL</envar> n'est pas
              positionnée. Si aucune des deux n'est positionnée,
              <command>&editor;</command> sera utilisée.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-r</option></term>
	  <listitem>
	    <para>Effacer le &fcrontabf; de l'utilisateur.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-z</option></term>
	  <listitem>
            <para>Réinstaller le &fcrontabf; de l'utilisateur à partir de son
              code source. Toutes les informations que &fcron; aurait pu
              conserver dans le &fcrontabf; binaire (comme l'heure et la date
              de la prochaine exécution) seront perdues.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-n</option></term>
	  <listitem>
	    <para>Ignorer la version précédente. Si cette option n'est pas
              fournie, &fcron; essayera de conserver le plus d'informations
              possibles entre l'ancienne et la nouvelle version du &fcrontabf;
              (date et heure de la prochaine exécution, la tâche est-elle dans
              une file série, etc.) si la ligne n'a pas été modifiée (mêmes
              champs, même commande shell).
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-c</option> <replaceable>fichier</replaceable></term>
	  <listitem>
	    <para>Forcer &fcrontab; à utiliser le fichier de configuration
              <replaceable>fichier</replaceable> à la place du fichier de
              configuration par défaut
              <filename>&etc;/&fcron.conf.location;</filename>. Pour interagir
              avec un processus &fcron; existant, &fcrontab; doit utiliser le
              même fichier de configuration que le processus. De cette manière,
              plusieurs processus &fcron; peuvent être exécutés simultanément
              sur un même système.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-d</option></term>
	  <listitem>
	    <para>Démarrer en mode débogage. Dans ce mode, beaucoup de messages
              d'informations seront produits en sortie afin de vérifier que
              tout se passe bien.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-h</option></term>
	  <listitem>
	    <para>Afficher une brève description des options.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><option>-V</option></term>
	  <listitem>
            <para>Afficher un message d'information à propos de &fcrontab;.
              Cela inclut sa version et la licence sous laquelle il est
              distribué.
            </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </refsect1>

    <refsect1>
      <title>Valeurs renvoyÉes</title>
      <para>&Fcrontab; renvoie &exitok; lorsqu'il quitte normalement, et
        &exiterr; en cas d'erreur.
      </para>
    </refsect1>

    <refsect1>
      <title>ConformitÉ</title>
      <para>Devrait être conforme aux spécifications POSIX.</para>
    </refsect1>

    <refsect1 id="fcrontab.1.files">
      <title>Fichiers</title>
      <variablelist>
	<varlistentry>
	  <term><filename>&etc;/&fcron.conf.location;</filename></term>
	  <listitem>
            <para>Fichier de configuration de &fcron;, &fcrontab et &fcrondyn;&nbsp;:
              contient les chemins (répertoire spool, fichier pid) et les
              programmes par défaut à utiliser (éditeur, shell, etc.). Voir
              <link linkend="fcron.conf.5">&fcron.conf(5)</link> pour plus de
              détails.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><filename>&etc;/&fcron.allow;</filename></term>
	  <listitem>
            <para>Utilisateurs autorisés à utiliser &fcrontab; et &fcrondyn;
              (un seul nom par ligne, le nom spécial «&nbsp;all&nbsp;»
              signifiant tout le monde).
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><filename>&etc;/&fcron.deny;</filename></term>
	  <listitem>
            <para>Utilisateurs autorisés à utiliser &fcrontab; et &fcrondyn;
              (un seul nom par ligne, le nom spécial «&nbsp;all&nbsp;»
              signifiant tout le monde).
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><filename>&etc;/pam.d/fcron</filename> (or
	    <filename>&etc;/pam.conf</filename>)</term>
	  <listitem>
            <para>Fichier de configuration <productname>PAM</productname> pour
              &fcron;. Voir &pam;(8) pour plus de détails.
            </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </refsect1>

    &manpage-foot;

    <refsect1>
      <title>Traduction</title>
      <para>Ce document est une traduction réalisée par Alain Portal
        &lt;aportal AT univ-montp2 DOT fr&gt; le 6 février 2006
      </para>
      <para>L'équipe de traduction a fait le maximum pour réaliser une adaptation
        française de qualité. La version anglaise la plus à jour de ce document
        est toujours consultable via la commande&nbsp;: «&nbsp;<emphasis>LANG=en
        man 1 fcrontab</emphasis>&nbsp;».
        N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas,
        toute erreur dans cette page de manuel.
      </para>
    </refsect1>

  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-parent-document:("fcron-doc.sgml" "book" "chapter" "sect1" "")
End:
-->
