Jonathan Rockway > File-CreationTime-2.04 > File::CreationTime

Download:
File-CreationTime-2.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 2.04   Source  

NAME ^

File::CreationTime - Keeps track of file creation times

VERSION ^

Version 2.04

SYNOPSIS ^

Keeps track of creation times on filesystems that don't normally provide such information.

    use File::CreationTime;

    my $file = '/path/to/file';
    print "$file was created: ". creation_time($file). "\n";

EXPORT ^

creation_time

FUNCTIONS ^

creation_time

     creation_time('/path/to/file')

Returns the creation time of /path/to/file in seconds past the epoch. Requires permission to modify extended filesystem attributes the first time the function is called. All subsequent invocations require read access only.

ACCURACY ^

The algorithm used to determine the creation time is as follows. The first time creation_time is called, an extended filesystem attribute called creation_time is created and is set to contain the time that the file was most recently modified. As such, if you have a file that's several years old, then modify it, then call creation_time, the file's creation time will obviously be wrong. However, if you create a file, call creation_time, wait several years, modify the file, then call creation_time again, the result will be accurate.

On OS X, this method is not used. Instead, the actual creation time is provided via MacOSX::File::Info->ctime.

DIAGNOSTICS ^

[path] does not exist

You passed [path] to creation_time, but it doesn't exist (or you can't read it).

Failed to set attribute user.creation_time on [file]

Couldn't create the attribute for some reason. Does your filesystem support extended filesystem attributes?

SEE ALSO ^

File::Attributes handles storing the creation_time attribute.

BUGS ^

I'd like to support OSes that actually give you the file creation time. As of version 2.04, OS X is supported in this way. If you know how to make this work on your OS, tell me how or send me a patch.

Other comments and patches are always welcome.

REPORTING

Please report any bugs or feature requests to bug-file-creationtime@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-creationTime. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR ^

Jonathan Rockway, <jrockway AT cpan.org>.

CONTRIBUTORS ^

Dave Cardwell added OS X support.

COPYRIGHT & LICENSE ^

Copyright 2005 Jonathan T. Rockway.

This program is Free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: