ПОЗИЦИОННЫЕ ПАРАМЕТРЫ¶

Позиционные параметры всегда возвращают значение истинно (true). Они влияют только на тесты, выполняемые далее в командной строке.

-daystart

Измерять время (для значений -amin, -atime, -cmin, -time, -mmin и -mtime) с начала сегодняшних суток, а не с 24 часов назад. Этот параметр влияет только на тесты, которые появляются позже в командной строке.

-follow

Не рекомендуется (вместо этого используйте параметр -L). Разыменовывать символические ссылки. Подразумевает параметр -noleaf. Параметр -follow влияет только на те тесты, которые следуют после него в командной строке. Если не указан параметр -H или -L, расположение параметра -follow изменяет поведение предиката (в смысле математической логики) -newer; любые файлы, указанные в качестве аргумента параметра -newer, будут разыменованы, если они являются символическими ссылками. То же самое относится и к -newerXY, -anewer и -cnewer. Аналогично, предикат -type всегда будет соответствовать типу файла, на который указывает символическая ссылка, а не самой ссылке. Использование -follow приводит к тому, что предикаты -lname и -ilname всегда возвращают значение "ложно" (false).

-regextype type

Изменяет синтаксис регулярных выражений, понятный с помощью тестов -regex и -iregex, которые выполняются позже в командной строке. Чтобы узнать, какие типы регулярных выражений известны, используйте -regextype help. Документация Texinfo (обратитесь к СМОТРИТЕ ТАКЖЕ) объясняет значение и отличия между различными типами регулярных выражений.

-warn, -nowarn

Включить (-warn)или отключить (-nowarn ) сообщения. Эти предупреждения относятся только к использованию командной строки, а не к каким-либо условиям, с которыми может столкнуться find при поиске в каталогах. Поведение по умолчанию соответствует -warn, если стандартным вводом является tty и -nowarn в противном случае. Если выдается предупреждающее сообщение, относящееся к использованию командной строки, это не влияет на статус выхода find. Если задана переменная окружения POSIXLY_CORRECT и также используется -warn, то не определено, какие предупреждения будут активны, если таковые имеются.

ГЛОБАЛЬНЫЕ ОПЦИИ¶

Основные параметры всегда возвращают значение истинно (true). Основные параметры вступают в силу даже для тестов, которые выполняются ранее в командной строке. Чтобы избежать путаницы, основные параметры следует указывать в командной строке после списка начальных точек, непосредственно перед первым тестом, позиционным параметром или действием. Если вы укажете основной параметр в каком-либо другом месте, то find выдаст предупреждающее сообщение, объясняющее, что это может привести к путанице.

Общие параметры располагаются после списка начальных точек и поэтому не являются такими же параметрами, как, например, -L.

-d

Синоним -depth, для обеспечения совместимости с FreeBSD, NetBSD, macOS X и OpenBSD.

-depth

Обрабатывать содержимое каждой директории перед самой директорией. Действие -delete также подразумевает -depth.

-files0-from file

Прочитать начальные точки из file вместо того, чтобы получать их из командной строки. В отличие от известных ограничений передачи начальных точек с помощью аргументов в командной строке, а именно ограничений по количеству имен файлов и присущей им неоднозначности, когда имена файлов сталкиваются с именами параметров, использование этого параметра позволяет безопасно передавать произвольное количество начальных точек в find.

Использование этого параметра и передача начальных точек в командной строке являются взаимоисключающими и поэтому недопустимо использовать их одновременно.

Аргумент file является обязательным. Можно использовать -files0-from - для чтения списка начальных точек из standard input (стандартного ввода) и, например, из канала. В этом случае действия -ok и -okdir недопустимы, поскольку они, очевидно, помешали бы чтению из standard input для получения подтверждения пользователя.

Начальные точки в file должны быть разделены символами нуль-терминированной строки - ASCII NUL (0x00). Два последовательных символа NUL, т.е. начальная точка с именем файла нулевой длины, недопустимы и приведут к диагностике ошибки, за которой затем последует ненулевой код завершения.

В случае, если заданный file пуст, find не обрабатывает никакой начальной точки и, следовательно, завершит работу сразу после анализа аргументов программы. Это отличается от стандартного вызова, где find принимает текущий каталог в качестве начальной точки, если аргумент "path" не определён.

В остальном обработка начальных точек выполняется как обычно, например, find будет рекурсивно перемещаться по подкаталогам, если не запрещено иное. Для обработки только начальных точек можно дополнительно передать -maxdepth 0.

Дополнительные примечания: Если файл указан во входном файле более одного раза, то не определено, посещался ли он более одного раза. Если параметр file изменяется во время операции find, то результат также является неопределенным. Наконец, позиция поиска в именованном file в момент выхода find, будь то с помощью -quit или любым другим способом, также является неопределенной. Под "неопределенным" здесь подразумевается, что утилита find может работать, а может и не работать или выполнять какие-либо конкретные действия и что её поведение может меняться от платформы к платформе или от выпуска к выпуску утилиты find.

-help, --help

Вывести краткое описание по использованию find в командной строке и завершить работу.

-ignore_readdir_race

Обычно find выдает сообщение об ошибке, когда ей не удается найти файл. Если вы зададите этот параметр и файл будет удален в промежутке между моментом, когда find считывает имя файла из каталога и моментом, когда она пытается сохранить файл, то сообщение об ошибке выдано не будет. Это также относится к файлам или каталогам, имена которых указаны в командной строке. Этот параметр вступает в силу во время чтения командной строки: это означает, что вы не можете выполнять поиск в одной части файловой системы с включенным этим параметром, а в другой - с выключенным параметром (если вам нужно это сделать, то вам следует выполнить вместо этого две команды find: одну с этим параметром, а другую без него).

Кроме того, find с параметром -ignore_readdir_race проигнорирует ошибки действия -delete в случае, если файл исчез с момента чтения родительского каталога: она не выдаст диагностику ошибки, а код возвращения действия -delete будет "истинно" (true).

-maxdepth levels

Спуститься не более чем на levels уровней каталогов ниже начальных точек (это должно быть неотрицательное целое число). Использование -maxdepth 0 означает применение тестов и действий только к самим начальным точкам.

-mindepth levels

Не выполнять никаких тестов или действий на уровнях ниже levels (неотрицательное целое число). Использование -mindepth 1 означает обработку всех файлов, кроме начальных точек.

-mount

Не просматривать каталоги в других файловых системах. Альтернативное наименование для -x dev, для совместимости с некоторыми другими версиями find.

-noignore_readdir_race

Отключить параметр -ignore_readdir_race.

-noleaf

Не проводить оптимизацию, предполагая, что в каталогах содержится на 2 подкаталога меньше, чем количество жестких ссылок на них. Этот параметр необходим при поиске в файловых системах, которые не соответствуют соглашению о ссылках в каталогах Unix, например, в файловых системах CD-ROM или MS-DOS, или в точках монтирования томов AFS. Каждый каталог в обычной файловой системе Unix имеет как минимум 2 жесткие ссылки: на его имя и на запись ".". Кроме того, каждый из его подкаталогов (если таковой имеется) имеет запись "..", связанную с этим каталогом. Когда find проверяет каталог, после того, как она обнаружила на 2 подкаталога меньше, чем количество ссылок в каталоге, она знает, что остальные записи в каталоге не являются каталогами (это -"конечные" файлы в дереве каталогов). Если нужно проверить только имена файлов, то нет необходимости их статистизировать, а это значительно увеличивает скорость поиска.

-version, --version

Вывести номер версии find и завершить работу.

-xdev

Не удалять каталоги из других файловых систем.

ТЕСТЫ¶

Некоторые тесты, например -newerXY и -same file, позволяют сравнивать проверяемый в данный момент файл с некоторым эталонным файлом, указанным в командной строке. При использовании этих тестов интерпретация файла ссылок определяется параметрами -H, -L и -P, а также любыми предыдущими параметрами -follow, но файл ссылок проверяется только один раз, во время анализа командной строки. Если файл ссылки не может быть проверен (например, системный вызов stat(2) завершается ошибкой), выдается сообщение об ошибке и find завершает работу с ненулевым статусом.

В тестах (например, -amin, -mtime, -gid, -inum, -links, -size, -uid и -used) может быть определен числовой аргумент n в нижеследующих вариантах:

+n

более, чем n;

-n

менее чем n;

n

равно n.

Поддерживаются следующие тесты:

-amin n

Последний раз к файлу обращались менее, более или ровно n минут назад.

-anewer reference

Время последнего обращения к текущему файлу является более поздним, чем время последнего изменения данных в файле reference. Если reference является символической ссылкой и используется параметр -H или параметр -L, то всегда используется время последнего изменения данных файла, на который указывает эта ссылка.

-atime n

Последний раз к файлу обращались менее, более или ровно n*24 часа назад. Когда find вычисляет, сколько 24-часовых периодов назад к файлу был осуществлен последний доступ, любая дробная часть игнорируется, поэтому для соответствия -atime +1 к файлу должен был быть осуществлен доступ по крайней мере two (двое) суток назад.

-cmin n

Статус файла в последний раз менялся менее, более или ровно n минут назад.

-cnewer reference

Время последнего изменения статуса текущего файла является более поздним, чем время последнего изменения данных в файле reference. Если reference является символической ссылкой и используется параметр -H или параметр -L, то всегда используется время последнего изменения данных в файле, на который указывает ссылка.

-ctime n

Статус файла в последний раз менялся менее, более или ровно 24 часа назад. Смотрите комментарии к -atime, чтобы понять, как округление влияет на интерпретацию времени изменения статуса файла.

-empty

Файл пуст и представляет собой либо обычный файл, либо каталог.

-executable

Сопоставлять, доступные для поиска текущему пользователю, исполняемые файлы и каталоги (в смысле разрешения имен файлов). При этом учитываются списки контроля доступа и другие артефакты разрешений, которые тест -perm игнорирует. Этот тест использует системный вызов access(2) и поэтому может выдать неправильный результат в случае использования серверов NFS, на которых выполняется сопоставление UID (или, на которых разрешен доступ только пользователю root). Дело в том, что многие клиентские системы применяют системный вызов access(2) из своего клиентского ядра и поэтому не могут использовать для сопоставления информацию UID, хранящуюся на сервере. Однако, поскольку этот тест основан только на результате системного вызова access(2), то нет никакой уверенности в том, что файл, для которого этот тест завершился успешно, действительно является таковым.

-false

Всегда ложно.

-fstype type

Файл находится в файловой системе типа type. Допустимые типы файловых систем различаются в разных версиях Unix; неполный список типов файловых систем, которые могут быть в той или иной версии Unix, следующий: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. Вы можете использовать -printf с директивой %F, чтобы просмотреть типы ваших файловых систем.

