BSD (darwin too)
Number of replacments for -I. Default: 5
Will not affect how many arguments will be read from input (-n), or
the size of the command(s) xargs will generate (-s).
repl-str must occur as a distinct argument, not within a quoted string.
Example: copy the list of files and directories which start with an uppercase letter in the current directory to destdir:
/bin/ls -1d [A-Z]* | xargs -J % cp % destdir
‑‑verbose
-t Display the constructed command on STDERR before executing it.
| ‑‑interactive
-p Prompt before running each command.
Implies ‑‑verbose.
| ‑‑null
-0
STDIN‑args (perhaps piped from another process like find) have been terminated by a null
instead of whitespace, allowing the processing of filenames with embedded special characters like spaces, quotes or backslashes.
find -print0 is compatible with --null.
", \ etc are not special (all characters are taken literally).
Disables the eof-str.
| --arg-file=file
-a fileGNU
Read items from file instead of standard input.
stdin is unchanged when commands are run. Otherwise, stdin is redirected from /dev/null.
| --delimiter=delim
-d delimGNU
Input items have been terminated by delim, Quotes and backslash are not special;
characters in the input are taken literally.
Disables the end-of-file string, which is treated like any other argument.
Used when the input consists of newline separated items, (it is prefered to write a program to use '--null')
delim may be a single character, a shell escape such as \n,
or an octal or hexadecimal escape code, as for printf. Multibyte characters are not supported.
|
-E eof-str
‑‑eof[=eof-str]
-e[eof-str]
Processing an input file is stopped when eof-str is encountered.
If eof-str is omitted, there is no end-of file string.
|
‑‑max‑chars=max‑chars
-s max‑chars
Limit command line to max‑chars including the
command and common arguments and the terminating nulls at the
ends of the argument strings. The default is as large as possible, up to 20k characters.
|
‑‑max‑lines[=max‑lines]
-l[max‑lines]
Use at most max‑lines nonblank input lines per command line, default :1
Trailing blanks cause an input line to be logically continued on the next input line!
Implies ‑‑exit.
| ‑‑no-run-if-empty
-r
If STDIN‑arg does not contain strings, do not run command.
Default: command is run once even if there is no input.
| ‑‑exit
-x Exit if the max-chars is exceeded.
Use ‑‑max‑args with ‑‑interactive; otherwise chances are that only one exec will be done.
| ‑‑max‑procs=max‑procs
-P max‑procs
Run up to max‑procs processes at a time;
the default is 1.
If max‑procs is 0(bad), xargs will run as many processes as possible at a time.
This will cause the system_process_table
to fill up resulting in some process (not necessarily your's) partially completing, some being skipped and general mayhem.
If a process sub-shells a dozen times and xargs starts 100, that's 1200! See ulimit
| ‑‑help Output a summary of the options to xargs and exit.
> xargs --help
Usage: xargs [-0prtx] [--interactive] [--null] [-d|--delimiter=delim]
[-E eof-str] [-e[eof-str]] [--eof[=eof-str]]
[-L max-lines] [-l[max-lines]] [--max-lines[=max-lines]]
[-I replace-str] [-i[replace-str]] [--replace[=replace-str]]
[-n max-args] [--max-args=max-args]
[-s max-chars] [--max-chars=max-chars]
[-P max-procs] [--max-procs=max-procs] [--show-limits]
[--verbose] [--exit] [--no-run-if-empty] [--arg-file=file]
[--version] [--help] [command [initial-arguments]]
Report bugs to <bug-findutils@gnu.org>.
usage: xargs [-0opt] [-E eofstr] [-I replstr [-R replacements]] [-J replstr]
[-L number] [-n number [-x]] [-P maxprocs] [-s size]
[utility [argument ...]]
‑‑versionxargs (GNU findutils) 4.4.2
Copyright (C) 2007 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Written by Eric B. Decker, James Youngman, and Kevin Dalley.
Built using GNU gnulib version e5573b1bad88bfabcda181b9e0125fb0c52b7d3b
| | | | | | | | | | | | | | | |