diff options
author | Ruslan Ermilov <ru@FreeBSD.org> | 2001-08-31 15:48:00 +0000 |
---|---|---|
committer | Ruslan Ermilov <ru@FreeBSD.org> | 2001-08-31 15:48:00 +0000 |
commit | 208691fcd8e8c8ae68306ddb5dca8e5f207a793f (patch) | |
tree | 212cf768c91a39c0c74dcc4d725977983993e411 /usr.bin/find/find.1 | |
parent | 46c128b5a50d906d3bf974d14497ab7eb7ae53c8 (diff) | |
download | src-208691fcd8e8c8ae68306ddb5dca8e5f207a793f.tar.gz src-208691fcd8e8c8ae68306ddb5dca8e5f207a793f.zip |
Sort predicates.
PR: docs/30237
Notes
Notes:
svn path=/head/; revision=82662
Diffstat (limited to 'usr.bin/find/find.1')
-rw-r--r-- | usr.bin/find/find.1 | 140 |
1 files changed, 70 insertions, 70 deletions
diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1 index 348615cb4451..99d496720985 100644 --- a/usr.bin/find/find.1 +++ b/usr.bin/find/find.1 @@ -243,6 +243,20 @@ The filename substituted for the string .Dq Li {} is not qualified. +.It Ic -flags Op Fl Ns Ar flags +This primary evaluates to true if exactly those flags of the file are +set which are also set using the specified +.Ar flags +(if these are not preceded by a dash +.Pq Dq Li - , +or if they match the specified flags (if these are preceded by a dash). +The +.Ar flags +are specified using symbolic names (see +.Xr chflags 1 ) . +Note that this is different from +.Ic -perm , +which only allows you to specify flags which are set. .It Ic -fstype Ar type True if the file is contained in a file system of type .Ar type . @@ -270,9 +284,21 @@ If is numeric and there is no such group name, then .Ar gname is treated as a group ID. +.It Ic -iname Ar pattern +Like +.Ic -name , +but the match is case insensitive. .It Ic -inum Ar n True if the file has inode number .Ar n . +.It Ic -ipath Ar pattern +Like +.Ic -path , +but the match is case insensitive. +.It Ic -iregex Ar pattern +Like +.Ic -regex , +but the match is case insensitive. .It Ic -links Ar n True if the file has .Ar n @@ -291,9 +317,6 @@ The format is identical to that produced by .Bk -words .Nm ls Fl dgils . .Ek -.It Ic -mnewer Ar file -Same as -.Ic -newer . .It Ic -maxdepth Ar n True if the depth of the current file into the tree is less than or equal to .Ar n . @@ -306,37 +329,15 @@ True if the difference between the file last modification time and the time was started, rounded up to the next full minute, is .Ar n minutes. +.It Ic -mnewer Ar file +Same as +.Ic -newer . .It Ic -mtime Ar n True if the difference between the file last modification time and the time .Nm was started, rounded up to the next full 24\-hour period, is .Ar n 24\-hour periods. -.It Ic -ok Ar utility Op Ar argument ... ; -The -.Ic -ok -primary is identical to the -.Ic -exec -primary with the exception that -.Nm -requests user affirmation for the execution of the -.Ar utility -by printing -a message to the terminal and reading a response. -If the response is other than -.Dq Li y -the command is not executed and the -value of the -.Ic -ok -expression is false. -.It Ic -okdir Ar utility Op Ar argument ... ; -The -.Ic -okdir -primary is identical to the -.Ic -execdir -primary with the same exception as described for the -.Ic -ok -primary. .It Ic -name Ar pattern True if the last component of the pathname being examined matches .Ar pattern . @@ -351,28 +352,6 @@ may be used as part of These characters may be matched explicitly by escaping them with a backslash .Pq Dq Li \e . -.It Ic -iname Ar pattern -Like -.Ic -name , -but the match is case insensitive. -.It Ic -regex Ar pattern -True if the whole path of the file matches -.Ar pattern -using regular expression. -To match a file named -.Dq Pa ./foo/xyzzy , -you can use the regular expression -.Dq Li ".*/[xyz]*" -or -.Dq Li ".*/foo/.*" , -but not -.Dq Li xyzzy -or -.Dq Li /foo/ . -.It Ic -iregex Ar pattern -Like -.Ic -regex , -but the match is case insensitive. .It Ic -newer Ar file True if the current file has a more recent last modification time than .Ar file . @@ -402,10 +381,35 @@ Note that .Ic -newermm is equivalent to .Ic -newer . -.It Ic -nouser -True if the file belongs to an unknown user. .It Ic -nogroup True if the file belongs to an unknown group. +.It Ic -nouser +True if the file belongs to an unknown user. +.It Ic -ok Ar utility Op Ar argument ... ; +The +.Ic -ok +primary is identical to the +.Ic -exec +primary with the exception that +.Nm +requests user affirmation for the execution of the +.Ar utility +by printing +a message to the terminal and reading a response. +If the response is other than +.Dq Li y +the command is not executed and the +value of the +.Ic -ok +expression is false. +.It Ic -okdir Ar utility Op Ar argument ... ; +The +.Ic -okdir +primary is identical to the +.Ic -execdir +primary with the same exception as described for the +.Ic -ok +primary. .It Ic -path Ar pattern True if the pathname being examined matches .Ar pattern . @@ -424,10 +428,6 @@ Slashes .Pq Dq Li / are treated as normal characters and do not have to be matched explicitly. -.It Ic -ipath Ar pattern -Like -.Ic -path , -but the match is case insensitive. .It Ic -perm Oo Fl Oc Ns Ar mode The .Ar mode @@ -453,20 +453,6 @@ Otherwise, this primary evaluates to true if the bits in the mode exactly match the file's mode bits. Note, the first character of a symbolic mode may not be a dash .Pq Dq Li - . -.It Ic -flags Op Fl Ns Ar flags -This primary evaluates to true if exactly those flags of the file are -set which are also set using the specified -.Ar flags -(if these are not preceded by a dash -.Pq Dq Li - , -or if they match the specified flags (if these are preceded by a dash). -The -.Ar flags -are specified using symbolic names (see -.Xr chflags 1 ) . -Note that this is different from -.Ic -perm , -which only allows you to specify flags which are set. .It Ic -print This primary always evaluates to true. It prints the pathname of the current file to standard output. @@ -491,6 +477,20 @@ Note, the primary has no effect if the .Fl d option was specified. +.It Ic -regex Ar pattern +True if the whole path of the file matches +.Ar pattern +using regular expression. +To match a file named +.Dq Pa ./foo/xyzzy , +you can use the regular expression +.Dq Li ".*/[xyz]*" +or +.Dq Li ".*/foo/.*" , +but not +.Dq Li xyzzy +or +.Dq Li /foo/ . .It Ic -size Ar n Ns Op Cm c True if the file's size, rounded up, in 512\-byte blocks is .Ar n . |