-gid n

Числовой идентификатор группы файла менее, более или точно равен n.

-group gname

Файл принадлежит группе, именуемой gname (можно также использовать цифровой идентификатор группы).

-ilname pattern

Аналогично -lname, но соответствие не зависит от регистра. Если используется параметр -L или параметр -follow, то этот тест возвращает значение false, если только не нарушена символическая ссылка.

-iname pattern

Аналогично -name, но соответствие не зависит от регистра. Например, шаблонам "fo*" и "F??" соответствуют файлы с именами "Foo", "FOO", "foo", "fOo", "fOo" и т.д. Шаблону "*foo*" также будет соответствовать файл с именем ".foobar".

-inum n

Индексный дескриптор файла менее, чем n, более, чем n или равен n. Обычно проще использовать тест -samefile.

-ipath pattern

Аналогично -path, но при проверке соответствия регистр не учитывается.

-iregex pattern

Аналогично -regex, но при проверке соответствия регистр не учитывается.

-iwholename pattern

Смотрите -ipath. Этот вариант менее переносим, чем -ipath.

-links n

Файл содержит менее, более или ровно n жестких ссылок.

-lname pattern

Файл представляет собой символическую ссылку, содержимое которой соответствует шаблону оболочки pattern. Метасимволы не содержат специальных символов "/" или ".". Если указан параметр -L или параметр -follow, то этот тест возвращает значение false, если символическая ссылка не нарушена.

-mmin n

Данные файла были в последний раз изменены менее, более или ровно n минут назад.

-mtime n

Данные файла в последний раз изменялись менее, более или ровно 24 часа назад. Смотрите комментарии к -atime, чтобы узнать, как округление влияет на интерпретацию времени изменения файла.

-name pattern

Основное имя файла (т.е. путь с удаленными предшествующими каталогами) соответствует шаблону оболочки pattern. Поскольку предшествующие каталоги удалены, то имена файлов, которые проверяются на соответствие с -name, никогда не будут содержать косую черту, поэтому "-name a/b" никогда ничему не будет соответствовать (вероятно вместо этого, вам следует использовать -path ). При попытке сделать это, выдается предупреждение, если только не задана переменная окружения POSIXLY_CORRECT. Метасимволы ("*" "?" и "[]") в начале основного имени соответствуют "." (это изменение в утилите find-4.2.2; смотрите раздел СООТВЕТСТВИЕ СТАНДАРТАМ ниже). Чтобы игнорировать каталог и файлы, находящиеся в нем, используйте -prune вместо проверки каждого файла в дереве каталогов; смотрите пример в описании этого действия. Фигурные скобки не воспринимаются как что-то особенное, несмотря на то, что некоторые оболочки, включая Bash, придают фигурным скобкам особое значение в шаблонах оболочек. Сопоставление имен файлов выполняется с помощью библиотечной функции fnmatch(3). Не забудьте заключить шаблон в кавычки, чтобы защитить его от расширения оболочкой.

-newer reference

Время последнего изменения данных текущего файла является более поздним, чем время последнего изменения данных файла reference. Если reference является символической ссылкой и используется параметр -H или параметр -L, то всегда используется время последнего изменения данных файла, на который указывает символическая ссылка.

-newerXY reference

Выполняется успешно, если временная метка X рассматриваемого файла более новая, чем временная метка Y файла reference. Буквы X и Y могут быть любыми из следующего набора:

a	Время доступа к файлу reference.
B	Время создания файла reference.
c	Время изменения статуса индексного дескриптора reference.
m	Время изменения файла reference.
t	reference интерпретируется непосредственно как время.

Некоторые комбинации недопустимы; например, недопустимо, чтобы X было t. Некоторые комбинации реализованы не во всех системах; например, B поддерживается не во всех системах. Если указана недопустимая или не поддерживаемая комбинация XY, то возникает фатальная ошибка. Спецификации времени интерпретируются как аргументы для параметра -d в GNU date. Если вы попытаетесь использовать время создания, указанное в файле-ссылке и время создания не будет определено, то появится сообщение о фатальной ошибке. Если вы укажете тест, который относится ко времени создания проверяемых файлов, то этот тест не будет выполнен для любых файлов, время создания которых неизвестно.

-nogroup

Ни одна группа не соответствует числовому идентификатору группы файла.

-nouser

Ни один пользователь не соответствует числовому идентификатору пользователя файла.

-path pattern

Имя файла соответствует шаблону оболочки pattern. Метасимволы не содержат символов "/" или "." специально; так, например,

find . -path "./sr*sc"

выведет запись для каталога с именем ./src/misc (если таковой существует). Чтобы игнорировать всё дерево каталогов, используйте -prune вместо проверки каждого файла в дереве каталогов. Обратите внимание, что проверка соответствия шаблону применяется ко всему имени файла, начиная с одной из начальных точек, указанных в командной строке. Здесь имеет смысл использовать абсолютное имя пути только в том случае, если соответствующая начальная точка также является абсолютным путем. Это означает, что нижеприведённой команде никогда ничто не будет соответствовать:

find bar -path /foo/bar/myfile -print

