home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / manpages.zoo / xargs.1 < prev    next >
Encoding:
Text File  |  1991-11-12  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XARGS(1L)                                               XARGS(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      xargs - build and execute command lines from standard input
  10.  
  11. SYNOPSIS
  12.      xargs [-0prtx] [-e[eof-str]] [-i[replace-str]] [-l[max-
  13.      lines]] [-n max-args] [-s max-chars] [-P max-procs] [+null]
  14.      [+eof[=eof-str] [+replace[=replace-str] [+max-lines[=max-
  15.      lines] [+interactive] [+max-chars max-chars] [+verbose]
  16.      [+exit] [+max-procs max-procs] [+no-run-if-empty] [command
  17.      [initial-arguments]]
  18.  
  19. DESCRIPTION
  20.      This manual page documents the GNU version of xargs.  xargs
  21.      reads arguments from the standard input, delimited by blanks
  22.      (which can be protected with double or single quotes or a
  23.      backslash) or newlines, and executes the _✓c_✓o_✓m_✓m_✓a_✓n_✓d (default is
  24.      /bin/echo) one or more times with any _✓i_✓n_✓i_✓t_✓i_✓a_✓l-_✓a_✓r_✓g_✓u_✓m_✓e_✓n_✓t_✓s fol-
  25.      lowed by arguments read from standard input.  Blank lines on
  26.      the standard input are ignored.
  27.  
  28.      xargs exits with the following status:
  29.      0 if it succeeds
  30.      123 if any invocation of the command exited with status 1-125
  31.      124 if the command exited with status 255
  32.      125 if the command is killed by a signal
  33.      126 if the command cannot be run
  34.      127 if the command is not found
  35.      1 if some other error occurred.
  36.  
  37.      OPTIONS
  38.  
  39.      +_✓n_✓u_✓l_✓l, -_✓0
  40.           Input filenames are terminated by a null character
  41.           instead of by whitespace and the quotes and backslash
  42.           are not special (every character is taken literally).
  43.           However, any end of file string is still recognized.
  44.           Useful with the GNU find -print0 option when filenames
  45.           might contain white space, quote marks, or backslashes.
  46.  
  47.      +_✓e_✓o_✓f[=_✓e_✓o_✓f-_✓s_✓t_✓r], -_✓e[_✓e_✓o_✓f-_✓s_✓t_✓r]
  48.           Set the end of file string to _✓e_✓o_✓f-_✓s_✓t_✓r.  (If the end of
  49.           file string occurs as a line of input, the rest of the
  50.           input is ignored.)  If _✓e_✓o_✓f-_✓s_✓t_✓r is omitted, there is no
  51.           end of file string.  If this option is not given, the
  52.           end of file string defaults to "_".
  53.  
  54.      +_✓r_✓e_✓p_✓l_✓a_✓c_✓e[=_✓r_✓e_✓p_✓l_✓a_✓c_✓e-_✓s_✓t_✓r], -_✓i[_✓r_✓e_✓p_✓l_✓a_✓c_✓e-_✓s_✓t_✓r]
  55.           Replace occurences of _✓r_✓e_✓p_✓l_✓a_✓c_✓e-_✓s_✓t_✓r in the initial argu-
  56.           ments with names read from standard input.  If
  57.           _✓r_✓e_✓p_✓l_✓a_✓c_✓e-_✓s_✓t_✓r is omitted, it defaults to "{}" (like for
  58.           `find -exec').  Causes the command to be executed once
  59.           per line of input.  Implies -_✓x.
  60.  
  61.  
  62.  
  63. Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XARGS(1L)                                               XARGS(1L)
  71.  
  72.  
  73.  
  74.      +_✓m_✓a_✓x-_✓l_✓i_✓n_✓e_✓s[=_✓m_✓a_✓x-_✓l_✓i_✓n_✓e_✓s], -_✓l[_✓m_✓a_✓x-_✓l_✓i_✓n_✓e_✓s]
  75.           Use at most _✓m_✓a_✓x-_✓l_✓i_✓n_✓e_✓s nonblank input lines per command
  76.           line; _✓m_✓a_✓x-_✓l_✓i_✓n_✓e_✓s defaults to 1 if omitted.  Trailing
  77.           blanks cause an input line to be logically continued on
  78.           the next input line.  Implies -_✓x.
  79.  
  80.      +_✓m_✓a_✓x-_✓a_✓r_✓g_✓s _✓m_✓a_✓x-_✓a_✓r_✓g_✓s, -_✓n _✓m_✓a_✓x-_✓a_✓r_✓g_✓s
  81.           Use at most _✓m_✓a_✓x-_✓a_✓r_✓g_✓s arguments per command line.  Fewer
  82.           than _✓m_✓a_✓x-_✓a_✓r_✓g_✓s arguments will be used if the size (see
  83.           the -s option) is exceeded, unless the -x option is
  84.           given, in which case xargs will exit.
  85.  
  86.      +_✓i_✓n_✓t_✓e_✓r_✓a_✓c_✓t_✓i_✓v_✓e, -_✓p
  87.           Prompt the user about whether to run each command line
  88.           and read a line from the terminal.  Only run the com-
  89.           mand line if the response starts with `y' or `Y'.
  90.           Implies -_✓t.
  91.  
  92.      +_✓n_✓o-_✓r_✓u_✓n-_✓i_✓f-_✓e_✓m_✓p_✓t_✓y, -_✓r
  93.           If the standard input does not contain any nonblanks,
  94.           do not run the command.  Normally, the command is run
  95.           once even if there is no input.
  96.  
  97.      +_✓m_✓a_✓x-_✓c_✓h_✓a_✓r_✓s _✓m_✓a_✓x-_✓c_✓h_✓a_✓r_✓s, -_✓s _✓m_✓a_✓x-_✓c_✓h_✓a_✓r_✓s
  98.           Use at most _✓m_✓a_✓x-_✓c_✓h_✓a_✓r_✓s characters per command line,
  99.           including the command and initial arguments.  The
  100.           default is as large as possible.
  101.  
  102.      +_✓v_✓e_✓r_✓b_✓o_✓s_✓e, -_✓t
  103.           Print the command line on the standard error output
  104.           before executing it.
  105.  
  106.      +_✓e_✓x_✓i_✓t, -_✓x
  107.           Exit if the size (see the -_✓s option) is exceeded.
  108.  
  109.      +_✓m_✓a_✓x-_✓p_✓r_✓o_✓c_✓s _✓m_✓a_✓x-_✓p_✓r_✓o_✓c_✓s, -_✓P _✓m_✓a_✓x-_✓p_✓r_✓o_✓c_✓s
  110.           Run up to _✓m_✓a_✓x-_✓p_✓r_✓o_✓c_✓s processes at a time; the default is
  111.           1.  If _✓m_✓a_✓x-_✓p_✓r_✓o_✓c_✓s is 0, xargs will run as many processes
  112.           as possible at a time.  Use the -_✓n option with -_✓P; oth-
  113.           erwise chances are that only one exec will be done.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2
  130.  
  131.  
  132.  
  133.