From 3258b8ddfc74e715964ecddf6bf962cb23cfac9d Mon Sep 17 00:00:00 2001
From: jay <jay>
Date: Mon, 3 May 2004 10:11:04 +0000
Subject: [PATCH] document the various suffixes for -size and also the new
 option -ignore_readdir_race

---
 find/find.1 | 44 ++++++++++++++++++++++++++++++++++++--------
 1 file changed, 36 insertions(+), 8 deletions(-)

diff --git a/find/find.1 b/find/find.1
index aad60a8..e7d976b 100644
--- a/find/find.1
+++ b/find/find.1
@@ -200,14 +200,30 @@ system library function where this is present (i.e. on systems using
 the GNU C Library).  On other systems, the implementation within
 Gnulib is used; by default, Gnulib provides "basic" regular
 expressions.
-.IP "\-size \fIn\fR[bckw]"
-File uses \fIn\fP units of space.  The units are 512-byte blocks by
-default or if `b' follows \fIn\fP, bytes if `c' follows \fIn\fP,
-kilobytes if `k' follows \fIn\fP, or 2-byte words if `w' follows
-\fIn\fP.  The size does not count indirect blocks, but it does count
-blocks in sparse files that are not actually allocated.  Bear in mind
-that the `%k' and `%b' format specifiers of \-printf handle sparse
-files differently.
+.IP "\-size \fIn\fR[cwbkMG]"
+File uses \fIn\fP units of space.  The following suffixes 
+can be used:
+.RS
+.IP `b' 
+for 512-byte blocks (this is the default if no suffix is used)
+.IP `c' 
+for bytes
+.IP `w' 
+for two-byte words
+.IP `k' 
+for Kilobytes (units of 1024 bytes)
+.IP `M' 
+for Megabytes (units of 1048576 bytes)
+.IP `G' 
+for Gigabytes (units of 1073741824 bytes)
+.RE
+.IP
+The size does not count indirect blocks, but it does count blocks in
+sparse files that are not actually allocated.  Bear in mind that the
+`%k' and `%b' format specifiers of \-printf handle sparse files
+differently.  The `b' suffix always denotes 512-byte blocks and never
+1 Kilobyte blocks, which is different to the behaviour of \-ls.
+
 .IP \-true
 Always true.
 .IP "\-type \fIc\fR"
@@ -463,6 +479,18 @@ If \-depth is given, false; no effect.
 True; list current file in `ls \-dils' format on standard output.
 The block counts are of 1K blocks, unless the environment variable
 POSIXLY_CORRECT is set, in which case 512-byte blocks are used.
+.IP \-ignore_readdir_race
+Normally, \fBfind\fR will emit an error message when it fails to stat a file.
+If you give this option and a file is deleted between the time \fBfind\fR 
+reads the name of the file from the directory and the time it tries to stat 
+the file, nno error message will be issued.    This also applies to files
+or directories whose names are given on the command line.  This option takes
+effect at the time the command line is read, which means that you cannot search
+one part of the filesystem with this option on and part of it with this option
+off (if you need to do that, you will need to issue two \fBfind\fR commands
+instead, one with the option and one without it).
+.IP \-noignore_readdir_race
+Turns off the effect of \-ignore_readdir_race. 
 .SS OPERATORS
 .P
 Listed in order of decreasing precedence:
-- 
2.11.4.GIT