Утилита find сравнивает аргумент -path с объединением имени каталога и основного имени проверяемого файла. Поскольку конкатенация никогда не заканчивается косой чертой, то аргументы -path, заканчивающиеся косой чертой, ничему не будут соответствовать (за исключением, возможно, начальной точки, указанной в командной строке). Предикат -path также поддерживается find HP-UX и является частью стандарта POSIX 2008.

-perm mode

Биты прав доступа для файла в точности соответствуют mode (в восьмеричной системе счисления или в символьной записи). Поскольку требуется точное соответствие, то если вы хотите использовать эту форму для символьной записи, вам, возможно, придется указать довольно сложную строку. Например, строка "-perm g=w" будет соответствовать только файлам, имеющим права доступа 0020 (то есть тем, для которых право доступа на групповую запись является единственным установленным правом доступа). Скорее всего вам лучше использовать формы "/" или "-", например, "-perm -g=w", которые соответствуют любому файлу с правом доступа на запись группы. Некоторые наглядные примеры приведены в разделе ПРИМЕРЫ.

-perm -mode

Для файла заданы все биты прав доступа в mode. В этой форме принимаются символьные записи и обычно используется именно эта форма. Вы должны указать "u", "g" или "o", если вы используете символьную запись. Некоторые наглядные примеры приведены в разделе ПРИМЕРЫ.

-perm /mode

Для файла заданы любые права доступа mode. В этой форме допускаются символьные записи. Вы должны указать "u", "g" или "o", если вы используете символьные записи. Некоторые наглядные примеры приведены в разделе ПРИМЕРЫ. Если в mode не заданы биты прав доступа, то этот тест соответствует любому файлу (смыл здесь заключается в том, чтобы соответствовать поведению -perm -000).

-perm +mode

Это больше не поддерживается (и считается устаревшим с 2005 года). Вместо этого используйте -perm /mode.

-readable

Сопоставлять файлы, доступные для чтения текущему пользователю. При этом учитываются списки прав доступа и другие артефакты разрешений, которые тест -perm игнорирует. Этот тест использует системный вызов access(2) и поэтому может выдать неправильный результат в случае использования серверов NFS, на которых выполняется сопоставление UID (или, на которых разрешен доступ только пользователю root). Дело в том, что многие клиентские системы применяют системный вызов access(2) из своего клиентского ядра и поэтому не могут использовать для сопоставления информацию UID, хранящуюся на сервере. Однако, поскольку этот тест основан только на результате системного вызова access(2), то нет никакой уверенности в том, что файл, для которого этот тест завершился успешно, действительно является таковым.

-regex pattern

Имя файла соответствует регулярному выражению pattern. Это совпадение по всему пути, а не поиск. Например, для сопоставления файла с именем ./fubar 3 можно использовать регулярное выражение ".*bar." или ".*b.*3", но не "f.*r3". Регулярные выражения, распознаваемые find по умолчанию, являются регулярными выражениями Emacs (за исключением того, что "." соответствует новой строке), но это можно изменить с помощью параметра -regextype.

-samefile name

Файл ссылается на тот же индексный дескриптор, что и файл name. Когда используется -L, это может содержать символические ссылки.

-size n[cwbkMG]

Файл занимает меньше, больше или ровно n единиц измерения пространства с округлением в большую сторону. Можно использовать следующие буквы:

Размер - это просто структурный элемент st_size, заполняемый системным вызовом lstat (или stat) и округленный в большую сторону, как показано выше. Другими словами, это согласуется с результатом, который вы получаете для ls -l. Имейте в виду, что спецификаторы формата "%k" и "%b" в -printf по-разному обрабатывают разреженные файлы. Буква "b" всегда обозначает 512-байтовые блоки и никогда не обозначает 1024-байтовые, что отличается от поведения -ls.

Символы "+" и "-", как обычно, означают "больше" и "меньше", т.е. точный размер n единиц измерения не совпадает. Имейте в виду, что размер округлен в большую сторону до следующей единицы измерения. Следовательно, -size -1M не эквивалентно -size -1048576c. Первое соответствует только пустым файлам, а второе соответствует файлам размером от 0 до 1 048 575 байт.

-true

Всегда истинно.

-type c

Файл имеет тип c:

Для поиска более чем одного типа одновременно вы можете ввести сводный список букв типа, разделенных запятой "," (расширение GNU).

-uid n

Числовой идентификатор пользователя файла менее, более или точно равен n.

-used n

Последний раз к файлу обращались менее, более или ровно n дней после последнего изменения его статуса.

-user uname

Файл принадлежит пользователю uname (допускается использование числового идентификатора пользователя).

-wholename pattern

Смотрите -path. Эта альтернатива менее переносима, чем -path.

-writable

Сопоставлять файлы, доступные для записи текущему пользователю. При этом учитываются списки прав доступа и другие артефакты прав доступа, которые тест -perm игнорирует. Этот тест использует системный вызов access(2) и поэтому может выдать неправильный результат в случае использования серверов NFS, на которых выполняется сопоставление UID (или, на которых разрешен доступ только пользователю root). Дело в том, что многие клиентские системы применяют системный вызов access(2) из своего клиентского ядра и поэтому не могут использовать для сопоставления информацию UID, хранящуюся на сервере. Однако, поскольку этот тест основан только на результате системного вызова access(2), то нет никакой уверенности в том, что файл, для которого этот тест завершился успешно, действительно является таковым.

-xtype c

