plocate - trouvez rapidement des fichiers par leur nom
SYNOPSIS
plocate [OPTION]... MOTIF...
DESCRIPTION
plocate recherche tous les fichiers du système correspondant au motif donné (ou à tous les motifs s'il y en a plusieurs). Il le fait en utilisant un index créé par updatedb(8) ou (moins fréquemment) en convertissant un autre index avec plocate-build(8).
plocate est largement compatible avec mlocate(1), mais est significativement plus rapide. En particulier, il n'a que rarement besoin de parcourir toute sa base de données, sauf si le motif est très court (moins de trois octets) ou si vous souhaitez rechercher une expression régulière. Il ne tente pas de maintenir la compatibilité avec BSD locate, ni avec les noms de fichiers et les locales non-UTF-8. La plupart des opérations d'entrée/sortie sont effectuées de manière asynchrone, mais les résultats sont synchronisés afin que la sortie s'affiche toujours dans le même ordre.
Lorsque plusieurs motifs sont donnés, plocate recherche les fichiers qui correspondent à tous ces motifs. C'est la principale différence par rapport à mlocate(1), qui recherche les fichiers qui correspondent à un ou plusieurs motifs, à moins que l'option -A ne soit donnée.
Par défaut, les motifs sont considérés comme des sous-chaînes à rechercher. Si au moins un métacaractère de glob non échappé (*, ? ou []) est donné, ce motif est alors considéré comme un motif de glob (ce qui signifie qu'il doit commencer et se terminer par * pour qu'il y ait correspondance de sous-chaîne). Si --regexp est donné, les motifs sont alors considérés comme des expressions régulières POSIX de base (non ancrées), et si --regex est donné, les motifs sont considérés comme des expressions régulières POSIX étendues. Tout cela correspond au comportement de mlocate(1).
Comme mlocate(1), plocate affiche tous les fichiers visibles par l'utilisateur qui exécute la commande (en raison du fait qu'il dispose des autorisations de lecture et d'exécution sur tous les répertoires parents), et aucun de ceux qui ne le sont pas, en exécutant l'opération avec le bit setgid activé pour accéder à l'index (qui est créé en tant que root), mais en vérifiant la visibilité en tant qu'utilisateur qui exécute la commande.
CODE DE SORTIE
plocate renvoie 0 pour indiquer qu'une correspondance a été trouvée ou que les options --help ou --version ont été utilisées.
Dans les autres cas, plocate renvoie un code de statut 1, indiquant qu'une erreur s'est produite ou qu'aucune correspondance n'a été trouvée.
OPTIONS
-A, --all
Ignoré pour la compatibilité avec mlocate(1).
-b, --basename
Correspond uniquement à la partie du nom de fichier du chemin, c'est-à-dire que les noms de répertoire seront exclus de la correspondance (mais seront toujours affichés). Cela n'accélère pas la recherche, mais peut supprimer les correspondances non pertinentes.
-c, --count
N'affiche pas chaque correspondance. Au lieu de cela, il les compte et affiche le nombre total à la fin.
-d, --database DBPATH
Recherche les correspondances dans la base de données donnée, au lieu de /var/lib/plocate/plocate.db. Cet argument peut être donné plusieurs fois pour rechercher dans plusieurs bases de données. Il est également possible de donner plusieurs bases de données dans un seul argument, séparées par : \. (Tout caractère, y compris : et \, peut être échappé en le précédant d'une barre oblique inversée \).
-e, --existing
Affiche uniquement les entrées qui font référence à des fichiers existant au moment de l’exécution de la commande `locate`. Notez que, contrairement à `mlocate(1)`, les liens symboliques ne sont pas suivis par défaut (et il n’existe pas d’option pour modifier ce comportement).
-i, --ignore-case
Effectue une correspondance insensible à la casse, conformément aux paramètres régionaux actuels (par défaut, la correspondance est sensible à la casse, octet par octet). Notez que `plocate` ne prend pas en charge l’ensemble des règles de transformation de casse Unicode ; en particulier, la recherche de « ß » ne renverra pas de correspondances sur « ss », même dans un environnement régional allemand. Notez également que cette option sera légèrement plus lente qu’une correspondance sensible à la casse, car elle doit générer davantage de candidats pour la recherche dans l’index.
-l, --limit LIMIT
Arrête la recherche après que LIMIT correspondances ont été trouvées. Si l’option `--count` est spécifiée, le nombre affiché sera au maximum de LIMIT.
-N, --literal
Affiche les noms d’entrée sans les mettre entre guillemets. Normalement, `plocate` échappe les caractères spéciaux dans les noms de fichiers, afin qu’ils soient compatibles avec les interpréteurs de commandes courants (similaire au style d’échappement de la commande `shell-escape-always` des outils GNU coreutils), sauf si l’affichage se fait vers un flux, mais cette option désactive cet échappement.
-0, --null
Au lieu d’écrire une nouvelle ligne après chaque correspondance, écrit un caractère NUL (ASCII 0). Ceci est utile pour créer une sortie non ambiguë lorsque celle-ci doit être traitée par d’autres outils (comme `xargs(1)`) car les noms de fichiers peuvent contenir des nouvelles lignes intégrées.
-r, --regexp
Les motifs sont interprétés comme des expressions régulières POSIX de base. Voir `regex(7)` pour plus d’informations. Notez que cela force une analyse linéaire de l’ensemble de la base de données, ce qui est lent.
--regex
Comme `--regexp`, mais les motifs sont plutôt interprétés comme des expressions régulières POSIX étendues.
-w, --wholename
Effectue une correspondance sur le nom de chemin complet. C’est le comportement par défaut, donc, à moins que l’option `-b` ne soit spécifiée en premier, cela n’aura aucun effet. Cette option existe donc uniquement pour assurer la compatibilité avec `mlocate(1)`.
--help
Affiche les informations d’utilisation, puis quitte avec un code de succès.
--version
Affiche les informations de version, puis quitte avec un code de succès.
ENVIRONNEMENT
LOCATE_PATH
Si spécifié, est ajouté après la liste des chemins de la base de données (qu’un chemin explicite soit spécifié ou que la valeur par défaut soit utilisée). La délimitation par deux-points et l’échappement des caractères suivent les mêmes règles que pour l’option `--database`.
AUTEUR
Steinar H. Gunderson <\_\>
VOIR AUSSI
plocate-build(8), mlocate(1), updatedb(8)