XARGS(1)
НАЗВАНИЕ
xargs - формирование списка аргументов и выполнение команды
СИНТАКСИС
xargs [-lчисло] [-iзам_цеп] [-nчисло] [-t] [-p] [-x] [-sразмер]
[-e[лконф_цеп]] [команда [начальный_аргумент ...]]
ОПИСАНИЕ
Команда xargs об единяет зафиксированный набор заданных
в командной строке начальных_аргументов с аргументами,
прочитанными со стандартного ввода, и выполняет указанную команду один или несколько раз. Число аргументов,
которые должны быть прочитаны для каждого вызова команды, и способ, которым они об единяются, определяются
заданными опциями.
Xargs использует значение переменной окружения $PATH
для поиска команды, которая может быть файлом shell'а.
Если команда опущена, используется /bin/echo.
Аргументы, прочитанные со стандартного ввода, - это
непрерывные цепочки символов, разделенные одним или
несколькими пробелами, символами табуляции или переводами строки; пустые строки игнорируются. Чтобы включить
в аргумент пробелы и табуляции, их надо выделить символами \ или кавычками; символы, заключенные в кавычки
(одинарные или двойные) воспринимаются буквально; сами
кавычки удаляются. Вне цепочек в кавычках обратная наклонная черта (\) вместе со следующим символом обозначает соответствующий управляющий символ.
Конструирование каждого списка аргументов начинается с
начальных_аргументов, за ними следует несколько аргументов со стандартного ввода (есть исключение: см. опцию -i). Опции -i, -l и -n определяют, как выбирать аргументы для каждого вызова команды. Когда ни одна из
этих опций не указана, за начальными_аргументами следует несколько аргументов, прочитанных подряд со стандартного ввода до заполнения внутреннего буфера; затем
выполняется команда с накопленными аргументами. Данный
процесс повторяется до тех пор, пока все аргументы не
будут исчерпаны. Если указаны взаимоисключающие опции
(например, одновременно заданы опции -l и -n), берется
во внимание последняя.
Опциям команды xargs приписан следующий смысл:
- -lчисло
-
Выполнять команду для каждой группы из заданного
числа непустых строк аргументов, прочитанных со
стандартного ввода. Последний вызов команды может
быть с меньшим числом строк аргументов. Считается,
что строка заканчивается первым встретившимся символом перевода строки, если только перед ним не
стоит пробел или символ табуляции; пробел/табуляция в конце сигнализируют о том, что следующая непустая строка является продолжением данной. Если
число опущено, оно считается равным 1. Опция -l
включает опцию -x.
- -iзам_цеп
-
Режим вставки: команда выполняется для каждой
строки стандартного ввода, причем вся строка рассматривается как один аргумент и подставляется в
начальные_аргументы вместо каждого вхождения цепочки символов зам_цеп. Допускается не более 5 начальных_аргументов, содержащих одно или несколько
вхождений зам_цеп. Пробелы и табуляции в начале
вводимых строк отбрасываются. Сформированные аргументы не могут быть длиннее 255 символов. Если цепочка зам_цеп не задана, она полагается равной
{ }. Опция -i включает опцию -x.
- -nчисло
-
Выполнить команду, используя максимально возможное
количество аргументов, прочитанных со стандартного
ввода, но не более заданного числа. Будет использовано меньше аргументов, если их общая длина превышает размер (см. ниже опцию -s), или если для
последнего вызова их осталось меньше, чем заданное
число. Если указана также опция -x, каждая группа
из указанного числа аргументов должны укладываться
в ограничение размера, иначе выполнение xargs
прекращается.
- -t
- Режим трассировки: команда и каждый построенный
список аргументов перед выполнением заносятся в
стандартный протокол.
- -p
- Режим с приглашением: xargs перед каждым вызовом
команды запрашивает подтверждение. Включается режим трассировки (-t), за счет чего печатается вызов команды, который должен быть выполнен, а за
ним - приглашение ?.... Ответ y (за которым может
идти что угодно) приводит к выполнению команды;
при каком-либо другом ответе, включая возврат каретки, данный вызов команды игнорируется.
- -x
- Завершить выполнение, если очередной список аргументов оказался длиннее, чем размер (в символах).
Опция -x включается опциями -i и -l. Если ни одна
из опций -i, -l или -n не указана, общая длина
всех аргументов должна укладываться в ограничение
размера.
- -sразмер
-
Максимальный общий размер (в символах) каждого
списка аргументов установить равным заданному размеру. Размер должен быть положительным числом, не
превосходящим 470 (подразумеваемое значение). При
выборе размера следует учитывать, что к каждому
аргументу добавляется по одному символу; кроме того, запоминается число символов в имени команды.
- -e[лконф_цеп]
-
Цепочка символов лконф_цеп считается признаком логического конца файла. Если опция -e не указана,
признаком конца считается подчеркивание (_). Опция
-e без лконф_цеп аннулирует возможность устанавливать логический конец файла (подчеркивание при
этом рассматривается как обычный символ). Команда
xargs читает стандартный ввод до тех пор, пока не
дойдет до конца файла или не встретит цепочку
лконф_цеп.
Выполнение программы xargs прекращается, если она получает от команды код завершения -1 или если команда не
может быть выполнена. Если команда - это shell-программа, она должна явно выполнять exit [см. sh(1)] с соответствующим аргументом, чтобы избежать случайного возврата кода -1.
ПРИМЕРЫ
- Следующая shell-процедура пересылает все файлы из
каталога $1 в каталог $2 и сообщает о каждой пересылке
перед тем, как ее выполнить:
ls $1 | xargs -i -t mv $1/{} $2/{}
- Следующая команда об единяет вывод команд, заключенных в скобки, в одну строку, которая затем добавляется
в конец файла log:
(logname; date; echo $0 $*) | xargs >>log
- Пользователя спрашивают, какие файлы из текущего каталога должны быть занесены в архив. При выполнении
первой команды (см. ниже) файлы заносятся в архив arch
по одному; при выполнении второй команды в архив заносится сразу много файлов.
ls | xargs -p -l ar r arch
ls | xargs -p -l | xargs ar r arch
- Следующая shell-процедура применяет команду diff(1)
к последовательным парам своих аргументов.
echo $* | xargs -n2 diff
СМ. ТАКЖЕ
sh(1).
ДИАГНОСТИКА
Не требует пояснений