То же, что и -type, если только файл не является символической ссылкой. Для символических ссылок: если был указан параметр -H или -P, значение истинно (true), если файл является ссылкой на файл типа c; если был указан параметр -L, то значение true, если c равно "l". Другими словами, для символических ссылок -xtype проверяет тип файла, который -xtype не проверяет.

-context pattern

Контекст безопасности файла соответствует glob pattern (glob - шаблон с подстановочными знаками). Примечание. Только для SELinux.

ДЕЙСТВИЯ¶

-delete

Удалить файлы или каталоги; если удаление завершилось успешно, возвращается true. Если удаление завершилось неудачно, выдается сообщение об ошибке и возвращаемое find значение будет отличным от нуля (когда find завершит работу).

Внимание: Не забывайте, что find анализирует командную строку как выражение, поэтому, когда в начале строки указано -delete, find попытается удалить всё, что находится ниже указанных вами начальных точек.

Использование действия -delete в командной строке автоматически включает параметр -depth. Поскольку, в свою очередь, -depth делает -prune неэффективным. Действие -delete не может быть объединено с -prune.

Часто пользователь может захотеть протестировать командную строку поиска с помощью -print, прежде чем добавить -delete для фактического удаления. Чтобы избежать неожиданных результатов, обычно лучше не забывать явно использовать -depth во время предыдущих тестовых запусков.

Действие -delete не приведет к удалению каталога, если он не будет пустым.

Вместе с параметром -ignore_readdir_race, find будет игнорировать ошибки действия -delete; в случае, если файл исчез с момента чтения родительского каталога, она не будет выводить диагностику ошибки, не изменит код завершения на ненулевой и код возврата из родительского каталога. Действие -delete будет выполнено верно.

-exec command ;

