-->

Previous | Table of Contents | Next

Page 139

_fstype type File is on a filesystem of type type. The valid filesystem types vary among different versions of UNIX; an incomplete list of filesystem types that are accepted on some version of UNIX or another is: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. You can use _printf with the %F directive to see the types of your filesystems.
_gid n File's numeric group ID is n.
_group gname File belongs to group gname (numeric group ID allowed).
_ilname pattern Like _lname, but the match is case-insensitive.
_iname pattern Like _name, but the match is case-insensitive. For example, the patterns fo* and F?? match the filenames Foo, FOO, foo, fOo, and so on.
_inum n File has inode number n.
_ipath pattern Like _path, but the match is case-insensitive.
_iregex pattern Like _regex, but the match is case-insensitive.
_links n File has n links.
_lname pattern File is a symbolic link whose contents match shell pattern pattern. The meta characters do not treat / or . specially.
_mmin n File's data was last modified n minutes ago.
_mtime n File's data was last modified n*24 hours ago.
_name pattern Base of filename (the path with the leading directories removed) matches shell pattern pattern. The meta characters (*, ?, and []) do not match a . at the start of the base name. To ignore a directory and the files under it, use _prune; see an example in the description of _path.
_newer file File was modified more recently than file. _newer is affected by _follow only if _follow comes before _newer on the command line.
_nouser No user corresponds to file's numeric user ID.
_nogroup No group corresponds to file's numeric group ID.
_path pattern Filename matches shell pattern pattern. The meta characters do not treat / or . specially; so, for example,
find . _path `./sr*sc' will print an entry for a directory called ./src/misc (if one exists). To ignore a whole directory tree, use _prune rather than checking every file in the tree. For example, to skip the directory src/emacs and all files and directories under it, and print the names of the other files found, do something like this:
find . _path `./src/emacs' -prune -o -print
_perm mode File's permission bits are exactly mode (octal or symbolic). Symbolic modes use mode 0 as a point of departure.
_perm _mode All of the permission bits mode are set for the file.
_perm +mode Any of the permission bits mode are set for the file.
_regex pattern Filename matches regular expression pattern. This is a match on the whole path, not a search. For example, to match a file named ./fubar3, you can use the regular expression .*bar. or .*b.*3, but not b.*r3.
_size n[bckw] File uses n units of space. The units are 512-byte blocks by default or if b follows n, bytes if c follows n, kilobytes if k follows n, or 2-byte words if w follows n. The size does not count indirect blocks, but it does count blocks in sparse files that are not actually allocated.
_true Always true.
_type c File is of type c. Possible types:
b Block (buffered) special
c Character (unbuffered) special
d Directory
p Named pipe (FIFO)

Page 140

f Regular file l symbolic link
s Socket
_uid n File's numeric user ID is n.
_used n File was last accessed n days after its status was last changed.
_user uname File is owned by user uname (numeric user ID allowed).
_xtype c The same as _type unless the file is a symbolic link. For symbolic links: if _follow has not been given, True if the file is a link to a file of type c; if _follow has been given, True if c is l. In other words, for symbolic links, _xtype checks the type of the file that _type does not check.

ACTIONS

_exec command; Execute command; True if 0 status is returned. All following arguments to find are taken to be arguments to the command until an argument consisting of ; is encountered. The string {} is replaced by the current filename being processed everywhere it occurs in the arguments to the command, not just in arguments where it is alone, as in some versions of find. Both of these constructions might need to be escaped (with a \) nor quoted to protect them from expansion by the shell. The command is executed in the starting directory.
_fls file True; like _ls but write to file like _fprint.
_fprint file True; print the full filename into file file. If file does not exist when find is run, it is created; if it does exist, it is truncated. The filenames /dev/stdout and /dev/stderr are handled specially; they refer to the standard output and standard error output, respectively.
_fprint0 file True; like _print0 but write to file like _fprint.
_fprintf file format True; like _printf but write to file like _fprint.
_ok command; Like _exec but ask the user first (on the standard input); if the response does not start with y or Y, do not run the command, and return False.
_print True; print the full filename on the standard output, followed by a newline.
_print0 True; print the full filename on the standard output, followed by a null character. This allows filenames that contain newlines to be correctly interpreted by programs that process the find output.
_printf format True; print format on the standard output, interpreting n escapes and % directives. Field widths and precisions can be specified as with the printf C function. Unlike _print, _printf does not add a newline at the end of the string. The escapes and directives are as follows:
\a Alarm bell
\b Backspace
\c Stop printing from this format immediately and flush the output
\f Form feed
\n Newline
\r Carriage return
\t Horizontal tab
\v Vertical tab
\\ A literal backslash (`\')
A \ character followed by any other character is treated as an ordinary character, so they both are printed:
%% A literal percent sign.
%a File's last access time in the format returned by the C ctime function.
%Ak File's last access time in the format specified by k, which is either @ or a directive for the C strftime function. The possible values for k are listed below; some of them might not be available on all systems, due to differences in strftime between systems. @ seconds since Jan. 1, 1970, 00:00 GMT.

Previous | Table of Contents | Next