.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "FCRONTAB" "1" "05 December 2021" "12/05/2021" ""
.SH NAME
fcrontab \- Manipuler les fichiers fcrontab utilisateur
.SH SYNOPSIS
\fBfcrontab\fR [ \fB-c \fIfichier\fB\fR ] [ \fB-n\fR ] \fB\fIfichier\fB\fR [ \fB\fIutilisateur\fB\fR | \fB-u \fIutilisateur\fB\fR ]
\fBfcrontab\fR [ \fB-c \fIfichier\fB\fR ] [ \fB-n\fR ] { \fB-l\fR | \fB-r\fR | \fB-e\fR | \fB-z\fR } [ \fB\fIutilisateur\fB\fR | \fB-u \fIutilisateur\fB\fR ]
\fBfcrontab\fR [ \fB-h\fR ]
.SH "DESCRIPTION"
.PP
\fBFcrontab\fR est le programme conçu pour installer, éditer, afficher
et supprimer les tables utilisées par le démon \fBfcron\fR(8)\&. Comme \fBfcron\fR utilise un format
non humainement lisible (ceci est nécessaire car \fBfcron\fR 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 \fBfcrontab\fR (celui utilisé par \fBfcron\fR).
.PP
Lorsqu'un utilisateur installe un \fBfcrontab\fR, le fichier source
est enregistré dans le répertoire de travail (Ndt\~: spool
directory) (\fI/usr/local/var/spool/fcron\fR)
pour permettre des éditions ultérieures, un fichier formaté est généré
par le démon \fBfcron\fR, qui est averti dix secondes avant la minute
suivante de toutes les modifications effectuées précédemment. Le démon
\fBfcron\fR ne reçoit pas immédiatement le signal lui annonçant qu'un
fichier \fBfcrontab\fR 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 \fBfcron\fR en faisant des modifications incessantes
d'un fichier \fBfcrontab\fR (c.-à-d. attaque en déni de service).
Nous appellerons, dans la suite du document,
«\~\fBfcrontab\fR\~» le fichier source des
tables \fBfcrontab\fR\&.
.PP
Un utilisateur peut installer un \fBfcrontab\fR si son nom est
enregistré dans le fichier \fI/usr/local/etc/fcron.allow\fR et
pas dans le fichier \fI/usr/local/etc/fcron.deny\fR (à moins
qu'il n'y ait le mot clé «\~all\~»). Voir la section
«\~FICHIERS\~» plus
loin. Si aucun des fichiers \fIfcron.allow\fR ou
\fIfcron.deny\fR 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 \fIfcron.deny\fR est
prioritaire.
.PP
La première forme de la commande est utilisée pour installer un
nouveau fichier \fBfcrontab\fR, à partir d'un nom de fichier ou de
l'entrée standard si le pseudo nom de fichier «\~-\~» est
fourni sur la ligne de commande, remplaçant le fichier précédent (s'il
existait)\~: chaque utilisateur ne peut avoir qu'un seul fichier
\fBfcrontab\fR\&.
.PP
Par exemple, le super-utilisateur peut créer un fichier fcrontab
pour le système, disons \fI/etc/fcrontab\fR, et lancer
«\~\fBfcrontab\fR \fI/etc/fcrontab\fR\~»
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 «\~\fBfcrontab\fR\~», et le maintenir
par la suite en lançant «\~\fBfcrontab\fR
\fB-e\fR\~». Les mêmes considérations s'appliquent à un
utilisateur normal.
.SH "OPTIONS"
.TP
\fB-u \fIutilisateur\fB\fR
Spécifier l'utilisateur dont le \fBfcrontab\fR sera géré, ou
«\~systab\~» pour le fcrontab système. Ne peut
être utilisée que par le super-utilisateur. S'il n'est pas
fourni, le fichier \fBfcrontab\fR de l'utilisateur qui a invoqué
\fBfcrontab\fR sera traité. Cela peut être pratique puisque la
commande \fBsu\fR(8) peut tromper \fBfcrontab\fR\&.
.sp
.RS
.B "Note:"
l'«\~\fIutilisateur\fR\~»
dans le synopsys
est équivalent à «\~\fB-u\fR
\fIutilisateur\fR\~».
.RE
.TP
\fB-l\fR
Afficher sur la sortie standard le \fBfcrontab\fR actuel de
l'utilisateur.
.TP
\fB-e\fR
Éditer le \fBfcrontab\fR actuel de l'utilisateur en utilisant
l'éditeur spécifié soit par la variable d'environnement
\fBVISUAL\fR, soit par la variable d'environnement
\fBEDITOR\fR si \fBVISUAL\fR n'est pas
positionnée. Si aucune des deux n'est positionnée,
\fB/usr/bin/vi\fR sera utilisée.
.TP
\fB-r\fR
Effacer le \fBfcrontab\fR de l'utilisateur.
.TP
\fB-z\fR
Réinstaller le \fBfcrontab\fR de l'utilisateur à partir de son
code source. Toutes les informations que \fBfcron\fR aurait pu
conserver dans le \fBfcrontab\fR binaire (comme l'heure et la date
de la prochaine exécution) seront perdues.
.TP
\fB-n\fR
Ignorer la version précédente. Si cette option n'est pas
fournie, \fBfcron\fR essayera de conserver le plus d'informations
possibles entre l'ancienne et la nouvelle version du \fBfcrontab\fR
(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).
.TP
\fB-c \fIfichier\fB\fR
Forcer \fBfcrontab\fR à utiliser le fichier de configuration
\fIfichier\fR à la place du fichier de
configuration par défaut
\fI/usr/local/etc/fcron.conf\fR\&. Pour interagir
avec un processus \fBfcron\fR existant, \fBfcrontab\fR doit utiliser le
même fichier de configuration que le processus. De cette manière,
plusieurs processus \fBfcron\fR peuvent être exécutés simultanément
sur un même système.
.TP
\fB-d\fR
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.
.TP
\fB-h\fR
Afficher une brève description des options.
.TP
\fB-V\fR
Afficher un message d'information à propos de \fBfcrontab\fR\&.
Cela inclut sa version et la licence sous laquelle il est
distribué.
.SH "VALEURS RENVOYÉES"
.PP
\fBFcrontab\fR renvoie 0 lorsqu'il quitte normalement, et
1 en cas d'erreur.
.SH "CONFORMITÉ"
.PP
Devrait être conforme aux spécifications POSIX.
.SH "FICHIERS"
.TP
\fB\fI/usr/local/etc/fcron.conf\fB\fR
Fichier de configuration de \fBfcron\fR, \fBfcrontab\fR et \fBfcrondyn\fR\~:
contient les chemins (répertoire spool, fichier pid) et les
programmes par défaut à utiliser (éditeur, shell, etc.). Voir
\fBfcron.conf\fR(5) pour plus de
détails.
.TP
\fB\fI/usr/local/etc/fcron.allow\fB\fR
Utilisateurs autorisés à utiliser \fBfcrontab\fR et \fBfcrondyn\fR
(un seul nom par ligne, le nom spécial «\~all\~»
signifiant tout le monde).
.TP
\fB\fI/usr/local/etc/fcron.deny\fB\fR
Utilisateurs autorisés à utiliser \fBfcrontab\fR et \fBfcrondyn\fR
(un seul nom par ligne, le nom spécial «\~all\~»
signifiant tout le monde).
.TP
\fB\fI/usr/local/etc/pam.d/fcron\fB (or \fI/usr/local/etc/pam.conf\fB)\fR
Fichier de configuration PAM pour
\fBfcron\fR\&. Voir \fBpam\fR(8) pour plus de détails.
.SH "VOIR AUSSI"
\fBfcrontab\fR(1),
\fBfcrondyn\fR(1),
\fBfcrontab\fR(5),
\fBfcron.conf\fR(5),
\fBfcron\fR(8).
Si vous êtes en train d'apprendre à utiliser fcron, je vous
suggère plutôt de lire la version HTML de la documentation (si ce n'est pas
déjà ce que vous faites en ce moment\~! :) )\~: le contenu est le même, mais
il est plus aisé de naviguer grâce aux hyperliens.
.SH "AUTEUR"
.PP
Thibault Godouet
.SH "TRADUCTION"
.PP
Ce document est une traduction réalisée par Alain Portal
le 6 février 2006
.PP
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\~: «\~\fBLANG=en
man 1 fcrontab\fR\~».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas,
toute erreur dans cette page de manuel.