locate(1)

НАЗВА
locate — пошук файлів за назвою

КОРОТКИЙ ОПИС
locate [ПАРАМЕТР]... ВЗІРЕЦЬ...

ОПИС
locate виконує читання однієї або декількох баз даних, які приготовано за допомогою updatedb(8), і записує назви файлів, які відповідають принаймні одному із ВЗІРЦІВ до стандартного виведення, по одному на рядок. Якщо не вказано --regex, у ВЗІРЦЯХ можуть міститися символи-замінники. Якщо у ВЗІРЦІ не міститься символів-замінників, locate поводиться так, наче було вказано *ВЗІРЕЦЬ*. Типово, locate не перевіряє, чи все ще існують файли, записи яких виявлено у базі даних (але усі батьківські каталоги мають існувати, якщо базу даних було зібрано з використанням --require-visibility no). locate нічого не повідомлятиме про файли, які було створено після моменту останнього оновлення відповідної бази даних.

СТАН ВИХОДУ
locate виходить із кодом стану 0, якщо буде знайдено будь-який відповідник або якщо locate було викликано із одним з таких параметрів: --limit 0, --help, --statistics або --version. Якщо відповідника знайдено не буде або якщо трапиться критична помилка, locate завершить роботу із кодом стану 1. Помилки під час читання бази даних не вважаються критичними: пошук продовжується у інших вказаних базах даних, якщо такі існують.

ПАРАМЕТРИ

-A, --all
    Вивести лише записи, які відповідають усім ВЗІРЦЯМ, а не лише одному, як у типовому випадку.

-b, --basename
    Встановлювати відповідність вказаним взірцям лише за базовою назвою. Це протилежність до параметра --wholename.

-c, --count
    Замість записування назв файлів до стандартного виведення, записати лише кількість знайдених записів.

-d, --database ШЛЯХ_ДО_БД
    Замінити типову базу даних на ШЛЯХ_ДО_БД. ШЛЯХ_ДО_БД має бути списком назв файлів баз даних, які відокремлено :. Якщо вказано декілька параметрів --database, результатом буде поєднання даних з окремих шляхів. Порожню назву бази даних буде замінено на типову базу даних. Назва файла бази даних - вказує на стандартне джерело вхідних даних. Зауважте, що базу даних може бути прочитано зі стандартного джерела вхідних даних лише один раз.

-e, --existing
    Вивести лише записи, які посилаються на файли, які існують на момент запуску locate.

-L, --follow
    При перевірці існування файлів (якщо вказано параметр --existing) переходити за кінцевими символічними посиланнями. Таким чином можна усунути із виведених даних пошкоджені символічні посилання. Це типова поведінка. Встановити протилежну поведінку можна за допомогою параметра --nofollow.

-h, --help
    Записати до стандартного виведення резюме щодо доступних параметрів і завершити роботу з кодом успіху.

-i, --ignore-case
    Ігнорувати відмінності у регістрі символів для взірців пошуку.

-l, --limit, -n ОБМЕЖЕННЯ
    Вийти з кодом стану успіху після того, як буде знайдено ОБМЕЖЕННЯ записів. Якщо вказано параметр --count, кількість результатів також буде обмежено значенням ОБМЕЖЕННЯ.

-m, --mmap
    Буде проігноровано, призначено для сумісності з locate для BSD і GNU

-P, --nofollow, -H
    При перевірці існування файлів (якщо вказано параметр --existing) не переходити за кінцевими символічними посиланнями. Таким чином можна включити до виведених даних пошкоджені символічні посилання. Це протилежність до параметра --follow.

-0, --null
    Відокремити запис у виведених даних за допомогою символу ASCII NUL , а не записувати кожен запис до окремого рядка. Цей параметр створено для реалізації взаємодії з параметром --null GNU xargs(1).

-S, --statistics
    Записувати до стандартного виведення щодо кожної прочитаної бази даних замість пошуку для файлів і завершити роботу із кодом успіху.

-q, --quiet
    Не записувати повідомлення щодо помилок, які сталися під час читання і обробки баз даних.

-r, --regexp ФОРМАЛЬНИЙ_ВИРАЗ
    Шукати з використанням базового формального виразу ФОРМАЛЬНИЙ_ВИРАЗ. Якщо використано цей параметр, не можна використовувати ВЗІРЕЦЬ. Цей параметр можна вказувати декілька разів у одній команді.

--regex
    Вважати усі ВЗІРЦІ розширеними формальними виразами.

-s, --stdio
    Буде проігноровано, призначено для сумісності з locate для BSD і GNU

-V, --version
    Записати відомості щодо версії і умов ліцензування locate до стандартного виведення і завершити роботу із кодом успіху.

-w, --wholename
    Встановлювати відповідність до повної назви шляху для вказаних взірців. Це типова поведінка. Встановити протилежну поведінку можна за допомогою параметра --basename.

ПРИКЛАДИ
Щоб виконати пошук файла за точною назвою НАЗВА (не *NAME*), скористайтеся
    locate -b '\НАЗВА'
Оскільки \ є символом-замінником, це вимикає неявну заміну запису НАЗВА на *НАЗВА*.

ФАЙЛИ

/var/lib/mlocate/mlocate.db
    База даних, у якій типово виконуватиметься пошук.

СЕРЕДОВИЩЕ

LOCATE_PATH
    Шлях до додаткових баз даних, які буде додано до типової бази даних або баз даних, які вказано за допомогою параметра --database.

ПРИМІТКИ
Порядок, у якому виконуватиметься обробка бажаних баз даних, є невизначеним. Це надає locate можливість переупорядкувати шляхи до баз даних з міркувань безпеки. locate намагається бути сумісною із slocate (без параметрів, які використовують для створення баз даних) і GNU locate, саме у цьому порядку. Це причина реалізації непрактичного типового параметра --follow і плутаного набору параметрів --regex і --regexp. Коротка версія параметра -r є несумісною із GNU locate, де вона відповідає параметру --regex. Для уникнення проблем користуйтеся довгими назвами параметрів. Використання змінної середовища LOCATE_PATH призводить до заміни типової бази даних у locate для BSD і GNU , а у цій версії slocate її записи додаються до записів з інших баз даних.

АВТОР
Miloslav Trmac <mitr@redhat.com>

ДИВ. ТАКОЖ
updatedb(8)

ПЕРЕКЛАД
Український переклад цієї сторінки посібника виконано Yuri Chornoivan <yurchor@ukr.net>

Цей переклад є безкоштовною документацією; будь ласка, ознайомтеся з умовами GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html). НЕ НАДАЄТЬСЯ ЖОДНИХ ГАРАНТІЙ.

Якщо ви знайшли помилки у перекладі цієї сторінки підручника, будь ласка, надішліть електронний лист до списку листування перекладачів: trans-uk@lists.fedoraproject.org.