Return to find.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/find.1, revision 1.1

1.1     ! root        1: .TH FIND 1  "18 January 1983"
        !             2: .SH NAME
        !             3: find \- find files
        !             4: .SH SYNOPSIS
        !             5: .B find
        !             6: pathname-list  expression
        !             7: .SH DESCRIPTION
        !             8: .I Find
        !             9: recursively descends
        !            10: the directory hierarchy for
        !            11: each pathname in the
        !            12: .I pathname-list
        !            13: (i.e., one or more pathnames)
        !            14: seeking files that match a boolean
        !            15: .I expression
        !            16: written in the primaries given below.
        !            17: In the descriptions, the argument
        !            18: .I n
        !            19: is used as a decimal integer
        !            20: where
        !            21: .I +n
        !            22: means more than
        !            23: .I n,
        !            24: .I \-n
        !            25: means less than
        !            26: .I n
        !            27: and
        !            28: .I n
        !            29: means exactly
        !            30: .IR n .
        !            31: .TP 10n
        !            32: .BR \-name " filename"
        !            33: True if the
        !            34: .I filename
        !            35: argument matches the current file name.
        !            36: Normal
        !            37: Shell
        !            38: argument syntax may be used if escaped (watch out for
        !            39: `[', `?' and `*').
        !            40: .TP
        !            41: .BR \-perm " onum"
        !            42: True if the file permission flags
        !            43: exactly
        !            44: match the
        !            45: octal number
        !            46: .I onum
        !            47: (see
        !            48: .IR  chmod (1)).
        !            49: If
        !            50: .I onum
        !            51: is prefixed by a minus sign,
        !            52: more flag bits (017777, see
        !            53: .IR   stat (2))
        !            54: become significant and
        !            55: the flags are compared:
        !            56: .IR (flags&onum)==onum .
        !            57: .TP
        !            58: .BR \-type " c"
        !            59: True if the type of the file
        !            60: is
        !            61: .I c,
        !            62: where
        !            63: .I c
        !            64: is
        !            65: .B "b, c, d, f"
        !            66: or
        !            67: .B l
        !            68: for
        !            69: block special file, character special file,
        !            70: directory, plain file, or symbolic link.
        !            71: .TP
        !            72: .BR \-links " n"
        !            73: True if the file has
        !            74: .I n
        !            75: links.
        !            76: .TP
        !            77: .BR \-user " uname"
        !            78: True if the file belongs to the user
        !            79: .I uname
        !            80: (login name or numeric user ID).
        !            81: .TP
        !            82: .BR \-group " gname"
        !            83: True if the file belongs to group
        !            84: .I gname
        !            85: (group name or numeric group ID).
        !            86: .TP
        !            87: .BR \-size " n"
        !            88: True if the file is
        !            89: .I n
        !            90: blocks long (512 bytes per block).
        !            91: .TP
        !            92: .BR \-inum " n"
        !            93: True if the file has inode number
        !            94: .I n.
        !            95: .TP
        !            96: .BR \-atime " n"
        !            97: True if the file has been accessed in
        !            98: .I n
        !            99: days.
        !           100: .TP
        !           101: .BR \-mtime " n"
        !           102: True if the file has been modified in
        !           103: .I n
        !           104: days.
        !           105: .TP
        !           106: .BR \-exec " command"
        !           107: True if the executed command returns
        !           108: a zero value as exit status.
        !           109: The end of the command must be punctuated by an escaped
        !           110: semicolon.
        !           111: A command argument `{}' is replaced by the
        !           112: current pathname.
        !           113: .TP
        !           114: .BR \-ok " command"
        !           115: Like
        !           116: .B \-exec
        !           117: except that the generated command is written on
        !           118: the standard output, then the standard input is read
        !           119: and the command executed only upon response
        !           120: .BR y .
        !           121: .TP
        !           122: .B  \-print
        !           123: Always true;
        !           124: causes the current pathname to be printed.
        !           125: .TP
        !           126: .BR \-newer " file"
        !           127: True if
        !           128: the current file has been modified more recently than the argument
        !           129: .I file.
        !           130: .PP
        !           131: The primaries may be combined using the following operators
        !           132: (in order of decreasing precedence):
        !           133: .TP 4
        !           134: 1)
        !           135: A parenthesized group of primaries and operators
        !           136: (parentheses are special to the Shell and must be escaped).
        !           137: .TP 4
        !           138: 2)
        !           139: The negation of a primary
        !           140: (`!' is the unary
        !           141: .I not
        !           142: operator).
        !           143: .TP 4
        !           144: 3)
        !           145: Concatenation of primaries
        !           146: (the
        !           147: .I and
        !           148: operation
        !           149: is implied by the juxtaposition of two primaries).
        !           150: .TP 4
        !           151: 4)
        !           152: Alternation of primaries
        !           153: .RB "(`" \-o "' is the"
        !           154: .I or
        !           155: operator).
        !           156: .SH EXAMPLE
        !           157: To remove all files named
        !           158: `a.out' or `*.o' that have not been accessed for a week:
        !           159: .IP "" .2i
        !           160: find / \\( \-name a.out \-o \-name '*.o' \\)
        !           161: \-atime +7 \-exec rm {} \\;
        !           162: .SH FILES
        !           163: /etc/passwd
        !           164: .br
        !           165: /etc/group
        !           166: .SH "SEE ALSO"
        !           167: sh(1), test(1), fs(5)
        !           168: .SH BUGS
        !           169: The syntax is painful.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.