1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
# Copyright © 2007 Raphaël Hertzog <hertzog@debian.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
package Dpkg::Path;
use strict;
use warnings;
use base qw(Exporter);
use File::Spec;
use Cwd qw(realpath);
our @EXPORT_OK = qw(get_pkg_root_dir relative_to_pkg_root
guess_pkg_root_dir check_files_are_the_same
resolve_symlink canonpath);
=head1 NAME
Dpkg::Path - some common path handling functions
=head1 DESCRIPTION
It provides some functions to handle various path.
=head1 METHODS
=over 8
=item get_pkg_root_dir($file)
This function will scan upwards the hierarchy of directory to find out
the directory which contains the "DEBIAN" sub-directory and it will return
its path. This directory is the root directory of a package being built.
If no DEBIAN subdirectory is found, it will return undef.
=cut
sub get_pkg_root_dir($) {
my $file = shift;
$file =~ s{/+$}{};
$file =~ s{/+[^/]+$}{} if not -d $file;
while ($file) {
return $file if -d "$file/DEBIAN";
last if $file !~ m{/};
$file =~ s{/+[^/]+$}{};
}
return undef;
}
=item relative_to_pkg_root($file)
Returns the filename relative to get_pkg_root_dir($file).
=cut
sub relative_to_pkg_root($) {
my $file = shift;
my $pkg_root = get_pkg_root_dir($file);
if (defined $pkg_root) {
$pkg_root .= "/";
return $file if ($file =~ s/^\Q$pkg_root\E//);
}
return undef;
}
=item guess_pkg_root_dir($file)
This function tries to guess the root directory of the package build tree.
It will first use get_pkg_root_dir(), but it will fallback to a more
imprecise check: namely it will use the parent directory that is a
sub-directory of the debian directory.
It can still return undef if a file outside of the debian sub-directory is
provided.
=cut
sub guess_pkg_root_dir($) {
my $file = shift;
my $root = get_pkg_root_dir($file);
return $root if defined $root;
$file =~ s{/+$}{};
$file =~ s{/+[^/]+$}{} if not -d $file;
my $parent = $file;
while ($file) {
$parent =~ s{/+[^/]+$}{};
last if not -d $parent;
return $file if check_files_are_the_same("debian", $parent);
$file = $parent;
last if $file !~ m{/};
}
return undef;
}
=item check_files_are_the_same($file1, $file2, $resolve_symlink)
This function verifies that both files are the same by checking that the device
numbers and the inode numbers returned by stat()/lstat() are the same. If
$resolve_symlink is true then stat() is used, otherwise lstat() is used.
=cut
sub check_files_are_the_same($$;$) {
my ($file1, $file2, $resolve_symlink) = @_;
return 0 if ((! -e $file1) || (! -e $file2));
my (@stat1, @stat2);
if ($resolve_symlink) {
@stat1 = stat($file1);
@stat2 = stat($file2);
} else {
@stat1 = lstat($file1);
@stat2 = lstat($file2);
}
my $result = ($stat1[0] == $stat2[0]) && ($stat1[1] == $stat2[1]);
return $result;
}
=item canonpath($file)
This function returns a cleaned path. It simplifies double //, and remove
/./ and /../ intelligently. For /../ it simplifies the path only if the
previous element is not a symlink. Thus it should only be used on real
filenames.
=cut
sub canonpath($) {
my $path = shift;
$path = File::Spec->canonpath($path);
my ($v, $dirs, $file) = File::Spec->splitpath($path);
my @dirs = File::Spec->splitdir($dirs);
my @new;
foreach my $d (@dirs) {
if ($d eq '..') {
if (scalar(@new) > 0 and $new[-1] ne "..") {
next if $new[-1] eq ""; # Root directory has no parent
my $parent = File::Spec->catpath($v,
File::Spec->catdir(@new), '');
if (not -l $parent) {
pop @new;
} else {
push @new, $d;
}
} else {
push @new, $d;
}
} else {
push @new, $d;
}
}
return File::Spec->catpath($v, File::Spec->catdir(@new), $file);
}
=item $newpath = resolve_symlink($symlink)
Return the filename of the file pointed by the symlink. The new name is
canonicalized by canonpath().
=cut
sub resolve_symlink($) {
my $symlink = shift;
my $content = readlink($symlink);
return undef unless defined $content;
if (File::Spec->file_name_is_absolute($content)) {
return canonpath($content);
} else {
my ($link_v, $link_d, $link_f) = File::Spec->splitpath($symlink);
my ($cont_v, $cont_d, $cont_f) = File::Spec->splitpath($content);
my $new = File::Spec->catpath($link_v, $link_d . "/" . $cont_d, $cont_f);
return canonpath($new);
}
}
=back
=head1 AUTHOR
Raphael Hertzog <hertzog@debian.org>.
=cut
1;
|
