version 1.13, 2003/06/12 17:55:01 |
version 1.14, 2005/09/10 23:00:29 |
|
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm xargs |
.Nm xargs |
.Bk -words |
.Bk -words |
.Op Fl 0opt |
.Op Fl 0oprt |
.Op Fl E Ar eofstr |
.Op Fl E Ar eofstr |
.Oo |
.Oo |
.Fl I Ar replstr |
.Fl I Ar replstr |
|
|
from standard input. |
from standard input. |
The |
The |
.Ar utility |
.Ar utility |
is repeatedly executed until standard input is exhausted. |
is repeatedly executed one or more times 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 ' |
.Pq Ql ' |
|
|
If |
If |
.Ar replacements |
.Ar replacements |
is negative, the number of arguments in which to replace is unbounded. |
is negative, the number of arguments in which to replace is unbounded. |
|
.It Fl r |
|
Do not run the command if there are no arguments. |
|
Normally the command is executed at least once |
|
even if there are no arguments. |
.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 . |
|
|
.St -p1003.2 |
.St -p1003.2 |
compliant. |
compliant. |
The |
The |
.Fl J , o , P |
.Fl J , o , P , R |
and |
and |
.Fl R |
.Fl r |
options are non-standard |
options are non-standard |
extensions which may not be available on other operating systems. |
extensions which may not be available on other operating systems. |
.Pp |
.Pp |