diff options
| author | Gisle Aas <gisle@aas.no> | 2003-10-22 22:33:43 -0700 |
|---|---|---|
| committer | Abhijit Menon-Sen <ams@wiw.org> | 2003-10-23 12:53:03 +0000 |
| commit | 2c21a326619911d05e8626e425f90895ef6d740e (patch) | |
| tree | 44a6e9b75dfa04e93ba26b2ca1104ae05c709296 | |
| parent | 943bbd07da3f5ac028f0431edcea22c215ffe800 (diff) | |
| download | perl-2c21a326619911d05e8626e425f90895ef6d740e.tar.gz | |
utime documentation
Message-Id: <lrekx4jfq0.fsf@caliper.activestate.com>
p4raw-id: //depot/perl@21523
| -rw-r--r-- | pod/perlfunc.pod | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 4d4efc53df..6b093eb790 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -6260,12 +6260,8 @@ to the current time. For example, this code has the same effect as the Unix touch(1) command when the files I<already exist>. #!/usr/bin/perl - $now = time; - utime $now, $now, @ARGV; - -B<Note:> Under NFS, touch(1) uses the time of the NFS server, not -the time of the local machine. If there is a time synchronization -problem, the NFS server and local machine will have different times. + $atime = $mtime = time; + utime $atime, $mtime, @ARGV; Since perl 5.7.2, if the first two elements of the list are C<undef>, then the utime(2) function in the C library will be called with a null second @@ -6275,6 +6271,17 @@ above.) utime undef, undef, @ARGV; +Under NFS this will use the time of the NFS server, not the time of +the local machine. If there is a time synchronization problem, the +NFS server and local machine will have different times. The Unix +touch(1) command will in fact normally use this form instead of the +one shown in the first example. + +Note that only passing one of the first two elements as C<undef> will +be equivalent of passing it as 0 and will not have the same effect as +described when they are both C<undef>. This case will also trigger an +uninitialized warning. + =item values HASH Returns a list consisting of all the values of the named hash. |