Provided by:
manpages-fr-extra_20111118_all 
NOM
locate - Lister des fichiers d'une base de donnees correspondant a un
motif
SYNOPSIS
locate [-d chemin | --database=chemin] [-e | -E | --[non-]existing] [-i
| --ignore-case] [-0 | --null] [-c | --count] [-w | --wholename] |-b |
--basename] [-l N | --limit=N] [-S | --statistics] [-r | --regex ]
[--max-database-age D] [-P | -H | --nofollow] [-L | --follow]
[--version] [-A | --all] [-p | --print] [--help] motif...
DESCRIPTION
Cette page de manuel documente la version GNU de locate. Pour chaque
motif donne, locate recherche dans une ou plusieurs bases de noms de
fichiers et affiche les noms de fichiers qui contiennent ce motif. Les
motifs peuvent contenir des caracteres speciaux de l'interpreteur de
commandes : << * >>, << ? >> et << [] >>. Les caracteres speciaux
n'interpretent pas << / >> et << . >>. Par consequent, un motif
<< toto*titi >> peut correspondre a un nom de fichier contenant
<< toto3/titi >> et un motif << *tata* >> peut correspondre a un nom de
fichier contenant << tutu/.tata >>. Les motifs contenant des caracteres
speciaux doivent etre proteges par des guillemets pour eviter leur
developpement par l'interpreteur de commandes.
Si un motif est une chaine de caracteres (sans caracteres speciaux),
locate affiche tous les noms de fichiers de la base de donnees qui
contiennent cette chaine de caracteres. Si un motif contient des
caracteres speciaux, locate affiche seulement les noms de fichiers qui
correspondent exactement au motif. Ainsi, les motifs qui contiennent
des caracteres speciaux doivent normalement commencer par << * >> et se
terminer le plus souvent par ce meme caractere special. Les exceptions
sont les motifs qui cherchent explicitement une correspondance en debut
ou en fin d'un nom de fichier.
Les bases de noms de fichiers contiennent des listes de fichiers qui
etaient sur le systeme lors de la derniere mise a jour des bases de
donnees. L'administrateur systeme peut choisir le nom du fichier de la
base de noms par defaut, la frequence des mises a jour des bases de
donnees et les repertoires a referencer ; reportez-vous a updatedb(1).
Si la sortie de locate est dirigee vers un terminal, les caracteres
inhabituels en sortie sont echappes de la meme facon que par l'action
-print de la commande find. Si la sortie n'est pas dirigee vers un
terminal, les noms de fichier sont imprimes exactement comme ils sont.
OPTIONS
-0, --null
Utiliser le caractere ASCII NUL comme separateur au lieu du
caractere saut de ligne.
-A, --all
Afficher seulement les noms de fichiers qui correspondent a tous
les motifs de recherche et non ceux qui correspondent a un ou
plusieurs motifs de recherche.
-b, --basename
Les resultats correspondent si le motif indique correspond a la
partie finale du nom de fichier liste dans la base de noms. La
partie finale fait habituellement reference au nom du fichier
sans son chemin.
-c, --count
Au lieu d'afficher les fichiers correspondants, afficher
seulement le nombre total de correspondances trouvees, sauf si
--print (-p) est aussi presente.
-d chemin, --database=chemin
Au lieu de chercher dans la base de noms de fichiers par defaut,
chercher dans les bases de noms de fichiers de chemin, qui est
une liste de bases de noms de fichiers separes par << : >>. Vous
pouvez aussi utiliser la variable d'environnement LOCATE_PATH
pour definir la liste des bases de donnees a parcourir. L'option
a priorite sur la variable d'environnement si elles sont toutes
deux utilisees. Les elements vides du chemin sont des alias de
la base de donnees par defaut. Une base de donnees peut etre
envoyee sur l'entree standard en utilisant << - >> comme element
de chemin. Si chemin contient plus d'un element << - >>, les
dernieres entrees sont ignorees (et un message d'avertissement
est affiche).
Le format de la base de noms de fichiers a change depuis les
versions 4.0 de GNU find et locate pour permettre aux machines
qui ordonnent les octets differemment de partager les bases de
donnees. Cette version de locate peut reconnaitre et lire des
bases de donnees produites pour les anciennes versions de GNU
locate ou pour les versions Unix de locate ou find. La gestion
du format des anciennes versions des bases de donnees de locate
sera abandonnee dans une future version.
-e, --existing
Afficher seulement les noms des fichiers qui existent a cet
instant (au lieu des fichiers qui existaient lors de la creation
de la base de noms). Cela peut fortement ralentir le programme
s'il y a un grand nombre de correspondances dans la base de
noms. Si vous utilisez cette option dans un programme, il est
possible qu'un fichier soit supprime apres que locate a
enregistre son existence, mais avant que vous l'utilisiez.
-E, --non-existing
Afficher seulement les noms des fichiers qui n'existent pas
actuellement (au lieu des fichiers qui existaient lors de la
creation de la base de noms). Cela peut fortement ralentir le
programme s'il y a un grand nombre de correspondances dans la
base de noms.
--help Afficher un resume des options de locate et quitter.
-i, --ignore-case
Ignorer les differences entre minuscules et majuscules entre le
motif et les noms de fichiers.
-l N, --limit=N
Limiter le nombre de correspondances a N. Si une limite est
fixee avec cette option, le nombre d'entrees affichees avec
l'option -c ne sera jamais plus grand que celle-ci.
-L, --follow
Lors du test d'existence des fichiers (avec les options -e ou
-E), considerer les liens symboliques casses comme des fichiers
non existants. Ceci est le comportement par defaut.
--max-database-age D
locate affichera normalement un message d'avertissement si la
base de donnees dans laquelle il effectue sa recherche a plus de
8 jours. Cette option permet de definir une autre valeur que 8.
Definir cette valeur avec un nombre negatif entraine un
comportement indefini.
-m, --mmap
Option ne faisant rien, presente pour la compatibilite avec la
commande locate des systemes BSD.
-P, -H, --nofollow
Lors du test de l'existence des fichiers (avec les options -e ou
-E), traiter les liens symboliques casses comme des fichiers
existants. Le parametre -H de cette option est fourni uniquement
par similitude avec find ; l'utilisation de -P est recommandee a
la place de -H.
-p, --print
Afficher les resultats de la recherche quand ils ne devraient
pas apparaitre a cause de la presence des options --statistics
(-S) ou --count (-c).
-r, --regex
Le motif indique sur la ligne de commande est interprete comme
une expression rationnelle a l'oppose des motifs developpes. Les
expressions rationnelles s'utilisent de la meme maniere que dans
emacs et find, excepte le fait que << . >> correspondra avec un
caractere saut de ligne. Les noms de fichiers dont les chemins
absolus correspondent a l'expression rationnelle specifiee sont
affiches (ou comptes si l'option -c est presente). Pour attacher
une expression rationnelle au debut ou a la fin d'un nom de
chemin absolu vous devez utiliser respectivement les caracteres
<< ^ >> et << $ >> dans celle-ci (ce qui est la methode courante
pour realiser cela avec des expressions rationnelles).
-s, --stdio
Option ne faisant rien, presente pour la compatibilite avec la
commande locate des systemes BSD.
-S, --statistics
Afficher diverses informations a propos de chaque base de noms
et quitter sans executer de recherche a moins qu'un motif soit
donne. Pour la compatibilite avec les systemes BSD, -S est
acceptee comme alias pour --statistics. Cependant la sortie de
locate -S est differente pour les implementations GNU et BSD de
locate.
--version
Afficher le numero de version de locate et quitter.
-w, --wholename
Correspondance avec le nom complet du fichier tel qu'il est
liste dans la base de noms. Ceci est le comportement par defaut.
ENVIRONNEMENT
LOCATE_PATH
Liste de bases de donnees a parcourir, separees par << : >>. Si
la valeur possede en tete ou en fin le caractere << : >>, ou
possede deux caracteres << : >> sur une ligne, le resultat
dependra de la version de locate.
VOIR AUSSI
find(1), locatedb(5), updatedb(1), xargs(1), glob(3), Finding Files (en
ligne dans Info ou en version imprimee)
HISTORIQUE
Le programme locate est apparu en tant que programme de recherche
rapide de BSD, offert par James A. Woods. Ceci est decrit dans son
papier Finding Files Fast qui a ete publie dans Usenix ;login:, Vol 8,
No 1, Fev/Mars, 1983, pp. 8-10. Lorsque le comportement du programme
find a ete modifie afin d'utiliser l'action -print par defaut des lors
qu'aucune action n'avait ete specifiee, l'interpretation de find motif
a ete modifiee. Les developpeurs BSD ont alors transfere la
fonctionnalite de recherche rapide a locate. L'implementation du locate
du GNU decoule en fait du meme code.
Modifications importantes de locate, dans l'ordre chronologique
inverse :
4.3.7 Gestion des differents ordonnancements de codage des octets
dans l'ancien format de base de donnees
4.3.3 Gestion correcte des caracteres multi-octets par locate -i
Arrivee de --max_db_age
4.3.2 Gestion du format de base de donnees de slocate
4.2.22 Arrivee de l'option --all
4.2.15 Arrivee de l'option --regex
4.2.14 Arrivee des options -L, -P, -H
4.2.12 Une chaine vide dans LOCATE_PATH correspond a la base de
donnees par defaut
4.2.11 Arrivee de l'option --statistics
4.2.4 Arrivee de --count et de --limit
4.2.0 Les caracteres jokers offrent la correspondance avec le nom
complet du fichier
4.0 Arrivee du format de base de donnees LOCATE02
3.7 Locate sait rechercher dans plusieurs bases de donnees
BOGUES
La base de noms de locate manipule correctement les noms de fichiers
contenant des caracteres saut de ligne, mais seulement si la commande
systeme sort possede une option -z operationnelle. Si vous suspectez
que locate ait besoin de retourner des noms de fichiers incluant des
caracteres saut de ligne, alors utilisez l'option --null.
La meilleure facon de signaler un bogue est d'utiliser le formulaire a
l'adresse http://savannah.gnu.org/bugs/?group=findutils. L'utilite de
cette page est que vous serez en mesure de suivre l'evolution de la
correction du probleme. D'autres commentaires a propos de locate et du
paquet findutils peuvent etre envoyes a la liste de diffusion
bug-findutils. Pour s'abonner a cette liste, envoyez un courriel a
bug-findutils-request@gnu.org.
TRADUCTION
Cette page de manuel a ete traduite par Frederic Delanoy <delanoy_f AT
yahoo DOT com> en 2002. La version presente dans Debian est dorenavant
maintenue par Sylvain Cherrier <sylvain DOT cherrier AT free DOT fr> et
les membres de la liste <debian-l10n-french AT lists DOT debian DOT
org>. Veuillez signaler toute erreur de traduction par un rapport de
bogue sur le paquet manpages-fr-extra.
LOCATE(1)