noble (1) find-filter.1.gz

Provided by: pcp_6.2.0-1.1build4_amd64 bug

NAME

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

SYNOPSIS

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

DESCRIPTION

       find-filter  is  a  filter  for  a  list of file names read on standard input, and if the files match the
       predicate their names are written on standard output.

       The supported predicate forms are based on the file's creation time or modification time,  and  take  the
       form  ctime  or  mtime followed by a time specification.  A time specification takes the form of a + or -
       followed by days (a non-negative integer), optionally followed by a colon (:) and hours  (an  integer  in
       the  range  0  to 23), optionally followed by another colon (:) and minutes (an integer in the range 0 to
       59).

       The semantics of the time specification are that  a  file  matches  the  predicate  if  the  chosen  time
       attribute  for the file is less than (+) the current time minus the time specification, else more than or
       equal to (-) the current time minus the time specification.  Alternatively, + means  before  the  current
       time minus the time specification, and - means at or after the current time minus the time specification.

       find-filter  is intended to be used to provide finer-grain and platform independent selection compared to
       the -mtime or -ctime options of find(1).  find-filter is expected to be used as  a  post-filter  for  the
       output  from  find(1),  and this is how it is used in the pmlogger_daily(1) scripts to select files to be
       compressed or culled.

EXAMPLES

       The following predicate examples illustrate some typical uses.

       mtime +3    Matches files modified more than 3 days ago.

       ctime -0:2  Matches files created in the last 2 hours.

       ctime +0:0:15
                   Matches files created more than 15 minutes ago.

DIAGNOSTICS

       There are none, unless the -v option is used, in which case some  diagnostics  are  written  to  standard
       error.

       Exit status is always zero, unless there are errors found when parsing the command line arguments.

SEE ALSO

       find(1) and pmlogger_daily(1).