find: xargs options
1
1 8.4.1 xargs options
1 -------------------
1
1 '--arg-file=INPUTFILE'
1 '-a INPUTFILE'
1 Read names from the file INPUTFILE instead of standard input. If
1 you use this option, the standard input stream remains unchanged
1 when commands are run. Otherwise, stdin is redirected from
1 '/dev/null'.
1
1 '--null'
1 '-0'
1 Input file names are terminated by a null character instead of by
1 whitespace, and any quotes and backslash characters are not
1 considered special (every character is taken literally). Disables
1 the end of file string, which is treated like any other argument.
1
1 '--delimiter DELIM'
1 '-d DELIM'
1
1 Input file names are terminated by the specified character DELIM
1 instead of by whitespace, and any quotes and backslash characters
1 are not considered special (every character is taken literally).
1 Disables the logical end of file marker string, which is treated
1 like any other argument.
1
1 The specified delimiter may be a single character, a C-style
1 character escape such as '\n', or an octal or hexadecimal escape
1 code. Octal and hexadecimal escape codes are understood as for the
1 'printf' command. Multibyte characters are not supported.
1
1 '-E EOF-STR'
1 '--eof[=EOF-STR]'
1 '-e[EOF-STR]'
1
1 Set the logical end of file marker string to EOF-STR. If the
1 logical end of file marker string occurs as a line of input, the
1 rest of the input is ignored. If EOF-STR is omitted ('-e') or
1 blank (either '-e' or '-E'), there is no logical end of file marker
1 string. The '-e' form of this option is deprecated in favour of
1 the POSIX-compliant '-E' option, which you should use instead. As
1 of GNU 'xargs' version 4.2.9, the default behaviour of 'xargs' is
1 not to have a logical end of file marker string. The POSIX
1 standard (IEEE Std 1003.1, 2004 Edition) allows this.
1
1 The logical end of file marker string is not treated specially if
1 the '-d' or the '-0' options are in effect. That is, when either
1 of these options are in effect, the whole input file will be read
1 even if '-E' was used.
1
1 '--help'
1 Print a summary of the options to 'xargs' and exit.
1
1 '-I REPLACE-STR'
1 '--replace[=REPLACE-STR]'
1 '-i[REPLACE-STR]'
1 Replace occurrences of REPLACE-STR in the initial arguments with
1 names read from standard input. Also, unquoted blanks do not
1 terminate arguments; instead, the input is split at newlines only.
1 If REPLACE-STR is omitted (omitting it is allowed only for '-i'),
1 it defaults to '{}' (like for 'find -exec'). Implies '-x' and '-l
1 1'. The '-i' option is deprecated in favour of the '-I' option.
1
1 '-L MAX-LINES'
1 '--max-lines[=MAX-LINES]'
1 '-l[MAX-LINES]'
1 Use at most MAX-LINES non-blank input lines per command line. For
1 '-l', MAX-LINES defaults to 1 if omitted. For '-L', the argument
1 is mandatory. Trailing blanks cause an input line to be logically
1 continued on the next input line, for the purpose of counting the
1 lines. Implies '-x'. The '-l' form of this option is deprecated
1 in favour of the POSIX-compliant '-L' option.
1
1 '--max-args=MAX-ARGS'
1 '-n MAX-ARGS'
1 Use at most MAX-ARGS arguments per command line. Fewer than
1 MAX-ARGS arguments will be used if the size (see the '-s' option)
1 is exceeded, unless the '-x' option is given, in which case 'xargs'
1 will exit.
1
1 '--interactive'
1 '-p'
1 Prompt the user about whether to run each command line and read a
1 line from the terminal. Only run the command line if the response
1 starts with 'y' or 'Y'. Implies '-t'.
1
1 '--no-run-if-empty'
1 '-r'
1 If the standard input is completely empty, do not run the command.
1 By default, the command is run once even if there is no input.
1
1 '--max-chars=MAX-CHARS'
1 '-s MAX-CHARS'
1 Use at most MAX-CHARS characters per command line, including the
1 command, initial arguments and any terminating nulls at the ends of
1 the argument strings.
1
1 '--show-limits'
1 Display the limits on the command-line length which are imposed by
1 the operating system, 'xargs'' choice of buffer size and the '-s'
1 option. Pipe the input from '/dev/null' (and perhaps specify
1 '--no-run-if-empty') if you don't want 'xargs' to do anything.
1
1 '--verbose'
1 '-t'
1 Print the command line on the standard error output before
1 executing it.
1
1 '--version'
1 Print the version number of 'xargs' and exit.
1
1 '--exit'
1 '-x'
1 Exit if the size (see the '-s' option) is exceeded.
1
1 '--max-procs=MAX-PROCS'
1 '-P MAX-PROCS'
1 Run simultaneously up to MAX-PROCS processes at once; the default
1 is 1. If MAX-PROCS is 0, 'xargs' will run as many processes as
1 possible simultaneously. ⇒Controlling Parallelism, for
1 information on dynamically controlling parallelism.
1
1 '--process-slot-var=ENVIRONMENT-VARIABLE-NAME'
1 Set the environment variable ENVIRONMENT-VARIABLE-NAME to a unique
1 value in each running child process. Each value is a decimal
1 integer. Values are reused once child processes exit. This can be
1 used in a rudimentary load distribution scheme, for example.
1