version 1.6, 1998/10/30 00:24:44 |
version 1.7, 1999/08/18 13:09:45 |
|
|
.Op Ar utility Op Ar arguments ... |
.Op Ar utility Op Ar arguments ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm xargs |
.Nm |
utility reads space, tab, newline and end-of-file delimited arguments |
utility reads space, tab, newline, and end-of-file delimited arguments |
from the standard input and executes the specified |
from the standard input and executes the specified |
.Ar utility |
.Ar utility |
with them as |
with them as |
|
|
is repeatedly executed until standard input is exhausted. |
is repeatedly executed until standard input is exhausted. |
.Pp |
.Pp |
Spaces, tabs and newlines may be embedded in arguments using single |
Spaces, tabs and newlines may be embedded in arguments using single |
(``\ '\ '') |
.Pq Ql ' |
.Ek |
or double |
or double (``"'') quotes or backslashes (``\e''). |
.Pq Ql \&" |
|
quotes or backslashes |
|
.Pq Ql \e . |
Single quotes escape all non-single quote characters, excluding newlines, |
Single quotes escape all non-single quote characters, excluding newlines, |
up to the matching single quote. |
up to the matching single quote. |
Double quotes escape all non-double quote characters, excluding newlines, |
Double quotes escape all non-double quote characters, excluding newlines, |
|
|
.Bl -tag -width indent |
.Bl -tag -width indent |
.It Fl 0 |
.It Fl 0 |
Changes |
Changes |
.Nm xargs |
.Nm |
to expect NUL |
to expect NUL |
(``\\0'') |
.Pq Ql \e0 |
characters as separators, instead of spaces and newlines. |
characters as separators, instead of spaces and newlines. |
This is expected to be used in concert with the |
This is expected to be used in concert with the |
.Fl print0 |
.Fl print0 |
function in |
function in |
.Nm find . |
.Xr find 1 . |
.It Fl n Ar number |
.It Fl n Ar number |
Set the maximum number of arguments taken from standard input for each |
Set the maximum number of arguments taken from standard input for each |
invocation of the utility. |
invocation of the utility. |
|
|
.Ar number |
.Ar number |
is 5000. |
is 5000. |
.It Fl s Ar size |
.It Fl s Ar size |
Set the maximum number of bytes for the command line length provided to |
Set the maximum number of bytes for the command-line length provided to |
.Ar utility . |
.Ar utility . |
The sum of the length of the utility name and the arguments passed to |
The sum of the length of the utility name and the arguments passed to |
.Ar utility |
.Ar utility |
(including |
(including null terminators) will be less than or equal to this number. |
.Dv NULL |
|
terminators) will be less than or equal to this number. |
|
The current default value for |
The current default value for |
.Ar size |
.Ar size |
is |
is |
|
|
is executed. |
is executed. |
.It Fl x |
.It Fl x |
Force |
Force |
.Nm xargs |
.Nm |
to terminate immediately if a command line containing |
to terminate immediately if a command line containing |
.Ar number |
.Ar number |
arguments will not fit in the specified (or default) command line length. |
arguments will not fit in the specified (or default) command-line length. |
.El |
.El |
.Pp |
.Pp |
If no |
If no |
|
|
reads from the standard input. |
reads from the standard input. |
.Pp |
.Pp |
The |
The |
.Nm xargs |
.Nm |
utility exits immediately (without processing any further input) if a |
utility exits immediately (without processing any further input) if a |
command line cannot be assembled, |
command line cannot be assembled, |
.Ar utility |
.Ar utility |
cannot be invoked, an invocation of the utility is terminated by a signal |
cannot be invoked, an invocation of the utility is terminated by a signal, |
or an invocation of the utility exits with a value of 255. |
or an invocation of the utility exits with a value of 255. |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
.Nm xargs |
.Nm |
exits with one of the following values: |
exits with one of the following values: |
.Pp |
.Pp |
.Bl -tag -width Ds -compact |
.Bl -tag -width Ds -compact |
|
|
.Xr find 1 |
.Xr find 1 |
.Sh STANDARDS |
.Sh STANDARDS |
The |
The |
.Nm xargs |
.Nm |
utility is expected to be |
utility is expected to be |
.St -p1003.2 |
.St -p1003.2 |
compliant. |
compliant. |
.Sh HISTORY |
.Sh HISTORY |
The meaning of 123, 124, and 125 exit values were taken from GNU xargs. |
The meaning of 123, 124, and 125 exit values were taken from GNU |
|
.Nm xargs . |