Directory Listing of Routines

general/misc/file_stuff

FILE_CHECKSUM
GENERATE_CHECKSUMS

Routine Descriptions

FILE_CHECKSUM

function FILE_CHECKSUM
Purpose: Returns: SHA1 CHECKSUM string for a file 
Usage:
    output = file_checksum( filename, [/add_mtime] )
Typical usage:
    file_hash( file_search('*') ,/add_mtime )  ;
 Origin:  Mostly copied from file_touch
 Limitations:
    Currently works only on Linux and MacOs systems by calling the shasum command in a shell.
    This module is under development.
 Author: Davin Larson (davin@ssl.berkeley.edu)  copyright - March 2014
 Changes:
    December 2014 - Name changed from file_hash to file_checksum because is better reflects its true purpose
 License:
   All users are granted permission to use this unaltered code.
   It may NOT be modified without the consent of the author. However the author welcomes input for bug fixes or upgrades.

(See general/misc/file_stuff/file_checksum.pro)

GENERATE_CHECKSUMS

[Previous Routine] [List of Routines]

Procedure generate_checksums
Purpose: recursively creates checksum files in subdirectories.
    These files are produced using the "shasum" program. The same program can be used to check file integrity
    Files are not regenerated if the chksum file is newer than all of its dependents.
Usage:
Typical usage:
    generate_checksums,directorypath,FILE_PATTERN='*.cdf'  
    input:  directorypath - scaler string  filepath (must end with '/')
    
    FILE_PATTERN :  string(s)   file format string(s) use for search. Defaults to '*'
    DIR_PATTERN :  string(s)   directory format to be searched  recursively  [optional]
    
    RECURSE_LIMIT :  default is 10.  Set to 0 to create a single checksum file containing all files found. 
    
    FORCE_REGEN : Set this keyword to force regeneration of all checksums
    INCLUDE_DIRECTORY : Set this keyword to compute the checksum of the checksum files in subdirectories.
    FULL_PATH : set this keyword to include the full path in the checksum file. (not recommended)
    
    VERBOSE:  set verbosity level

 Limitations:
    Currently works only on Linux and MacOs systems by calling the shasum command in a shell.
    This module is under development.
 Author: Davin Larson (davin@ssl.berkeley.edu)  copyright -October 2015
 Changes:
 License:
   All users are granted permission to use this unaltered code.
   It may NOT be modified without the consent of the author. However the author welcomes input for bug fixes or upgrades.

(See general/misc/file_stuff/generate_checksums.pro)