locate

LOCATE(1)                    General Commands Manual                   LOCATE(1)



NOM
       locate - Lister des fichiers d'une base de données correspondant à 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 ] [-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 donné, 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 caractères spéciaux de l'interpréteur de
       commandes : « * », « ? » et « [] ». Les caractères spéciaux
       n'interprètent pas « / » et « . ». Par conséquent, un motif « toto*titi »
       peut correspondre à un nom de fichier contenant « toto3/titi » et un
       motif « *tata* » peut correspondre à un nom de fichier contenant
       « tutu/.tata ». Les motifs contenant des caractères spéciaux doivent être
       protégés par des guillemets pour éviter leur développement par
       l'interpréteur de commandes.

       Si un motif est une chaîne de caractères (sans caractères spéciaux),
       locate affiche tous les noms de fichiers de la base de données qui
       contiennent cette chaîne de caractères. Si un motif contient des
       caractères spéciaux, locate affiche seulement les noms de fichiers qui
       correspondent exactement au motif. Ainsi, les motifs qui contiennent des
       caractères spéciaux doivent normalement commencer par « * » et se
       terminer le plus souvent par ce même caractère spécial. Les exceptions
       sont les motifs qui cherchent explicitement une correspondance en début
       ou en fin d'un nom de fichier.

       Les bases de noms de fichiers contiennent des listes de fichiers qui
       étaient sur le système lors de la dernière mise à jour des bases de
       données. L'administrateur système peut choisir le nom du fichier de la
       base de noms par défaut, la fréquence des mises à jour des bases de
       données et les répertoires à référencer ; reportez-vous à updatedb(1).

       Si la sortie de locate est dirigée vers un terminal, les caractères
       inhabituels en sortie sont échappés de la même façon que par l'action
       -print de la commande find. Si la sortie n'est pas dirigée vers un
       terminal, les noms de fichier sont imprimés exactement comme ils sont.