Это действие запускает выполнение команды command; если будет возвращено значение 0, то команда выполнена успешно. Все последующие аргументы утилиты find принимаются в качестве аргументов команды, пока не будет найден аргумент, состоящий из ";". Строка "{}" заменяется текущим именем файла, которое обрабатывается везде, где оно встречается в аргументах команды, а не только в аргументах, где оно присутствует отдельно, как в некоторых версиях find. Обе эти конструкции, возможно, потребуется экранировать (с помощью "\") или заключить в кавычки, чтобы защитить их от расширения оболочкой. Примеры использования действия -exec приведены в разделе ПРИМЕРЫ. Указанная команда выполняется один раз для каждого сопоставляемого файла. Команда выполняется в начальной директории. Использование действия -exec неизбежно связано с проблемами безопасности; вместо этого следует использовать действие -execdir.

-exec command {} +

Этот вариант действия -exec запускает указанную команду для выбранных файлов, но командная строка создается путем добавления имени каждого выбранного файла в конце; общее количество вызовов команды будет намного меньше, чем количество сопоставляемых файлов. Командная строка построена во многом таким же образом, как и командная строка xargs. В команде можно указать только один экземпляр "{}" и он должен отображаться в конце, непосредственно перед символом "+"; этот экземпляр необходимо экранировать (с помощью "\") или заключить в кавычки, чтобы защитить его от интерпретации командной оболочкой. Команда выполняется в начальном каталоге. Если какой-либо вызов с форматом "+" возвращает ненулевое значение, то find возвращает также ненулевое значение. Если find обнаруживает ошибку, то это иногда может привести к немедленному завершению работы, поэтому некоторые ожидающие выполнения команды могут быть вообще не выполнены. По этой причине -exec my-command ... {} + -quit может не привести к выполнению my-command. Этот вариант -exec всегда возвращает значение true (истинно).

-execdir command ;

-execdir command {} +

Эти действия аналогичны действию -exec, но указанная команда запускается из подкаталога, содержащего соответствующий файл, который обычно не является каталогом, в котором вы запускали find. Как и в случае с -exec, фигурные скобки {} следует заключать в кавычки, если find вызывается из командной строки. Это гораздо более безопасный метод вызова команд, поскольку он позволяет избежать проблем при определении путей к соответствующим файлам. Как и в случае с действием -exec, форма "+" в -execdir создаст командную строку для обработки более чем одного соответствующего файла, но при любом вызове command будут перечислены только те файлы, которые существуют в том же подкаталоге. Если вы используете это действие, то вы должны убедиться, что ваша переменная окружения PATH не ссылается на "."; в противном случае злоумышленник может запускать любые команды, которые он захочет, оставляя файл с соответствующим именем в каталоге, в котором вы будете запускать -execdir. То же самое относится и к наличию записей в PATH, если они являются пустыми или не являются абсолютными именами каталогов. Если какой-либо вызов с форматом "+" возвращает ненулевое значение, то find возвращает также ненулевое значение. Если find обнаруживает ошибку, то это иногда может привести к немедленному завершению, поэтому некоторые ожидающие выполнения команды могут быть не выполнены. Результат этого действия зависит от того, используется ли вариант + или ;. Вариант -execdir command {} + всегда возвращает значение true, в то время как вариант -execdir command {} ; возвращает значение true только в том случае, если command возвращает 0.

-fls file

Истинно (True). Аналогично -ls, но запись в file выполняется как -fprintf. Выходной файл создается всегда, даже если для предиката нет соответствия. Смотрите раздел НЕОБЫЧНЫЕ ИМЕНА ФАЙЛОВ для получения информации о том, как обрабатываются необычные символы в именах файлов.

-fprint file

Истинно. Вывести полное имя файла в файл file. Если файл file не существует при запуске find, то он создается; если он существует, то он обрезается. Имена файлов /dev/stdout и /dev/stderr обрабатываются особым образом; они относятся к стандартному выводу и стандартной ошибке, соответственно. Выходной файл создается всегда, даже если для предиката нет соответствия. Информацию о том, как обрабатываются необычные символы в именах файлов, смотрите в разделе НЕОБЫЧНЫЕ ИМЕНА файлов.

-fprint0 file

Истинно. Аналогично -print 0, но запись в file выполняется как -fprintf. Выходной файл создается всегда, даже если для предиката нет соответствия. Смотрите раздел НЕОБЫЧНЫЕ ИМЕНА ФАЙЛОВ для получения информации о том, как обрабатываются необычные символы в именах файлов.

-fprintf file format

Истинно. Аналогично -printf, но запись в file также как -fprintf. Выходной файл создается всегда, даже если для предиката нет соответствия. Смотрите раздел НЕОБЫЧНЫЕ ИМЕНА ФАЙЛОВ для получения информации о том, как обрабатываются необычные символы в именах файлов.

-ls

Истинно. Вывести текущий файл в формате ls -dils на стандартный вывод. Количество блоков равно 1 КБАЙТ, если только не задана переменная окружения POSIXLY_CORRECT, в этом случае используются 512-байтовые блоки. Смотрите раздел НЕОБЫЧНЫЕ ИМЕНА ФАЙЛОВ для получения информации о том, как обрабатываются необычные символы в именах файлов.

-ok command ;

Аналогично -exec, но сначала спросить пользователя. Если пользователь согласен, то выполнить команду. В противном случае просто возвратить значение "ложно" (false). Если команда выполняется, то ее стандартный ввод перенаправляется с /dev/null. Это действие может не указываться вместе с параметром -files0-from.

Ответ на запрос сопоставляется с парой регулярных выражений, чтобы определить, является ли он положительным или отрицательным. Это регулярное выражение получается из системы, если задана переменная среды POSIXLY_CORRECT или иным образом из трансляции сообщений find. Если в системе нет подходящего определения, то будет использовано собственное определение find. В любом случае на интерпретацию самого регулярного выражения будут влиять переменные окружения LC_CTYPE (классы символов) и LC_COLLATE (диапазоны символов и классы эквивалентности).

-okdir command ;

Аналогично -execdir, но сначала запросить пользователя таким же образом, как и для -ok. Если пользователь не согласен, то просто возвратить false. Если команда выполняется, то ее стандартный ввод перенаправляется с /dev/null. Это действие может не указываться вместе с параметром -files0-from.

-print

Истинно. Вывести полное имя файла на стандартный вывод и после этого ввести новую строку. Если вы передаете выходные данные find в другую программу и существует малейшая вероятность того, что файлы, которые вы ищете, могут содержать новую строку, то вам следует серьезно подумать об использовании параметра -print0 вместо -print. Смотрите раздел НЕОБЫЧНЫЕ ИМЕНА ФАЙЛОВ для получения информации о том, как обрабатываются необычные символы в именах файлов.

-print0

Истинно. Вывести полное имя файла на стандартный вывод, за которым следует нулевой символ (вместо символа новой строки, который используется -print). Это позволяет программам, обрабатывающим выходные данные find и корректно интерпретировать имена файлов, содержащие символы новой строки или другие типы пробелов. Этот параметр совпадает с параметром -0 в xargs.

-printf format

Истинно. Вывести format на стандартный вывод, избегая интерпретации "\" и директивы "%". Ширина и точность полей могут быть заданы как с помощью функции С printf(3). Пожалуйста, обратите внимание, что многие поля выводятся как %s, а не %d, а это может означать, что флажки работают не так, как вы ожидаете. Это также означает, что флаг "-" действительно работает (он приводит к выравниванию полей по левому краю). В отличие от -print, -printf не добавляет новую строку в конец строки. Экранирующими элементами и директивами являются:

-prune

Истинно. Если файл является каталогом, не заходить в него. Если указано -depth, то -prune не имеет значения. Поскольку -delete подразумевает -depth, вы не можете эффективно использовать -prune и -delete вместе. Например, чтобы пропустить каталог src/emacs и все файлы и каталоги под ним и вывести имена других найденных файлов, выполните что-то вроде этого:

find . -path ./src/emacs -prune -o -print

-quit

Немедленно завершить работу (возвращается нулевое значение, если ошибок не произошло). Это отличается от -prune, поскольку -prune применяется только к содержимому удаленных каталогов, в то время как -quit просто немедленно останавливает find. Дочерние процессы не будут запущены. Все командные строки, созданные с помощью -exec ... + или -execdir ... +, вызываются перед завершением работы программы. После выполнения команды -quit больше никакие файлы, указанные в командной строке, обрабатываться не будут. Например, "find /tmp/foo /tmp/bar -print -quit" выведет только "/tmp/foo".
Одно из распространенных применений -quit - прекратить поиск в файловой системе, как только мы найдем то, что нам нужно. Например, если мы хотим найти только один файл, мы можем сделать так:

find / -name needle -print -quit

ОПЕРАТОРЫ¶

Операторы приведены в порядке убывания приоритета:

( expr )

Поскольку круглые скобки специально используются в командной строке, то они должны быть заключены в кавычки. Во многих примерах на этой странице руководства для этой же цели также, вместо "(...)", используется обратная косая черта: "\(...\)".

! expr

Истинно (True), если expr ложно (false). Этот символ ("!") также обычно нуждается в защите от интерпретации командной оболочкой.

-not expr

То же, что и ! expr, но не совместимо с POSIX.

expr1 expr2

Два выражения подряд объединяются подразумеваемым оператором -a (логическое И); значение expr2 не вычисляется, если значение expr1 "ложно" (false).

expr1 -a expr2

То же, что и expr1 expr2.

expr1 -and expr2

То же, что и expr1 expr2, но не совместимо с POSIX.

expr1 -o expr2

Логическое ИЛИ; expr2 не вычисляется, если expr1 имеет значение "истинно" (true).

expr1 -or expr2

То же, что и expr1 -o expr2, но не совместимо с POSIX.

expr1 , expr2

Список; всегда вычисляется как expr1 и expr2. Значение expr1 отбрасывается; значением списка является значение expr2. Оператор запятая может использоваться для поиска нескольких различных типов объектов, но только один раз при перемещении по иерархии файловой системы. Действие -fprintf можно использовать для составления списка различных совпадающих элементов в нескольких разных выходных файлах.

Обратите внимание, что оператор -a, если он указан неявно (например, в двух тестах, которые отображаются без явного оператора между ними) или явно, имеет более высокий приоритет, чем оператор -o. Это означает, что find . -name afile -o -name bfile -print никогда не выведет afile.

Простой способ: "find | xargs"¶

•

Найти файлы с именем core в каталоге /tmp или ниже и удалить их.

$ find /tmp -name core -type f -print | xargs /bin/rm -f


    

Примечание. Это будет работать неправильно, если какие-либо имена файлов содержат новые строки, одинарные или двойные кавычки или пробелы.

Более безопасный способ: "find -print0 | xargs -0"¶

•

Найти файлы с именем core в каталоге /tmp или ниже и удалить их; имена файлов обработать таким образом, чтобы имена файлов или каталогов, содержащие одинарные или двойные кавычки, пробелы или символы новой строки, обрабатывались корректно.

$ find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f


    

Тест -name выполняется перед тестом -type, чтобы избежать необходимости вызывать stat(2) для каждого файла.

Примечание. По-прежнему существует разница между временем, когда find обходит иерархию каталогов, выводя соответствующие имена файлов, и временем, когда процесс, выполняемый xargs, работает с этим файлом.

Обработка произвольных начальных точек¶

•

Предполагая, что другая программа proggy выполняет предварительную фильтрацию и создает огромный список файлов, разделенных НУЛЁМ, обработать список как начальные точки и найти в нём все обычные пустые файлы:

$ proggy | find -files0-from - -maxdepth 0 -type f -empty


    

Использование "-files0-from -" означает чтение имен начальных точек из standard input, т.е. из стандартного ввода, а -maxdepth 0 гарантирует, что только эти записи будут проверены явно, без обращения к каталогам (в том случае, когда одна из начальных точек является единственной).

Выполнение команды для каждого файла¶

•

Выполнить file для каждого файла в текущем каталоге или под ним.

$ find . -type f -exec file '{}' \;


    

Обратите внимание, что фигурные скобки заключены в одинарные кавычки, чтобы защитить их от интерпретации как знаков препинания в сценарии оболочки. Точка с запятой также защищена обратной косой чертой, хотя в этом случае также можно было бы использовать одинарные кавычки.

Во многих случаях можно предпочесть синтаксис `-exec ... +` или, что еще лучше, `-execdir ... +` по соображениям производительности и безопасности.

Перемещение по файловой системе (для выполнения 2-х различных действий) только один раз¶

•

Пройти по файловой системе всего один раз, поместив файлы и каталоги с установленными идентификаторами пользователя в /root/suid.txt, а большие файлы - в /root/big.txt.

$ find / \


\( -perm -4000 -fprintf /root/suid.txt '%#m %u %p\n' \) , \


\( -size +100M -fprintf /root/big.txt '%-10s %p\n' \)




    

В этом примере используется символ продолжения строки '\' в первых двух строках, чтобы указать командной оболочке продолжить чтение команды в следующей строке.

Поиск файлов по времени создания¶

•

Найти в вашем домашнем каталоге файлы, которые были изменены за последние двадцать четыре часа.

$ find $HOME -mtime 0


    

Эта команда работает таким образом, потому что время с момента последнего изменения каждого файла отделено более чем на 24 часа, а оставшееся время отбрасывается. Это означает, что для соответствия -mtime 0 файл должен был быть изменен менее чем 24 часа назад.

Поиск файлов по правам доступа¶

•

Найти файлы, которые являются исполняемыми, но не доступными для чтения.

$ find /sbin /usr/sbin -executable \! -readable -print


    

•

Найти файлы, которые имеют разрешение на чтение и запись для их владельца и группы и которые другие пользователи могут читать, но не могут записывать.

$ find . -perm 664


    

Файлы, которые соответствуют этим критериям, но имеют другие установленные биты прав доступа (например, если кто-то может запустить файл), не будут соответствовать этим критериям.

•

Найти файлы, которые имеют разрешение на чтение и запись для их владельца и группы и которые могут читать другие пользователи, независимо от наличия каких-либо дополнительных разрешений (например, бита исполняемого файла).

$ find . -perm -664


    

Здесь будут соответствовать критерию файлы, которые, например, имеют права доступа 0777.

•

Найти файлы, которые доступны для записи кому-либо (их владельцу, его группе или кому-либо еще).

$ find . -perm /222


    

•

Найти файлы, доступные для записи их владельцу или группе владельца.

$ find . -perm /220
$ find . -perm /u+w,g+w
$ find . -perm /u=w,g=w


    

Все три эти команды выполняют одно и то же, но первая использует восьмеричное представление прав доступа, а две другие - символьную форму прав доступа. Для сопоставления файлов необязательно, чтобы они были доступны для записи как владельцу, так и его группе; подойдет любая из них.

•

Найти файлы, доступные для записи как их владельцу, так и группе владельца.

$ find . -perm -220
$ find . -perm -g+w,u+w


    

Обе эти команды выполняют одно и то же действие.

•

Более тщательный поиск по правам доступа.

$ find . -perm -444 -perm /222 \! -perm /111
$ find . -perm -a+r -perm /a+w \! -perm /a+x


    

Обе эти команды выполняют поиск файлов, которые доступны для чтения всем (-perm -444 или -perm -a+r), имеют по крайней мере, один установленный бит записи (-perm /222 или -perm /a+w), но не являются исполняемыми файлами для любого пользователя (! -perm /111 или ! -perm /a+x, соответственно).

Обрезка - исключение файлов и подкаталогов¶

•

Скопировать содержимое /source-dir в /dest-dir, но пропустить файлы и каталоги (и все, что в них находится) с именем .snapshot . Она также пропускает файлы или каталоги, имена которых заканчиваются на "~", но не их содержимое.

$ cd /source-dir
$ find . -name .snapshot -prune -o \( \! -name '*~' -print0 \) \




| cpio -pmd0 /dest-dir




    

Конструкция -prune -o \( ... -print0 \) довольно распространена. Смысл здесь заключается в том, что выражение перед -prune соответствует объектам, которые необходимо обрезать. Однако само действие -prune возвращает значение true, поэтому следующее действие -o гарантирует, что правая часть вычисляется только для тех каталогов, которые не были удалены (содержимое удаленных каталогов даже не посещается, поэтому их содержимое не имеет значения). Выражение в правой части -o заключено в круглые скобки только для наглядности. Это подчеркивает, что действие -print0 выполняется только для объектов, к которым не было применено -prune. Поскольку, по умолчанию, условие "and" ("логическое И") между тестами связано более тесно, чем условие -o ("логическое ИЛИ"), то это значение в любом случае используется по умолчанию, но круглые скобки помогают показать, что происходит.

•

Используя следующий каталог проектов и связанные с ними административные каталоги SCM, выполнить эффективный поиск корневых каталогов проектов:

$ find repo/ \


\( -exec test -d '{}/.svn' \; \
-or -exec test -d '{}/.git' \; \
-or -exec test -d '{}/CVS' \; \
\) -print -prune




    

Примерный результат:

repo/project1/CVS
repo/gnu/project2/.svn
repo/gnu/project3/.svn
repo/gnu/project3/src/.svn
repo/project4/.git


    

В этом примере -prune предотвращает ненужный переход в каталоги, которые уже были обнаружены (например, мы не выполняем поиск в project3/src, потому что мы уже нашли project3/.svn), но обеспечивает нахождение родственных каталогов (project2 и project3).

Другие полезные примеры¶

•

Выполнить поиск по нескольким типам файлов.

$ find /tmp -type f,d,l


    

Выполнить поиск файлов, каталогов и символических ссылок в каталоге /tmp, передавая эти типы в виде списка, разделенного запятыми (дополнение GNU), которое в остальном эквивалентно более длинному, но более переносимому:

$ find /tmp \( -type f -o -type d -o -type l \)


    

•

Выполнить поиск файлов с определенным именем needle и немедленно остановиться, когда будет найден первый из них.

$ find / -name needle -print -quit


    

•

Демонстрация интерпретации директив формата %f и %h действия -printf для некоторых важнейших случаев. Пример, содержащий некоторые выходные данные.

$ find . .. / /tmp /tmp/TRACE compile compile/64/tests/find -maxdepth 0 -printf '[%h][%f]\n'
[.][.]
[.][..]
[][/]
[][tmp]
[/tmp][TRACE]
[.][compile]
[compile/64/tests][find]


    

Сюрпризы в отношении приоритета операторов¶

Команда find . -name afile -o -name bfile -print никогда не сделает вывод afile, потому что это на самом деле эквивалентно команде find . -name afile -o \( -name bfile -a -print \). Помните, что приоритет оператора -a является более высоким, чем оператора -o и когда между тестами не указан оператор, то предполагается, что это оператор -a.

“paths должны предшествовать expression” error message¶

$ find . -name *.c -print
find: paths must precede expression
find: possible unquoted pattern after predicate `-name'?

Это происходит, когда оболочка может расширить шаблон *.c для более чем одного имени файла, существующего в текущем каталоге и передать результирующие имена файлов в командной строке в find следующим образом:

find . -name frcode.c locate.c word_io.c -print

Эта команда, конечно, не выполнится, потому что предикат -name допускает только один шаблон в качестве аргумента. Вместо того, чтобы делать все таким образом, вам следует заключить шаблон в кавычки или экранировать подстановочный знак, что позволит find использовать шаблон с подстановочным знаком во время поиска совпадающих имен файлов вместо имен файлов, расширяемых родительской оболочкой:

$ find . -name '*.c' -print
$ find . -name \*.c -print