Manual Reference Pages - FILE::CREATIONTIME (3)
File::CreationTime - Keeps track of file creation times
Keeps track of creation times on filesystems that dont normally
provide such information.
my $file = /path/to/file;
print "$file was created: ". creation_time($file). "\n";
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
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
thats several years old, then modify it, then call creation_time, the
files 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.
[path] does not exist
You passed [path] to creation_time, but it doesnt exist (or you cant
Failed to set attribute user.creation_time on [file]
Couldnt create the attribute for some reason. Does your filesystem
support extended filesystem attributes?
File::Attributes handles storing the creation_time
Id 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.
Please report any bugs or feature requests to
email@example.com, or through the web interface at
I will be notified, and then youll automatically be notified of progress on
your bug as I make changes.
Jonathan Rockway, <jrockway AT cpan.org>.
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.
|perl v5.20.3 ||FILE::CREATIONTIME (3) ||2007-09-16 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.