Passbolt/fcron-3.2.0/doc/fr/fcrontab.1.sgml

296 lines
12 KiB
Plaintext

<!--
Fcron documentation
Copyright 2000-2014 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.
-->
<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:
-->