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