plocate - encontre arquivos por nome, rapidamente
SINTAXE
plocate [OPÇÃO]... PADRÃO...
DESCRIÇÃO
plocate encontra todos os arquivos no sistema que correspondem ao padrão fornecido (ou a todos os padrões, se vários forem fornecidos). Ele faz isso por meio de um índice criado por updatedb(8) ou (menos comum) convertido de outro índice por plocate-build(8).
plocate é amplamente compatível com os argumentos de mlocate(1), mas é significativamente mais rápido. Em particular, raramente precisa escanear todo o seu banco de dados, a menos que o padrão seja muito curto (menos de três bytes) ou você queira pesquisar uma expressão regular. Ele não tenta manter a compatibilidade com o BSD locate ou com nomes de arquivos e locais que não sejam UTF-8. A maior parte da E/S é feita de forma assíncrona, mas os resultados são sincronizados para que a saída seja sempre na mesma ordem.
Quando vários padrões são fornecidos, plocate pesquisará arquivos que correspondam a todos eles. Esta é a principal incompatibilidade com mlocate(1), que pesquisa arquivos que correspondam a um ou mais padrões, a menos que a opção -A seja fornecida.
Por padrão, os padrões são considerados substrings para pesquisar. Se pelo menos um caractere curinga não escapado (*, ? ou []) for fornecido, esse padrão é tratado como um padrão curinga (o que significa que ele precisa começar e terminar com * para uma correspondência de substring). Se --regexp for fornecido, os padrões são tratados como expressões regulares básicas POSIX (não ancoradas), e se --regex for fornecido, os padrões são tratados como expressões regulares estendidas POSIX. Tudo isso corresponde ao comportamento de mlocate(1).
Como mlocate(1), plocate mostra todos os arquivos visíveis para o usuário que o chama (por ter permissões de leitura e execução em todos os diretórios pai) e nenhum que não seja, executando com o bit setgid definido para acessar o índice (que é construído como root), mas testando a visibilidade como o usuário que o chama.
STATUS DE SAÍDA
plocate sai com 0 para indicar que uma correspondência foi encontrada ou que --help ou --version foram passados. Caso contrário, plocate sai com o código de status 1, indicando que ocorreu um erro ou que nenhuma correspondência foi encontrada.
OPÇÕES
-A, --all
Ignorado para compatibilidade com mlocate(1).
-b, --basename
Corresponda apenas à parte do nome do arquivo do nome do caminho, ou seja, os nomes dos diretórios serão excluídos da correspondência (mas ainda serão impressos). Isso não acelera a pesquisa, mas pode suprimir correspondências desinteressantes.
-c, --count
Não imprima cada correspondência. Em vez disso, conte-as e imprima um total no final.
-d, --database DBPATH
Encontre correspondências no banco de dados fornecido, em vez de /var/lib/plocate/plocate.db. Este argumento pode ser fornecido várias vezes para pesquisar vários bancos de dados. Também é possível fornecer vários bancos de dados em um único argumento, separados por : \. (Qualquer caractere, incluindo : e \, pode ser escapado prefixando com uma \.)
-e, --existing
Imprime apenas as entradas que se referem a arquivos existentes no momento em que o comando locate é executado. Observe que, ao contrário do mlocate(1), os links simbólicos não são seguidos por padrão (e, de fato, não há uma opção para alterar isso).
-i, --ignore-case
Realiza uma correspondência que não diferencia maiúsculas de minúsculas, conforme especificado na configuração regional atual (o padrão é a correspondência que diferencia maiúsculas de minúsculas, byte a byte). Observe que o plocate não oferece suporte para toda a gama de regras de normalização de maiúsculas e minúsculas do Unicode; em particular, a pesquisa por ß não retornará correspondências para ss, mesmo em uma configuração regional alemã. Além disso, observe que esta opção será um pouco mais lenta do que uma correspondência que diferencia maiúsculas de minúsculas, pois ela precisa gerar mais candidatos para a pesquisa no índice.
-l, --limit LIMIT
Interrompe a pesquisa após LIMIT correspondências terem sido encontradas. Se --count for fornecido, o número impresso será no máximo LIMIT.
-N, --literal
Imprime os nomes das entradas sem aspas. Normalmente, o plocate escapará caracteres especiais em nomes de arquivos, para que sejam seguros para uso em shells típicos (semelhante ao estilo de aspas sempre ativado do GNU coreutils), a menos que a saída seja direcionada para um pipe, mas esta opção desativará essas aspas.
-0, --null
Em vez de gravar uma nova linha após cada correspondência, grava um caractere NUL (ASCII 0). Isso é útil para criar uma saída inequívoca quando ela for processada por outras ferramentas (como xargs(1)), pois os nomes de arquivos podem conter novas linhas.
-r, --regexp
Os padrões são tratados como expressões regulares básicas POSIX. Consulte regex(7) para obter mais informações. Observe que isso força uma varredura linear por todo o banco de dados, o que é lento.
--regex
Semelhante a --regexp, mas os padrões são tratados como expressões regulares estendidas POSIX.
-w, --wholename
Faz a correspondência com todo o caminho do nome. Este é o padrão, portanto, a menos que -b seja fornecido primeiro (veja acima), não fará nada. Esta opção existe apenas para compatibilidade com o mlocate(1).
--help
Imprime as informações de uso e, em seguida, sai com sucesso.
--version
Imprime as informações da versão e, em seguida, sai com sucesso.
AMBIENTE
LOCATE_PATH
Se fornecido, é anexado após a lista de caminhos do --database (seja um caminho explícito fornecido ou o padrão usado). A delimitação por dois pontos e o escape de caracteres seguem as mesmas regras do --database.
AUTOR
Steinar H. Gunderson <\_\>
VEJA TAMBÉM
plocate-build(8), mlocate(1), updatedb(8)