OPTIONS
       -A, --all
              Afficher seulement les noms de fichiers qui correspondent à tous
              les motifs de recherche et non ceux qui correspondent à un ou
              plusieurs motifs de recherche.

       -c, --count
              Au lieu d'afficher les fichiers correspondants, afficher seulement
              le nombre total de correspondances trouvées, sauf si --print (-p)
              est aussi présente.

       -d chemin, --database=chemin
              Au lieu de chercher la base de noms de fichiers par défaut,
              chercher les bases de noms de fichiers dans chemin, qui est une
              liste de bases de noms de fichiers séparés par « : ». Vous pouvez
              aussi utiliser la variable d'environnement LOCATE_PATH pour
              définir la liste des bases de données à parcourir. L'option a
              priorité sur la variable d'environnement si elles sont toutes deux
              utilisées. Les éléments vides du chemin sont des alias de la base
              de données par défaut. Une base de données peut être envoyée sur
              l'entrée standard en utilisant « - » comme élément de chemin. Si
              chemin contient plus d'un élément « - », les dernières entrées
              sont ignorées (et un message d'avertissement est affiché).

              Le format de la base de noms de fichiers a changé depuis les
              versions 4.0 de GNU find et locate pour permettre aux machines qui
              ordonnent les octets différemment de partager les bases de
              données. Cette version de locate peut reconnaître et lire des
              bases de données 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 données de locate sera
              abandonnée dans une future version.

       -e, --existing
              Afficher seulement les noms des fichiers qui existent à cet
              instant (au lieu des fichiers qui existaient lors de la création
              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 supprimé après que locate a enregistré 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
              création 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.

       -L, --follow
              Lors du test d'existence des fichiers (avec les options -e ou -E),
              considérer les liens symboliques cassés comme des fichiers non
              existants. Ceci est le comportement par défaut.

       -P, -H, --nofollow
              Lors du test de l'existence des fichiers (avec les options -e ou
              -E), traiter les liens symboliques cassés comme des fichiers
              existants. Le paramètre -H de cette option est fourni uniquement
              par similitude avec find ; l'utilisation de -P est recommandée à
              la place de -H.

       -i, --ignore-case
              Ignorer les différences entre minuscules et majuscules entre le
              motif et les noms de fichiers.

       -l N, --limit=N
              Limiter le nombre de correspondances à N. Si une limite est fixée
              avec cette option, le résultat affiché avec l'option -c ne sera
              jamais plus grand que celle-ci.

       -m, --mmap
              Option ne faisant rien, présente pour la compatibilité avec la
              commande locate des systèmes BSD.

       -0, --null
              Utiliser le caractère ASCII NUL comme séparateur au lieu du
              caractère saut de ligne.

       -p, --print
              Afficher les résultats de la recherche quand ils ne devraient pas
              apparaître à cause de la présence des options --statistics (-S) ou
              --count (-c).

       -w, --wholename
              Correspondance avec le nom complet du fichier tel qu'il est listé
              dans la base de noms. Ceci est le comportement par défaut.

       -b, --basename
              Les résultats correspondent si le motif indiqué correspond à la
              partie finale du nom de fichier listé dans la base de noms. La
              partie finale fait habituellement référence au nom du fichier sans
              son chemin.

       -r, --regex
              Le motif indiqué sur la ligne de commande est interprété comme une
              expression régulière à l'opposé des motifs développés. Les
              expressions régulières s'utilisent de la même manière que dans
              emacs et find, excepté le fait que « . »  correspondra au
              caractère saut de ligne. Les noms de fichiers dont les chemins
              absolus correspondent à l'expression régulière spécifiée sont
              affichés (ou comptés si l'option -c est présente). Si vous
              souhaitez ancrer votre expression régulière au début ou à la fin
              des noms de chemins absolus, alors, comme il est courant avec les
              expressions régulières, vous devez utiliser respectivement les
              caractères « ^ » et « $ » dans celle-ci.

       -s, --stdio
              Option ne faisant rien, présente pour la compatibilité avec la
              commande locate des systèmes BSD.

       -S, --statistics
              Afficher diverses informations à propos de chaque base de noms et
              quitter sans exécuter de recherche à moins qu'un motif soit donné.
              Pour la compatibilité avec les systèmes BSD, -S est acceptée comme
              alias pour --statistics. Cependant la sortie de locate -S est
              différente pour les implémentations GNU et BSD de locate.

       --help Afficher un résumé des options de locate et quitter.

       --version
              Afficher le numéro de version de locate et quitter.

ENVIRONNEMENT
       LOCATE_PATH
              Liste de bases de données séparées par « : » à parcourir. Si la
              valeur possède en tête ou en fin le caractère « : », ou possède
              deux caractères « : » sur une ligne, le résultat dépendra des
              différentes versions de locate.


VOIR AUSSI
       find(1), locatedb(5), updatedb(1), xargs(1), glob(3), Finding Files (en
       ligne dans Info ou en version imprimée)

BOGUES
       La base de noms de locate manipule correctement les noms de fichiers
       contenant des caractères saut de ligne, mais seulement si la commande
       système sort possède une option -z opérationnelle. Si vous suspectez que
       locate ait besoin de retourner des noms de fichiers incluant des
       caractères saut de ligne, alors utilisez l'option --null.

       La meilleure façon de signaler un bogue est d'utiliser le formulaire à
       l'adresse http://savannah.gnu.org/bugs/?group=findutils. L'utilité de
       cette page est que vous serez en mesure de suivre l'évolution de la
       correction du problème. D'autres commentaires à propos de locate et du
       paquet findutils peuvent être envoyés à la liste de diffusion
       bug-findutils. Pour s'abonner à cette liste, envoyez un courriel à
       bug-findutils-request@gnu.org.

TRADUCTION
       Cette page de manuel a été traduite par Frédéric Delanoy <delanoy_f AT
       yahoo DOT com> en 2002.  La version présente dans Debian est dorénavant
       maintenue par Florentin Duneau <fduneau AT gmail DOT com> 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)