History log of /freebsd-10.1-release/usr.bin/xargs/xargs.1
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 272461 02-Oct-2014 gjb

Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 233038 16-Mar-2012 jilles

xargs: Before exiting, wait for all invocations of the utility.

This only has an effect with -P, otherwise errors are only detected when the
utility is not running.

Submitted by: Matthew Story


# 219958 24-Mar-2011 ru

Discourage from using "cp -r".


# 216370 11-Dec-2010 joel

Remove the advertising clause from UCB copyrighted files in usr.bin. This
is in accordance with the information provided at
ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change

Also add $FreeBSD$ to a few files to keep svn happy.

Discussed with: imp, rwatson


# 175728 27-Jan-2008 keramida

Revive '-opt' flags which I accidentally removed.

Noticed by: simon


# 175680 26-Jan-2008 keramida

Document the no-op -r option of BSD xargs(1).

PR: docs/106416
Submitted by: Pete Slagle, freebsd-stable at voidcaptain.com
MFC after: 3 days


# 162792 29-Sep-2006 ru

Markup fixes.


# 153918 30-Dec-2005 jmallett

Add a FreeBSD-specific -S flag which controls the maximum size of an argument
having replacements done in it via -I.


# 153198 07-Dec-2005 des

Wording tweaks.

PR: not quite docs/84620
MFC after: 2 weeks


# 146466 21-May-2005 ru

Sync program's usage() with manpage's SYNOPSIS.


# 140368 17-Jan-2005 ru

Added the EXIT STATUS section where appropriate.


# 132998 02-Aug-2004 tjr

Document incorrect handling of multibyte characters with -I and -J options.


# 131229 28-Jun-2004 dd

Fix spelling error in my own paragraph.


# 115217 21-May-2003 ru

Markup bits.

Approved by: re (blanket)


# 112514 23-Mar-2003 mux

Add a new -o option to tell xargs(1) to reopen /dev/tty as stdin in
the child process, before executing the command. This is very useful
when you do stuff like ``find ... | xargs interactive_application''.
Without -o, the application would inherit the pipe as its stdin, and
you thus lose any control over it.

This flag has been carefully chosen to not conflit with other options
of other xargs utilities like GNU xargs.

Reviewed by: jmallett


# 111581 26-Feb-2003 jmallett

Extend our -R extension which sets the number of arguments in which -I will
replace to support magic values less than zero, which mean to just go nuts
and expand as many as we want.

MFC after: 2 weeks


# 109944 27-Jan-2003 trhodes

A few changes for clarity.

PR: 47170
Submitted by: Gary W. Swearingen <swear@attbi.com> (original version)


# 108317 27-Dec-2002 schweikh

english(4) police.


# 108215 23-Dec-2002 ru

mdoc(7) police: most -mdoc macros can take multiple arguments.


# 108156 21-Dec-2002 tjr

Add the -P option which executes multiple copies of the specified utility
in parallel. Idea from GNU xargs.


# 98614 22-Jun-2002 jmallett

When giving an example that relies on shell expansion/globbing, don't use a
replstr for -J that will be interpereted by the shell.

MFC after: 1 day


# 98107 10-Jun-2002 jmallett

Note that this appeared at least as early as PWB UNIX.

Use the literal string 'PWB UNIX', as we still have no .At macro for it.


# 97549 30-May-2002 ru

mdoc(7) police: punctuation, miscellaneous.


# 96619 14-May-2002 jmallett

Fix a "tiny and squeeby and little" markup mistake.

Submitted by: fenner


# 96057 05-May-2002 jmallett

Modify the -p implementation to use a user's locale, so they can respond to
the prompt in their native language.

Also make the prompt fit what POSIX asks for (?...).

This should not affect use of -p with yes(1) [as every locale I know of matches
'y' as YESEXPR as well], but that's what -t is for anyway. -p is meant to be
really used interactively.

Submitted by: tjr, jmallett


# 95906 02-May-2002 jmallett

A markup fix, and document -R as non-standard.


# 95905 02-May-2002 jmallett

Make -J a proper flag internal to the code (rather than just check for
use of replstr and lack of Iflag), and add -R, which when given with
-I controls the number of arguments on which replacement will be done.

Some people happen to think it's idiotic to limit to 5 arguments, so
let the user override it if they like.


# 95080 19-Apr-2002 jmallett

After 3 months...

Merge xargs(1) with that of xMach.

Bring in xargs(1) changes to add -L and -I as per the Single Unix Specification
version 3. Proper exit status numbers are implemented, and the manual page has
been updated to reflect reality.

The code has been ANSIfied, and a new file has been added to xargs(1) to do the
substring substitution as SUSv3 requires.

Traditional behaviour should not be affected, use of -J should be deprecated
in favor of the more portable -I (though -J has been left, for now).

Submitted by: me, tjr (the exit status stuff)
Obtained from: xMach


# 79297 05-Jul-2001 dd

Spelling police: extention -> extension.


# 76605 14-May-2001 dd

Add a -J replstr option that allows the user to tell xargs to insert
the data read from standard input at a specific point in the command
line arguments rather than at the end.

Submitted by: dd, gad
Reviewed by: gad, brian


# 76201 02-May-2001 dd

Alphabetize command-line options in the synopsis.


# 75466 13-Apr-2001 ru

mdoc(7) police: Fixed typo and markup in rev.1.11.


# 75398 10-Apr-2001 brian

o The -s limit is ARG_MAX - 4K, not ARG_MAX - 2K.
o Mention that the current environment is part of the -s calculation.
o Add a BUGS section that warns against executing a program that increases
the size of the argument list or the size of the environment.

I have wondered for a while what the difference is between

get a big list | xargs sudo command

which fails and

get a big list | sudo xargs command

which succeeds. The answer is that in the first case, sudo expands
the environment and pushes the amount of data passed into execve over
the E2BIG threshold.


# 70410 27-Dec-2000 ru

Prepare for mdoc(7)NG.


# 70197 19-Dec-2000 ru

Prepare for mdoc(7)NG.


# 68963 20-Nov-2000 ru

mdoc(7) police: use the new features of the Nm macro.


# 58627 26-Mar-2000 charnier

Use .Xr


# 50477 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 48792 12-Jul-1999 nik

Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde


# 31694 13-Dec-1997 danny

Submitted by: Peter Hawkins <peter@clari.net.au>
Spelling police.


# 28826 27-Aug-1997 charnier

Use err(3) instead of local redefinition.


# 19318 01-Nov-1996 imp

Reviewed by: Warner Losh <imp@village.org>
Submitted by: Marc Slemko <marcs@znep.com>
Obtained from: OpenBSD

Add -0 for reading the results of find -0.


# 1591 27-May-1994 rgrimes

This commit was generated by cvs2svn to compensate for changes in r1590,
which included commits to RCS files with non-trunk default branches.


# 1590 27-May-1994 rgrimes

BSD 4.4 Lite Usr.bin Sources