find2perl - Unix, Linux Command
NAME
find2perl - translate find command lines to Perl code
SYNOPSIS
find2perl [paths] [predicates] | perl
|
DESCRIPTION
find2perl is a little translator to convert find command lines to
equivalent Perl code. The resulting code is typically faster than
running find itself.
paths are a set of paths where find2perl will start its searches and
predicates are taken from the following list.
| Tag | Description |
|---|
|
! PREDICATE
|
Negate the sense of the following predicate. The ! must be passed as
a distinct argument, so it may need to be surrounded by whitespace and/or
quoted from interpretation by the shell using a backslash (just as with
using find(1)).
|
|
( PREDICATES )
|
Group the given PREDICATES. The parentheses must be passed as distinct
arguments, so they may need to be surrounded by whitespace and/or
quoted from interpretation by the shell using a backslash (just as with
using find(1)).
|
|
PREDICATE1 PREDICATE2
|
True if _both_ PREDICATE1 and PREDICATE2 are true; PREDICATE2 is not
evaluated if PREDICATE1 is false.
|
|
PREDICATE1 -o PREDICATE2
|
True if either one of PREDICATE1 or PREDICATE2 is true; PREDICATE2 is
not evaluated if PREDICATE1 is true.
|
|
-follow
|
Follow (dereference) symlinks. The checking of file attributes depends
on the position of the -follow option. If it precedes the file
check option, an stat is done which means the file check applies to the
file the symbolic link is pointing to. If -follow option follows the
file check option, this now applies to the symbolic link itself, i.e.
an lstat is done.
|
|
-depth
|
Change directory traversal algorithm from breadth-first to depth-first.
|
|
-prune
|
Do not descend into the directory currently matched.
|
|
-xdev
|
Do not traverse mount points (prunes search at mount-point directories).
|
|
-name GLOB
|
File name matches specified GLOB wildcard pattern. GLOB may need to be
quoted to avoid interpretation by the shell (just as with using
find(1)).
|
|
-iname GLOB
|
Like -name, but the match is case insensitive.
|
|
-path GLOB
|
Path name matches specified GLOB wildcard pattern.
|
|
-ipath GLOB
|
Like -path, but the match is case insensitive.
|
|
-perm PERM
|
Low-order 9 bits of permission match octal value PERM.
|
|
-perm -PERM
|
The bits specified in PERM are all set in file’s permissions.
|
|
-type X
|
The file’s type matches perl’s -X operator.
|
|
-fstype TYPE
|
Filesystem of current path is of type TYPE (only NFS/non-NFS distinction
is implemented).
|
|
-user USER
|
True if USER is owner of file.
|
|
-group GROUP
|
True if file’s group is GROUP.
|
|
-nouser
|
True if file’s owner is not in password database.
|
|
-nogroup
|
True if file’s group is not in group database.
|
|
-inum INUM
|
True file’s inode number is INUM.
|
|
-links N
|
True if (hard) link count of file matches N (see below).
|
|
-size N
|
True if file’s size matches N (see below) N is normally counted in
512-byte blocks, but a suffix of c specifies that size should be
counted in characters (bytes) and a suffix of k specifes that
size should be counted in 1024-byte blocks.
|
|
-atime N
|
True if last-access time of file matches N (measured in days) (see
below).
|
|
-ctime N
|
True if last-changed time of file’s inode matches N (measured in days,
see below).
|
|
-mtime N
|
True if last-modified time of file matches N (measured in days, see below).
|
|
-newer FILE
|
True if last-modified time of file matches N.
|
|
-print
|
Print out path of file (always true). If none of -exec, -ls,
-print0, or -ok is specified, then -print will be added
implicitly.
|
|
-print0
|
Like -print, but terminates with \0 instead of \n.
|
|
-exec OPTIONS ;
|
exec() the arguments in OPTIONS in a subprocess; any occurrence of {} in
OPTIONS will first be substituted with the path of the current
file. Note that the command rm has been special-cased to use perl’s
unlink() function instead (as an optimization). The ; must be passed as
a distinct argument, so it may need to be surrounded by whitespace and/or
quoted from interpretation by the shell using a backslash (just as with
using find(1)).
|
|
-ok OPTIONS ;
|
Like -exec, but first prompts user; if user’s response does not begin
with a y, skip the exec. The ; must be passed as
a distinct argument, so it may need to be surrounded by whitespace and/or
quoted from interpretation by the shell using a backslash (just as with
using find(1)).
|
|
-eval EXPR
|
Has the perl script eval() the EXPR.
|
|
-ls
|
Simulates -exec ls -dils {} ;
|
|
-tar FILE
|
Adds current output to tar-format FILE.
|
|
-cpio FILE
|
Adds current output to old-style cpio-format FILE.
|
|
-ncpio FILE
|
Adds current output to new-style cpio-format FILE.
|
Predicates which take a numeric argument N can come in three forms:
* N is prefixed with a +: match values greater than N
* N is prefixed with a -: match values less than N
* N is not prefixed with either + or -: match only values equal to N
|
SEE ALSO
find
|
