Manuales para la línea de comandos

Man » Manual de locate en línea - documentación en línea detallada para la página de manual de locate

🌍
plocate - busca archivos por nombre, rápidamente

SINTAXIS

plocate [OPCIÓN]... PATRÓN...

DESCRIPCIÓN

plocate busca todos los archivos del sistema que coincidan con el patrón dado (o con todos los patrones si se proporcionan varios). Lo hace mediante un índice creado por updatedb(8) o (con menos frecuencia) convertido de otro índice mediante plocate-build(8).

plocate es en gran medida compatible con los argumentos de mlocate(1), pero es significativamente más rápido. En particular, rara vez necesita escanear toda su base de datos, a menos que el patrón sea muy corto (menos de tres bytes) o desee buscar una expresión regular. No intenta mantener la compatibilidad con BSD locate, ni con nombres de archivo o locales que no sean UTF-8. La mayoría de las operaciones de E/S se realizan de forma asíncrona, pero los resultados se sincronizan para que la salida sea siempre en el mismo orden.

Cuando se proporcionan varios patrones, plocate buscará archivos que coincidan con todos ellos. Esta es la principal incompatibilidad con mlocate(1), que busca archivos que coincidan con uno o más patrones, a menos que se proporcione la opción -A.

Por defecto, los patrones se consideran como subcadenas para buscar. Si se proporciona al menos un metacaracter de globbing sin escapar (*, ? o []), ese patrón se considera en su lugar como un patrón de glob (lo que significa que debe comenzar y terminar con * para que haya una coincidencia de subcadena). Si se proporciona --regexp, los patrones se consideran en su lugar como expresiones regulares básicas POSIX (sin anclaje), y si se proporciona --regex, los patrones se consideran como expresiones regulares extendidas POSIX. Todo esto coincide con el comportamiento de mlocate(1).

Al igual que mlocate(1), plocate muestra todos los archivos visibles para el usuario que realiza la llamada (por tener permisos de lectura y ejecución en todos los directorios principales) y ninguno que no lo sea, mediante el uso del bit setgid para acceder al índice (que se crea como root), pero comprobando la visibilidad como el usuario que realiza la llamada.

ESTADO DE SALIDA

plocate sale con 0 para indicar que se encontró una coincidencia o que se pasaron --help o --version. De lo contrario, plocate sale con un código de estado 1, lo que indica que se produjo un error o que no se encontraron coincidencias.

OPCIONES

-A, --all

Ignorado para compatibilidad con mlocate(1).

-b, --basename

Coincidir solo con la parte del nombre de archivo de la ruta, es decir, los nombres de los directorios se excluirán de la coincidencia (pero aún se imprimirán). Esto no acelera la búsqueda, pero puede suprimir coincidencias no interesantes.

-c, --count

No imprimir cada coincidencia. En su lugar, contarlas e imprimir el número total al final.

-d, --database DBPATH
Buscar coincidencias en la base de datos especificada, en lugar de /var/lib/plocate/plocate.db. Se puede proporcionar este argumento varias veces para buscar en varias bases de datos. También es posible proporcionar varias bases de datos en un solo argumento, separadas por : \. (Cualquier carácter, incluidos : y \, puede escaparse anteponiéndole una \).

-e, --existing

Imprime solo las entradas que se refieren a archivos que existen en el momento en que se ejecuta locate. Tenga en cuenta que, a diferencia de mlocate(1), los enlaces simbólicos no se siguen por defecto (y, de hecho, no hay opción para cambiar esto).

-i, --ignore-case

Realiza una coincidencia que no distingue entre mayúsculas y minúsculas, según la configuración regional actual (el valor predeterminado es la coincidencia que distingue entre mayúsculas y minúsculas, byte por byte). Tenga en cuenta que plocate no admite la gama completa de reglas de plegado de mayúsculas y minúsculas de Unicode; en particular, la búsqueda de ß no devolverá coincidencias en ss, incluso en una configuración regional alemana. Tenga en cuenta también que esta opción será algo más lenta que una coincidencia que distingue entre mayúsculas y minúsculas, ya que debe generar más candidatos para la búsqueda en el índice.

-l, --limit LIMIT

Deja de buscar después de que se hayan encontrado LIMIT coincidencias. Si se da --count, el número que se imprime será como máximo LIMIT.

-N, --literal

Imprime los nombres de las entradas sin aplicarles comillas. Normalmente, plocate aplicará comillas a los caracteres especiales de los nombres de archivo, de modo que sean seguros para su uso en shells típicos (similar al estilo de comillas shell-escape-always de las GNU coreutils), a menos que se esté imprimiendo en una tubería, pero esta opción desactivará dichas comillas.

-0, --null

En lugar de escribir una nueva línea después de cada coincidencia, escribe un carácter NUL (ASCII 0). Esto es útil para crear una salida inequívoca cuando se va a procesar con otras herramientas (como xargs(1)), ya que los nombres de archivo pueden contener nuevas líneas incrustadas.

-r, --regexp

Los patrones se interpretan como expresiones regulares POSIX básicas. Consulte regex(7) para obtener más información. Tenga en cuenta que esto obliga a un escaneo lineal de toda la base de datos, lo cual es lento.

--regex

Similar a --regexp, pero los patrones se interpretan como expresiones regulares POSIX extendidas.

-w, --wholename

Coincide con todo el nombre de la ruta. Este es el valor predeterminado, por lo que, a menos que se proporcione primero -b (consulte arriba), no hará nada. Por lo tanto, esta opción existe solo como compatibilidad con mlocate(1).

--help Imprime la información de uso y, a continuación, sale con éxito.

--version

Imprime la información de la versión y, a continuación, sale con éxito.

ENTORNO

LOCATE_PATH

Si se proporciona, se agrega después de la lista de rutas de --database (ya sea que se proporcione una ruta explícita o se use el valor predeterminado). La delimitación con dos puntos y el escape de caracteres siguen las mismas reglas que para --database.

AUTOR

Steinar H. Gunderson <_>

VER TAMBIÉN

plocate-build(8), mlocate(1), updatedb(8)