Provided by: manpages-fr-extra_20111118_all bug

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)