1FIND-FILTER(1)              General Commands Manual             FIND-FILTER(1)
2
3
4

NAME

6       find-filter - fine-grained file selection based on time attributes
7

SYNOPSIS

9       $PCP_BINADM_DIR/find-filter [-v?]  predicate
10

DESCRIPTION

12       find-filter  is  a  filter  for  a  list of file names read on standard
13       input, and if the files match the predicate their names are written  on
14       standard output.
15
16       The  supported predicate forms are based on the file's creation time or
17       modification time, and take the form ctime or mtime followed by a  time
18       specification.   A  time  specification takes the form of a + or - fol‐
19       lowed by days (a non-negative integer), optionally followed by a  colon
20       (:) and hours (an integer in the range 0 to 23), optionally followed by
21       another colon (:) and minutes (an integer in the range 0 to 59).
22
23       The semantics of the time specification are that  a  file  matches  the
24       predicate  if  the  chosen time attribute for the file is less than (+)
25       the current time minus the time specification, else more than or  equal
26       to (-) the current time minus the time specification.  Alternatively, +
27       means before the current time minus the time specification, and - means
28       at or after the current time minus the time specification.
29
30       find-filter  is intended to be used to provide finer-grain and platform
31       independent selection compared to  the  -mtime  or  -ctime  options  of
32       find(1).   find-filter  is expected to be used as a post-filter for the
33       output from find(1),  and  this  is  how  it  is  used  in  the  pmlog‐
34       ger_daily(1) scripts to select files to be compressed or culled.
35

EXAMPLES

37       The following predicate examples illustrate some typical uses.
38
39       mtime +3    Matches files modified more than 3 days ago.
40
41       ctime -0:2  Matches files created in the last 2 hours.
42
43       ctime +0:0:15
44                   Matches files created more than 15 minutes ago.
45

DIAGNOSTICS

47       There  are none, unless the -v option is used, in which case some diag‐
48       nostics are written to standard error.
49
50       Exit status is always zero, unless there are errors found when  parsing
51       the command line arguments.
52

SEE ALSO

54       find(1) and pmlogger_daily(1).
55
56
57
58Performance Co-Pilot                  PCP                       FIND-FILTER(1)
Impressum