%PDF- %PDF-
Direktori : /proc/self/root/usr/share/perl5/vendor_perl/DateTime/TimeZone/Local/ |
Current File : //proc/self/root/usr/share/perl5/vendor_perl/DateTime/TimeZone/Local/Unix.pm |
package DateTime::TimeZone::Local::Unix; $DateTime::TimeZone::Local::Unix::VERSION = '1.70'; use strict; use warnings; use Cwd 3; use parent 'DateTime::TimeZone::Local'; sub Methods { return qw( FromEnv FromEtcLocaltime FromEtcTimezone FromEtcTIMEZONE FromEtcSysconfigClock FromEtcDefaultInit ); } sub EnvVars { return 'TZ' } our $EtcDir = '/etc'; sub _EtcFile { shift; return File::Spec->catfile( $EtcDir, @_ ); } sub FromEtcLocaltime { my $class = shift; my $lt_file = $class->_EtcFile('localtime'); return unless -r $lt_file && -s _; my $real_name; if ( -l $lt_file ) { # The _Readlink sub exists so the test suite can mock it. $real_name = $class->_Readlink($lt_file); } $real_name ||= $class->_FindMatchingZoneinfoFile($lt_file); if ( defined $real_name ) { my ( $vol, $dirs, $file ) = File::Spec->splitpath($real_name); my @parts = grep { defined && length } File::Spec->splitdir($dirs), $file; foreach my $x ( reverse 0 .. $#parts ) { my $name = ( $x < $#parts ? join '/', @parts[ $x .. $#parts ] : $parts[$x] ); my $tz; { local $@; local $SIG{__DIE__}; $tz = eval { DateTime::TimeZone->new( name => $name ) }; } return $tz if $tz; } } } sub _Readlink { my $link = $_[1]; # Using abs_path will resolve multiple levels of link indirection, # whereas readlink just follows the link to the next target. return Cwd::abs_path($link); } our $ZoneinfoDir = '/usr/share/zoneinfo'; # for systems where /etc/localtime is a copy of a zoneinfo file sub _FindMatchingZoneinfoFile { my $class = shift; my $file_to_match = shift; return unless -d $ZoneinfoDir; require File::Basename; require File::Compare; require File::Find; my $size = -s $file_to_match; my $real_name; local $@; local $SIG{__DIE__}; local $_; eval { File::Find::find( { wanted => sub { if ( !defined $real_name && -f $_ && !-l $_ && $size == -s _ # This fixes RT 24026 - apparently such a # file exists on FreeBSD and it can cause a # false positive && File::Basename::basename($_) ne 'posixrules' && File::Compare::compare( $_, $file_to_match ) == 0 ) { $real_name = $_; # File::Find has no mechanism for bailing in the # middle of a find. die { found => 1 }; } }, no_chdir => 1, }, $ZoneinfoDir, ); }; if ($@) { return $real_name if ref $@ && $@->{found}; die $@; } } sub FromEtcTimezone { my $class = shift; my $tz_file = $class->_EtcFile('timezone'); return unless -f $tz_file && -r _; open my $fh, '<', $tz_file or die "Cannot read $tz_file: $!"; my $name = join '', <$fh>; close $fh; $name =~ s/^\s+|\s+$//g; return unless $class->_IsValidName($name); local $@; local $SIG{__DIE__}; return eval { DateTime::TimeZone->new( name => $name ) }; } sub FromEtcTIMEZONE { my $class = shift; my $tz_file = $class->_EtcFile('TIMEZONE'); return unless -f $tz_file && -r _; open my $fh, '<', $tz_file or die "Cannot read $tz_file: $!"; my $name; while ( defined( $name = <$fh> ) ) { if ( $name =~ /\A\s*TZ\s*=\s*(\S+)/ ) { $name = $1; last; } } close $fh; return unless $class->_IsValidName($name); local $@; local $SIG{__DIE__}; return eval { DateTime::TimeZone->new( name => $name ) }; } # RedHat uses this sub FromEtcSysconfigClock { my $class = shift; my $clock_file = $class->_EtcFile('sysconfig/clock'); return unless -r $clock_file && -f _; my $name = $class->_ReadEtcSysconfigClock(); return unless $class->_IsValidName($name); local $@; local $SIG{__DIE__}; return eval { DateTime::TimeZone->new( name => $name ) }; } # this is a separate function so that it can be overridden in the test suite sub _ReadEtcSysconfigClock { my $class = shift; my $clock_file = shift; open my $fh, '<', $clock_file or die "Cannot read $clock_file: $!"; local $_; while (<$fh>) { return $1 if /^(?:TIME)?ZONE="([^"]+)"/; } } sub FromEtcDefaultInit { my $class = shift; my $init_file = $class->_EtcFile('default/init'); return unless -r $init_file && -f _; my $name = $class->_ReadEtcDefaultInit($init_file); return unless $class->_IsValidName($name); local $@; local $SIG{__DIE__}; return eval { DateTime::TimeZone->new( name => $name ) }; } # this is a separate function so that it can be overridden in the test # suite sub _ReadEtcDefaultInit { my $class = shift; my $init_file = shift; open my $fh, '<', $init_file or die "Cannot read $init_file: $!"; local $_; while (<$fh>) { return $1 if /^TZ=(.+)/; } } 1; # ABSTRACT: Determine the local system's time zone on Unix __END__ =pod =encoding UTF-8 =head1 NAME DateTime::TimeZone::Local::Unix - Determine the local system's time zone on Unix =head1 VERSION version 1.70 =head1 SYNOPSIS my $tz = DateTime::TimeZone->new( name => 'local' ); my $tz = DateTime::TimeZone::Local->TimeZone(); =head1 DESCRIPTION This module provides methods for determining the local time zone on a Unix platform. =head1 HOW THE TIME ZONE IS DETERMINED This class tries the following methods of determining the local time zone: =over 4 =item * $ENV{TZ} It checks C<< $ENV{TZ} >> for a valid time zone name. =item * F</etc/localtime> If this file is a symlink to an Olson database time zone file (usually in F</usr/share/zoneinfo>) then it uses the target file's path name to determine the time zone name. For example, if the path is F</usr/share/zoneinfo/America/Chicago>, the time zone is "America/Chicago". Some systems just copy the relevant file to F</etc/localtime> instead of making a symlink. In this case, we look in F</usr/share/zoneinfo> for a file that has the same size and content as F</etc/localtime> to determine the local time zone. =item * F</etc/timezone> If this file exists, it is read and its contents are used as a time zone name. =item * F</etc/TIMEZONE> If this file exists, it is opened and we look for a line starting like "TZ = ...". If this is found, it should indicate a time zone name. =item * F</etc/sysconfig/clock> If this file exists, it is opened and we look for a line starting like "TIMEZONE = ..." or "ZONE = ...". If this is found, it should indicate a time zone name. =item * F</etc/default/init> If this file exists, it is opened and we look for a line starting like "TZ=...". If this is found, it should indicate a time zone name. =back =head1 AUTHOR Dave Rolsky <autarch@urth.org> =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2014 by Dave Rolsky. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. =cut