xargs

Построить и выполнить командную строку из читаемых со входа аргументов.

Готовые примеры · man page

Флаги

Полное имя -a: источник элементов — указанный файл.

Элементы ввода завершаются указанным символом: одиночный символ, C-style escape вроде \n, восьмеричный или шестнадцатеричный код (как в printf); многобайтовые символы не поддерживаются. Кавычки и backslash не имеют специального смысла, весь ввод читается буквально. Опция -d отключает любую строку конца файла, которая становится обычным аргументом. Применяйте её, когда ввод — просто элементы, разделённые переводом строки.

Синоним -E; предпочтительна -E, поскольку -e исключена из POSIX (IEEE Std 1003.1, 2004 Edition).

Полное имя -x: выход при превышении лимита размера командной строки.

Напечатать сводку опций xargs и завершить работу.

Полное имя -p: интерактивное подтверждение каждой командной строки.

Полное имя -n: предельное число аргументов в одной командной строке.

Полное имя -s: предельная длина командной строки в символах вместе с командой, initial-arguments и терминирующими нулями.

Синоним -L с необязательным max-lines (по умолчанию 1); устаревшее имя, в POSIX предпочтительна -L.

Полное имя -P: степень параллелизма xargs в max-procs процессов.

Полное имя -r: не выполнять команду на пустом входе.

Элементы ввода завершаются нулевым байтом, а не пробелом; кавычки и backslash не считаются специальными — каждый символ читается буквально. Отключает строку конца файла, которая трактуется как обычный аргумент. Полезно, когда элементы могут содержать пробелы, кавычки или обратные косые черты; опция GNU find -print0 даёт подходящий ввод.

Полное имя -o: дочерние процессы получают стандартный ввод, переоткрытый на /dev/tty.

Устанавливать переменную окружения name в уникальное значение в каждом запущенном дочернем процессе; освободившиеся значения переиспользуются. Подходит, например, для примитивного распределения нагрузки.

Синоним -Ireplace-str при указанном replace-str; без аргумента эквивалентно «-I{}». Вариант -i удалён из POSIX (IEEE Std 1003.1, 2004 Edition), поэтому применяйте -I.

Показать ограничения длины командной строки, накладываемые операционной системой, выбором размера буфера самим xargs и опцией -s. Подайте ввод из /dev/null (и, возможно, --no-run-if-empty), если не хотите, чтобы xargs что-либо делал.

Полное имя -t: подробный вывод командных строк в stderr.

Напечатать номер версии xargs и завершить работу. Опции --max-lines (-L, -l), --replace (-I, -i) и --max-args (-n) взаимоисключающи: при одновременном указании xargs обычно использует названную последней в командной строке, сбрасывая значение предыдущей опции к умолчательному, и выдаёт предупреждение в stderr. Исключение — специальное значение max-args «1» (как в «-n1»), которое игнорируется после --replace и его алиасов -I и -i, поскольку не действовало бы.

Установить строку конца файла в eof-str: встретив её как отдельную строку ввода, xargs игнорирует остальной ввод. Без -E и -e строка конца файла не используется вовсе; другие реализации xargs могут иметь такую строку по умолчанию, поэтому для переносимого отключения используйте -E "". См. также STANDARDS CONFORMANCE.

Заменять вхождения replace-str в initial-arguments на имена, прочитанные со стандартного ввода. Кроме того, неокаймлённые пробелы не завершают элемент — разделителем служит перевод строки. Подразумевает -x и «-L 1».

Использовать не более max-lines непустых входных строк на командную строку. Замыкающие пробелы продолжают строку логически на следующую. Подразумевает -x.

Запускать одновременно не более max-procs процессов (по умолчанию 1); при max-procs = 0 запускается столько процессов, сколько возможно. Комбинируйте -P с -n или -L, иначе скорее всего выполнится всего один exec. На ходу процессу можно послать SIGUSR1 для увеличения числа одновременных команд и SIGUSR2 для уменьшения; выше лимита реализации (видно через --show-limits) поднять нельзя, ниже 1 — опустить нельзя. xargs никогда не завершает свои команды: при уменьшении он просто ждёт завершения лишних.

Читать элементы из файла, а не из стандартного ввода. С этой опцией стандартный ввод команд остаётся прежним; иначе он перенаправляется из /dev/null.

Задаёт завершитель элементов ввода указанным символом (одиночный символ, C-style escape \n, восьмеричный или шестнадцатеричный код как в printf); многобайтовые символы не поддерживаются, кавычки и backslash читаются буквально, строка конца файла отключается.

Синоним опции -E. Используйте -E: она остаётся POSIX-совместимой, тогда как -e удалена из стандарта POSIX (IEEE Std 1003.1, 2004 Edition).

Синоним -Ireplace-str, если replace-str указан; без аргумента эффект тот же, что «-I{}». Опция -i удалена из POSIX (IEEE Std 1003.1, 2004 Edition) — используйте -I.

Синоним -L, но аргумент max-lines необязателен и по умолчанию равен 1. Опция устарела: POSIX определяет вместо неё -L.

Использовать не более max-args аргументов на командную строку. Меньше max-args будет подано при превышении размера (см. -s), если только не задан -x — тогда xargs завершается.

Переоткрывать стандартный ввод как /dev/tty в дочернем процессе перед исполнением команды; полезно для интерактивных приложений, запускаемых через xargs.

Спрашивать пользователя, выполнять ли каждую командную строку, читая строку с терминала. Команда выполняется, только если ответ начинается с 'y' или 'Y'. Подразумевает -t.

option produces input suitable for this mode.

Если стандартный ввод не содержит ни одного непробельного символа, команду не запускать. Обычно команда запускается один раз даже при пустом вводе.

Использовать не более max-chars символов на командную строку, считая саму команду, initial-arguments и завершающие нули строк аргументов. Максимально допустимое значение зависит от системы: это лимит длины аргументов для exec минус размер окружения минус 2048 байта запаса. Если оно больше 128 KiB, по умолчанию берётся 128 KiB, иначе — максимум. 1 KiB = 1024 байта. xargs автоматически подстраивается под более жёсткие ограничения.

Печатать командную строку в стандартный поток ошибок перед её исполнением.

Завершаться при превышении размера (см. -s). Отдельное «--» ограничивает список опций: последующие аргументы трактуются как операнды, даже начинаясь с «-»; например, «xargs -- --help» запускает команду --help из PATH, а не печатает справку, и «xargs -- --mycommand» исполняет --mycommand вместо отказа из-за нераспознанной опции.

xargs

Построчное объяснение

xargs (command)
Построить и выполнить командную строку из читаемых со входа аргументов.

История