.\" Traduction 15/01/1997 par Christophe Blaess (ccb@club-internet.fr)
.\"
.TH FIND 1L "15 Janvier 1997" FSF "Manuel de l'utilisateur Linux"
.SH NOM
find \- Rechercher des fichiers dans une hierarchie de repertoires.
.SH SYNOPSIS
.B find
[chemin...] [expression]
.SH DESCRIPTION
Cette page de manuel documente la version GNU de
.BR find .

.B find
parcourt les arborescences de repertoires commencant
en chacun des \fIchemins\fP mentionnes, en evaluant les
expressions fournies pour chaque fichier rencontre.

L'evaluation de l'expression se fait de gauche a droite,
en suivant des regles de precedence decrite dans la section
OPERATEURS, jusqu'a ce que le resultat soit connu (par exemple
la partie gauche vraie pour un operateur \fIOU\fP ou fausse
pour un operateur \fIET\fP).
.PP
Le premier argument commencant par `\-', `(', `)', `,', ou `!' 
est considere comme le debut de l'expression, tous les arguments
precedents sont des chemins a parcourir. 

Tous les arguments ulterieurs
sont consideres comme le reste de l'expression reguliere.

Si aucun \fIchemin\fP n'est mentionne, le repertoire en cours sert
de point de depart. 

Si aucune \fIexpression\fP n'est fournie, \fBfind\fP
utilise l'expression `\-print' par defaut.
.PP
.B find
se termine avec le code de retour 0 si tous les fichiers ont pu etre
examines correctement, et superieur a 0 si une erreur s'est produite.
.SH EXPRESSIONS
.P
L'expression est constituee d'\fBoptions\fP (affectant l'ensemble des operations
plutot que le traitement d'un fichier particulier, et renvoyant toujours
vrai), de \fBtests\fP (renvoyant une valeur vraie ou fausse), et d'\fBactions\fP
(ayant des effets de bords et renvoyant une valeur vraie ou fausse),
tous ces elements etant separes par des operateurs.

Quand un operateur est manquant, l'operation par defaut \-and est
appliquee.
Si l'expression ne contient pas d'action autre que \-prune,
\fBfind\fP applique l'action \-print par defaut sur tous les fichiers
pour lesquels l'expression est vraie.
.SS OPTIONS
.P
Toutes les options renvoient toujours la valeur vraie. Elles ont
toujours un effet global, plutot que de s'appliquer uniquement a
leur emplacement dans l'expression.
Neanmoins, pour ameliorer la lisibilite, il est preferable de les
placer au debut de l'expression.
.IP \-daystart
Mesurer les temps (avec \-amin, \-atime, \-cmin, \-ctime, \-mmin, et \-mtime)
depuis le debut de la journee plutot que depuis 24 heures.
.IP \-depth
Traiter d'abord les sous-repertoires avant le repertoire lui-meme.
.IP \-follow
Dereferencer les liens symboliques pour acceder aux fichiers vers lesquels
ils pointent. Ceci implique l'option \-noleaf.
.IP "\-help, \-\-help"
Afficher un message d'aide sur la  sortie  standard et terminer normalement.
.IP "\-maxdepth \fIn\fR"
Descendre au plus \fIn\fP niveaux (\fIn\fP etant un entier positif ou nul),
dans les repertoires parcourus. `\-maxdepth 0' signifie que les tests
et les actions ne s'appliquent qu'aux arguments de la ligne de commande.
.IP "\-mindepth \fIn\fR"
Ne pas apppliquer les tests ou les actions a des niveaux de profondeur
inferieurs a \fIn\fP. \fIn\fP est un entier positif ou nul.
`\-mindepth 1' signifie que les tests et les actions s'appliquent a tous
les fichiers sauf aux arguments de la ligne de commande.
.IP \-mount
Ne pas parcourir les repertoires situes sur d'autres systemes de fichiers.
Il s'agit d'une alternative a l'option \-xdev, assurant la compatibilite
avec d'anciennes versions de
.BR find .
.IP "\-noleaf"
Ne pas faire d'optimisation en supposant que les repertoires contiennent
2 fois moins de sous-repertoires que leurs nombres de liens physiques.
Cette option est necessaires lorsque l'on parcoure des systemes de
fichiers ne suivant pas les conventions Unix sur les liens de repertoires,
comme les systemes MS-DOS, les CD-ROM ou les points de montage de
volumes AFS.
Chaque repertoire sur un systeme de fichiers Unix dispose au moins
de deux liens physiques, son nom et `.'. De plus chaque sous-repertoire
a egalement un lien `..' vers le repertoire parent.
Quand
.B find
examine un repertoire, il sait qu'il y a 2 fois moins de sous-repertoires
que de liens vers le repertoire. Une fois qu'il a rencontre le
nombre prevu de sous-repertoires, il est donc sur que le reste des
entrees est constitue de fichiers autres que des sous-repertoires.
Ces fichiers sont des feuilles ([NDT] `leaf') dans l'arborescence des 
repertoires.
S'il n'y a que les noms de fichiers a examiner, il n'a plus besoin de
verifier leur nature, et ceci fournit une augmentation notable de
la vitesse de traitement.
.IP "\-version, \-\-version"
Afficher  un  numero de version sur la sortie standard et terminer normalement.
.IP \-xdev
Ne pas parcourir les repertoires situes sur d'autres systemes de fichiers.
.SS TESTS
.P
Les arguments numeriques peuvent etre indiques comme suit :
.IP \fI+n\fP
superieur a
.IR n ,
.IP \fI\-n\fP
inferieur a
.IR n ,
.IP \fIn\fP
egal a
.IR n .
.IP "\-amin \fIn\fR"
dernier acces au fichier il y a \fIn\fP minutes.
.IP "\-anewer \fIfile\fR"
dernier acces au fichier plus recent que la derniere modification de
\fIfile\fR.
Le comportement de l'option \-anewer est modifie par l'option \-follow 
uniquement si celle-ci la precede sur la ligne de commande.
.IP "\-atime \fIn\fR"
dernier acces au fichier il y a \fIn\fR*24 heures.
.IP "\-cmin \fIn\fR"
derniere modification du statut du fichier il y a \fIn\fR minutes.
.IP "\-cnewer \fIfile\fR"
derniere modification du statut du fichier plus recente que la derniere
modification du fichier \fIfile\fR.
Le comportement de l'option \-cnewer est modifie par l'option \-follow
uniquement si celle-ci la precede sur la ligne de commande.
.IP "\-ctime \fIn\fR"
derniere modification du statut du fichier il y a \fIn\fR*24 heures.
.IP \-empty
fichier vide. De plus ce fichier doit etre regulier ou etre un repertoire.
.IP \-false
toujours faux.
.IP "\-fstype \fItype\fR"
fichier se trouvant sur un systeme de fichiers du \fItype\fR indique.
Les types de systemes de fichiers dependent de la version d'Unix. Une
liste non-exhaustive des systemes acceptes sur certaines versions d'Unix
sont : ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K.  Vous pouvez utiliser
\-printf avec la directive %F pour examiner les types de vos systemes de
fichiers.
.IP "\-gid \fIn\fR"
Fichier de GID numerique valant \fIn\fR.
.IP "\-group \fInom_groupe\fR"
fichier appartenant au groupe \fInom_groupe\fR (eventuellement ID numerique).
.IP "\-ilname \fImotif\fR"
identique a \-lname, mais sans differencier les majuscules et les minuscules.
.IP "\-iname \fIpattern\fR"
identique a \-name, mais sans differencier les majuscules et les minuscules. Par
exemple les motifs `fo*' et `F??' correspondent aux noms de fichiers `Foo',
`FOO', `foo', `fOo', etc...
.IP "\-inum \fIn\fR"
fichier dont le numero d'i-noeud est \fIn\fR.
.IP "\-ipath \fImotif\fR"
identique a \-path, mais sans differencier les majuscules et les minuscules.
.IP "\-iregex \fImotif\fR"
identique a \-regex, mais sans differencier les majuscules et les minuscules.
.IP "\-links \fIn\fR"
fichier ayant \fIn\fR liens.
.IP "\-lname \fImotif\fR"
fichier representant un lien symbolique, dont le contenu correspond au
\fImotif\fP indique. Lors du developpement des meta-caracteres, `/' et `.'
ne sont pas traites differement des autres caracteres (voir l'exemple dans
la description de l'option \-path).
.IP "\-mmin \fIn\fR"
Fichier dont les donnees ont ete modifiees il y a \fIn\fR minutes.
.IP "\-mtime \fIn\fR"
Fichier dont les donnees ont ete modifiees il y a \fIn\fR*24 heures.
.IP "\-name \fImotif\fR"
Fichier dont le nom de base (sans les repertoires du chemin d'acces),
correspond au \fImotif\fR du shell.  Les meta-caracteres (`*', `?',
et `[]') ne sont jamais mis en correspondance avec un point `.' 
au debut du nom.  Pour ignorer un repertoire, ainsi que tous ses
sous-repertoires, utilise l'option \-prune; vous trouverez un exemple dans
la description de l'option \-path.
.IP "\-newer \fIfichier\fR"
Fichier modifie plus recemment que le \fIfichier\fR indique.
L'option \-newer n'est affectee par l'option \-follow que si celle-ci la
precede sur la ligne de commande.
.IP \-nouser
Fichier dont l'U-ID numerique ne correspond a aucun utilisateur.
.IP \-nogroup
Fichier dont le G-ID numerique ne correspond a aucun groupe d'utilisateurs.
.IP "\-path \fImotif\fR"
Fichier dont le nom complet correspond au \fImotif\fR fourni. Lors du developpement des meta-caracteres, `/' et `.'
ne sont pas traites differement des autres caracteres, ainsi par exemple :
.br
.in +1i
find . \-path './sr*sc'
.br
.in -1i
affichera l'element de repertoire intitule './src/misc' (s'il en existe un).
Pour ignorer une arborescence complete de repertoires, utilisez l'option
\-prune plutot que de verifier chaque fichier de l'arbre. Par exemple, pour
ignorer le repertoire `src/emacs' et tous ses sous-repertoires, tout en
affichant le nom de tous les autres fichier, faites quelque chose comme :
.br
.in +1i
find . \-path './src/emacs' -prune -o -print
.br
.in -1i
.IP "\-perm \fImode\fR"
Fichier dont les autorisations d'acces sont fixees exactement au \fImode\fR 
indique (en notation symbolique ou octale). La notation symbolique utilise
le mode 0 comme point de depart.
.IP "\-perm \-\fImode\fR"
Fichier ayant au moins toutes les autorisations indiquees dans le \fImode\fP.
.IP "\-perm +\fImode\fR"
Fichier ayant certaines des autorisations indiquees dans le \fImode\fP.
.IP "\-regex \fImotif\fR"
Nom de fichier correspondant a l'expression reguliere \fImotif\fR.
Il s'agit d'une correspondance sur le nom de fichier complet, pas d'une
recherche. Par exemple, pour mettre en correspondance un fichier nomme
`./fubar3', vous pouvez tiliser les expressions regulieres `.*bar.' ou `.*b.*3',
mais pas `b.*r3'.
.IP "\-size \fIn\fR[bckw]"
Fichier utilisant \fIn\fP unites d'espace.  Les unites sont des blocs de 512
octets par defaut, ou si un suffixe `b' suit le nombre \fIn\fP, 
des octets si un suffixe `c' suit \fIn\fP, des kilo-octets si un suffixe `k'
est utilise, ou des mots de 2 octets si un `w' suit le nombre \fIn\fP.
La taille ne prend pas en compte les blocs indirects, mais elle comptabilise
les blocs des fichiers eparpilles pas encore alloues.
.IP \-true
Toujours vrai.
.IP "\-type \fIc\fR"
Fichier du type \fIc\fR:
.RS
.IP b
fichier special en mode bloc (avec buffer)
.IP c
fichier special en mode caractere (sans buffer)
.IP d
repertoire
.IP p
tube nomme (FIFO)
.IP f
fichier regulier
.IP l
liens symbolique
.IP s
socket
.RE
.IP "\-uid \fIn\fR"
Fichier dont l'U-ID numerique vaut \fIn\fR.
.IP "\-used \fIn\fR"
fichier dont le dernier acces date de \fIn\fP jours apres la derniere modification
de son statut.
.IP "\-user \fIutilisateur\fR"
fichier appartenant a l'\fIutilisateur\fP indique (U-ID numerique eventuellement)
.IP "\-xtype \fIc\fR"
comme \-type sauf si le fichier est un lien symbolique. Dans ce cas,
si l'option \-follow n'a pas ete fournie, le test est vrai si le fichier
destination du lien est de type \fIc\fR; Si l'option \-follow a ete reclamee,
le test est vrai si \fIc\fR vaut `l'.
Autrement dit, pour les liens symboliques, \-xtype verifie le type des fichiers
que l'option \-type ne verifie pas.
.SS ACTIONS
.IP "\-exec \fIcommande\fR ;"
Execute la \fIcommande\fR; vrai si le code de retour 0 est renvoye. Tous les arguments
suivants de 
.B find
sont consideres comme des arguments pour la ligne de commande, jusqu'a ce qu'on
rencontre un `;'. La chaine `{}' est remplacee par le nom du fichier en cours de
traitement, et ceci dans toutes ses occurences, pas seulement aux endroits ou elle
est isolee, comme c'est le cas avec d'autres versions de
.BR find .
Ces deux chaines peuvent avoir besoin d'etre protegees du developpement de la ligne
de commande par le shell, en utilisant le caractere d'echappement (`\e') ou une
protection par des apostrophes. La commande est executee depuis le repertoire
de depart.
.IP "\-fls \fIfichier\fR"
vrai; comme \-ls mais ecrit dans le \fIfichier\fR comme le fait \-fprint.
.IP "\-fprint \fIfichier\fR"
vrai; ecrit le nom complet dans le \fIfichier\fR.  Si \fIfichier\fR
n'existe pas au demarrage de \fBfind\fR, il est cree. Si existe, il
est ecrase. Les noms de fichiers ``/dev/stdout'' et ``/dev/stderr''
sont traites de maniere specifique, ils correspondent respectivement 
a la sortie standard, et a la sortie des erreurs.
.IP "\-fprint0 \fIfichier\fR"
vrai; comme \-print0 mais ecrit dans le \fIfichier\fR comme le fait \-fprint.
.IP "\-fprintf \fIfichier\fR \fIformat\fR"
vrai; comme \-printf mais ecrit dans le \fIfichier\fR comme le fait \-fprint.
.IP "\-ok \fIcommande\fR ;"
comme \-exec mais interroge d'abord l'utilisateur (en utilisant l'entree standard).
Si la reponse ne commence pas par `y' ou `Y', la commande n'est pas executee, et
le test devient faux.
.IP \-print
vrai; affiche le nom complet du fichier sur la sortie standard, suivi d'un saut de
ligne.
.IP \-print0
vrai; affiche le nom complet du fichier sur la sortie standard, suivi d'un caractere
nul. Ceci permet aux fichiers dont le nom contient un saut de ligne, d'etre correctement
interpretes par les programmes utilisant les donnees en sortie de \fBfind\fP.
.IP "\-printf \fIformat\fR"
vrai; affiche le \fIformat\fR indique sur la sortie standard, en interpretant les
sequences d'echappement `\e' et les directives`%'.
La largeur et la precision des champs peuvent etre specifies comme dans
la fonction \fBprintf\fP(3) du langage C.
Contrairement a \-print, \-printf n'ajoute pas de saut de ligne a la fin
de la chaine. Les sequences d'echappement et les directives % sont les
suivantes :
.RS
.IP \ea
Sonnerie.
.IP \eb
Effacement Arriere (Backspace)
.IP \ec
Arreter immediatement l'impression du format et vider le flux de sortie.
.IP \ef
Saut de page
.IP \en
Saut de ligne
.IP \er
Retour Chariot
.IP \et
Tabulation horizontale
.IP \ev
Tabulation Verticale
.IP \e\e
Un caractere `Backslash' litteral (`\e').
.PP
Un `\e' suivi de n'importe quel autre caractere est
traite comme un caractere ordinaire; ils sont donc
affiches tous les deux.
.IP %%
Un caractere pourcentage litteral (%)
.IP %a
Date du dernier acces au fichier, dans le format renvoye par la
fonction C \fBctime\fP(3).
.IP %A\fIk\fP
Date du dernier acces au fichier, dans le format specifie par \fIk\fR,
qui doit etre soit un `@', soit une directive pour la fonction C
\fBstrftime\fP(3).  Les valeurs possibles pour \fIk\fP sont indiquees
ci-dessous, certaines d'entre-elles ne sont pas disponibles sur tous
les systemes, a cause des differences entre les fonctions \fBstrftime\fP(3) existantes.
.RS
.IP @
secondes ecoulees depuis le 1er Janvier 19700 a 00h00 GMT.
.PP
Champs horaires :
.IP H
heure (00..23)
.IP I
heure (01..12)
.IP k
heure ( 0..23)
.IP l
heure ( 1..12)
.IP M
minute (00..59)
.IP p
AM, ou PM, avec la designation locale
.IP r
heure, sur un cadran de 12 heures (hh:mm:ss [AP]M)
.IP S
secondes (00..61)
.IP T
heure, sur un cadran de 24 heures (hh:mm:ss)
.IP X
representation locale de l'heure (H:M:S)
.IP Z
fuseau horaire (par exemple MET), ou rien si le fuseau horaire
est indetermine.
.PP
Champs de date :
.IP a
abreviation locale du jour de la semaine (Sun..Sat)
.IP A
nom local entier du jour de la semaine, de longueur variable (Sunday..Saturday)
.IP b
abreviation locale du mois (Jan..Dec)
.IP B
nom local entier du mois, de longueur variable (January..December)
.IP c
date et heure locales (Sat Nov 04 12:02:33 EST 1989)
.IP d
quantieme du mois (01..31)
.IP D
date (mm/jj/aa)
.IP h
comme b
.IP j
jour de l'annee (001..366)
.IP m
mois (01..12)
.IP U
numero de la semaine dans l'annee, les semaines commencant le Dimanche (00..53)
.IP w
jour de la semaine (0..6), 0 correspond a Dimanche
.IP W
numero de la semaine dans l'annee, les semaines commencant le Lundi (00..53)
.IP x
representation locale de la date (mm/jj/aa)
.IP y
les deux dernier chiffres de l'annee
 (00..99)
.IP Y
annee (1970...)
.RE
.IP %b
Taille du fichier en nombre de blocs de 512 octets (arrondi par exces).
.IP %c
Date de derniere modification du statut du fichier, dans le format
renvoye par la fonction C \fBctime\fP(3).
.IP %C\fIk\fP
Date de derniere modification du statut du fichier, dans le format
specifie par \fIk\fR, comme pour la directive %A.
.IP %d
Profondeur du fichier dans l'arborescence des repertoires, 0 signifiant
que le fichier est un argument de la ligne de commande.
.IP %f
Nom du fichier, sans nom de repertoire.
.IP %F
Type de systeme de fichiers sur lequel se trouve le fichier. Cette
valeur peut etre utilisee pour l'option \-fstype.
.IP %g
Nom du groupe proprietaire du fichier, ou G-ID numerique si le groupe n'a pas de
nom.
.IP %G
G-ID numerique du fichier.
.IP %h
Repertoires en tete du nom de fichier, (tout sauf le dernier nom).
.IP %H
Argument de la ligne de commande a partir duquel le fichier a ete
trouve.
.IP %i
Numero d'i-noeud du fichier (en decimal).
.IP %k
Taille du fichier, en nombre de blocs de 1 Kilo-Octet, arrondi par exces.
.IP %l
Destination du lien symbolique (vide si le fichier n'est pas un lien symbolique).
.IP %m
Bits d'autorisation d'acces au fichier (en octal).
.IP %n
Nombre de liens physiques sur le fichier.
.IP %p
Nom du fichier.
.IP %P
Nom du fichier, ainsi que le nom de l'argument de ligne de commande
a partir duquel le fichier a ete trouve.
.IP %s
Taille du fichier en octets.
.IP %t
Date de derniere modification du fichier, dans le format
renvoye par la fonction C \fBctime\fP(3).
.IP %T\fIk\fP
Date de derniere modification du fichier, dans le format
specifie par \fIk\fR, comme pour la directive %A.
.IP %u
Nom du proprietaire du fichier, ou U-ID numerique si 
l'utilisateur n'a pas de nom.
.IP %U
U-ID numerique du proprietaire du fichier.
.PP
Un caractere `%' suivi de tout autre caractere est elimine (mais le
second caractere est affiche).
.RE
.IP \-prune
vrai si l'option \-depth n'est pas fournie; ne pas descendre dans l'arborescence
du repertoire en cours.
.br
faux si l'option \-depth est fournie, et sans effet.
.IP \-ls
vrai, affiche le nom du fichier en cours dans le format `ls \-dils' sur la sortie standard.
La taille est comptee en blocs de 1 Ko, a moins que la variable d'environnement
POSIXLY_CORRECT soit positionnee, auquel cas la taille est calculee en blocs de 512 octets.
.SS OPERATEURS
.P
Dans l'ordre de precedence decroissante :
.IP "( \fIexpr\fR )"
Force la precedence.
.IP "! \fIexpr\fR"
Vrai si \fIexpr\fR est fausse.
.IP "\-not \fIexpr\fR"
Comme ! \fIexpr\fR.
.IP "\fIexpr1 expr2\fR"
ET (implicite); \fIexpr2\fR n'est pas evaluee si \fIexpr1\fR est fausse.
.IP "\fIexpr1\fR \-a \fIexpr2\fR"
Comme \fIexpr1 expr2\fR.
.IP "\fIexpr1\fR \-and \fIexpr2\fR"
Comme \fIexpr1 expr2\fR.
.IP "\fIexpr1\fR \-o \fIexpr2\fR"
OU; \fIexpr2\fR n'est pas evaluee si \fIexpr1\fR est vraie.
.IP "\fIexpr1\fR \-or \fIexpr2\fR"
Comme \fIexpr1\fR \-o \fIexpr2\fR.
.IP "\fIexpr1\fR , \fIexpr2\fR"
Liste; \fIexpr1\fR et \fIexpr2\fR sont toujours evaluees toutes les deux.
La valeur de \fIexpr1\fR est ignoree; la valeur de la liste est celle de
\fIexpr2\fR.
.SH "VOIR AUSSI"
\fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBupdatedb\fP(1L), \fBxargs\fP(1L)
\fBFinding Files\fP (en-ligne dans Info, ou en version imprimee)