EXPFIND Command

HSI Version: 6.0.0.p4 and beyond


Purpose: Find and list files whose expiration time meets the specified selection criteria


Aliases: 


Command Format: 

  expfind [-A] [-b beginTime] [-d days] [-e endTime] [-R] path ...


Options: 

 -A : If specified, displays absolute pathnames for files whose expiration time is deleted.  Default is to display relative pathnames.


-b: Specifies beginning time in range


-d: Find files that will be expiring within the specified number of days from today, starting at 00:00:00 today.


-e: Specifies ending time in range


-R : If specified, recursively searches subdirectories specified by path


Keywords

 N/A


Usage Notes: 

  

  • HPSS administrators may disable the file expiration feature; if so, this command will have no effect.
  • If no path(s) are specified, files in the current directory are searched
  • The time value for the -b and -e option is of the form:

       YYYY-MM-DD[-hh:mm:ss]

       YYYY : year

       MM  : month (1 -12)

       DD  : day [1 - n, where depends on the month (and year, for leap years)

       hh:mm:ss - optional hour:minute:second substring.  If omitted, it is treated as 00:00:00

  • If -b is specified but -e is omitted, then files whose expiration time is >= beginTime are listed
  • If -e is specified but -b is omitted, then files whose expiration time is <= endTime are listed


Examples: 


1. Find all files in the current directory that will be expiring within the next 10 days

     expfind -d 10


2. Recursively find all the files in subdirectory “subdir1” that will be expiring after Jan 12, 2020:

    expfind -R  -b 2020-01-12 subdir1


3. Find all files in the current directory that will be expiring between May 16 2018 and August 25 2019:

    expfind  -b 2020-01-12 subdir1


4. Find all files in the current directory and all of its subdirectories that will be expiring between noon on June 1 2017 and July 4, 2017 at 3PM:


   expde -R -b 2017-06-01-12:00:00 -e 2017-07-04-15:00:00


Related Command(s): 

expdelete expls expset