Print this page
4703 would like xargs support for -P

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/xargs.1
          +++ new/usr/src/man/man1/xargs.1
   1    1  '\" te
   2    2  .\"  Copyright 1989 AT&T Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
   3    3  .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
   4    4  .\" http://www.opengroup.org/bookstore/.
   5    5  .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
   6    6  .\"  This notice shall appear on any product containing this material.
   7    7  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   8    8  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   9    9  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  10      -.TH XARGS 1 "November 24, 2012"
       10 +.TH XARGS 1 "March 31, 2014"
  11   11  .SH NAME
  12   12  xargs \- construct argument lists and invoke utility
  13   13  .SH SYNOPSIS
  14   14  .LP
  15   15  .nf
  16   16  \fBxargs\fR [\fB-t\fR] [\fB-0\fR] [\fB-p\fR] [\fB-e\fR[\fIeofstr\fR]] [\fB-E\fR \fIeofstr\fR]
  17   17       [\fB-I\fR \fIreplstr\fR] [\fB-i\fR[\fIreplstr\fR]] [\fB-L\fR \fInumber\fR] [\fB-l\fR[\fInumber\fR]]
  18      -     [\fB-n\fR \fInumber\fR [\fB-x\fR]] [\fB-s\fR \fIsize\fR] [\fIutility\fR [\fIargument\fR...]]
       18 +     [\fB-n\fR \fInumber\fR [\fB-x\fR]] [\fB-P\fR \fImaxprocs\fR] [\fB-s\fR \fIsize\fR]
       19 +     [\fIutility\fR [\fIargument\fR...]]
  19   20  .fi
  20   21  
  21   22  .SH DESCRIPTION
  22   23  .sp
  23   24  .LP
  24   25  The \fBxargs\fR utility constructs a command line consisting of the
  25   26  \fIutility\fR and \fIargument\fR operands specified followed by as many
  26   27  arguments read in sequence from standard input as fit in length and number
  27   28  constraints specified by the options. The \fBxargs\fR utility then invokes the
  28   29  constructed command line and waits for its completion. This sequence is
↓ open down ↓ 130 lines elided ↑ open up ↑
 159  160  .ne 2
 160  161  .na
 161  162  \fB-p\fR
 162  163  .ad
 163  164  .RS 15n
 164  165  Prompt mode. The user is asked whether to execute \fIutility\fR at each
 165  166  invocation. Trace mode (\fB-t\fR) is turned on to write the command instance to
 166  167  be executed, followed by a prompt to standard error. An affirmative response
 167  168  (specific to the user's locale) read from \fB/dev/tty\fR executes the command;
 168  169  otherwise, that particular invocation of \fIutility\fR is skipped.
      170 +.RE
      171 +
      172 +.sp
      173 +.ne 2
      174 +.na
      175 +\fB\fB-P\fR \fImaxprocs\fR\fR
      176 +.ad
      177 +.RS 15n
      178 +Invokes \fIutility\fR using at most \fImaxprocs\fR (a positive decimal integer)
      179 +parallel child processes.
 169  180  .RE
 170  181  
 171  182  .sp
 172  183  .ne 2
 173  184  .na
 174  185  \fB\fB-s\fR \fIsize\fR\fR
 175  186  .ad
 176  187  .RS 15n
 177  188  Invokes \fIutility\fR using as many standard input arguments as possible
 178  189  yielding a command line length less than \fIsize\fR (a positive decimal
↓ open down ↓ 291 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX