blib/lib/Mac/Alias/Parse.pm

filter: Statementstmt 92.3% 145 / 157 Branchbran 69.3% 79 / 114 Conditioncond 33.3% 2 / 6 MC/DCmcdc 0.0% 0 / 4 Subroutinesub 100% 13 / 13 Podpod 0.0% 0 / 6 totaltotal 79.6% 239 / 300 CC 65 SCAR 34.3
CC
65
Cov
82%
pack_alias
39.3
unpack_alias
38.5
packLongTime
4.5
CRAP 30.8
↑ Summary
1 #
2 # A tiny pure-perl Mac Alias record class.
3 # Based on an unattributed text file found floating around
4 # on the internet, plus further research.
5 #
6  
7 package Mac::Alias::Parse;
8  
9 =head1 NAME
10  
11 Mac::Alias::Parse - Parse and create Mac Alias records
12  
13 =head1 SYNOPSIS
14  
15 use Mac::Alias::Parse;
16  
17 $fields = Mac::Alias::Parse::unpack_alias( $bytes );
18 $filename = $fields->{target}->{long_name};
19
20 $bytes = Mac::Alias::Parse::pack_alias(
21 target => { inode => ..., long_name => ..., createdUTC => ..., ... },
22 folder => { ... },
23 inode_path => [ ... ],
24 ...
25 );
26  
27 =head1 DESCRIPTION
28  
29 The functions C<unpack_alias()> and C<pack_alias()> convert between an
30 alias record, as found in various Mac data structures or on disk, and
31 an easier-to-manipulate Perl data structure.
32  
33 =cut
34  
35  
36 # Excerpt from text file:
37  
38 # ALIAS RECORD STRUCTURE
39 # A basic record is 150 bytes in length excluding extra info. The Mac
40 # OS uses colons in file paths instead of forward slashs as used in
41 # URLs, so the colon can't be used in file, directory nor disk
42 # names. Also directorys and files have a Mac OS name limit of 31
43 # characters. Disks have a limit of 27 characters.
44  
45 # (end excerpt)
46  
47 # The alias record starts with a length word; it is also self-delimiting
48 # (the last entry in the "Extra" list is a sentinel). This might be
49 # a relic of earlier extension efforts (fields being added to the end
50 # of the fixed structure, before the "Extra" stuff was implemented) or
51 # it might just be a processing convenience--- not sure.
52  
53 # The fixed part of the alias record looks like this:
54 #
55 # offs len what
56 # 6 2 Alias record version (we understand version 2)
57 # 8 2 Kind of item pointed to (0=file, 1=folder)
58 # 10 1 Length of volume name
59 # 11 27 Volume name (padded with NULs)
60 # 38 4 Volume creation date (seconds since Mac epoch, in local timezone)
61 # 42 2 Filesystem type ("volume signature", eg kHFSPlusSigWord)[1]
62 # 44 2 Volume type [2]
63 # 46 4 Containing folder's File Number (inode)
64 # 50 1 Filename length
65 # 51 63 Filename (padded with NULs)
66 # 114 4 Destination item's File Number (inode)
67 # 118 4 Item's creation date (seconds since Mac epoch)
68 # 122 4 Item's creator (FourCharCode)
69 # 126 4 Item's type (FourCharCode)
70 # 130 2 Number of levels From [3]
71 # 132 2 Number of levels To [3]
72 # 134 4 Volume attribute flags [???]
73 # 138 2 Volume file system ID (???, typically 0, or 'cu' for network mounts)
74 # 140 10 Reserved (set to zeroes)
75  
76 # The fixed part is followed by a series of "extra" fields in a tag-length-
77 # value style:
78  
79 # 0 2 Record type/tag (-1 / 65535 indicates end of list)
80 # 2 2 Length of data field
81 # 4 . Data
82 # . 0/1 Optional pad with 0 byte to even byte boundary
83  
84 # Record types/tags:
85  
86 # 0: Folder name (Carbon-mangled)
87 # 1: Inode-path to containing folder
88 # 2: Carbon pathname of file
89 # 3: AppleShare zone name [4]
90 # 4: AppleShare server name [4]
91 # 5: AppleShare user name [4]
92 # 6: Driver name [4]
93 # 9: Network mount info
94 # 10: AppleRemoteAccess dialup info [4]
95 # 14: Unicode filename [5]
96 # 15: Unicode volume name [5]
97 # 16: High-resolution date: volume creation date
98 # 17: High-resolution date: file creation date
99 # 18: POSIX path to file, treating volume root as /
100 # 19: POSIX path of volume mount point
101 # 20: Recursive alias record of volume's disk image file
102 # 21: Length of prefix of POSIX path which is user's home directory
103  
104 # The folder name (record 0) is mangled to fit in the 31-byte
105 # System 7 HFS-not-plus limit.
106  
107 # The inode-path (record 1) contains a sequence of 4-byte inode numbers,
108 # starting with the containing folder and continuing up to the volume's
109 # root. (The root isn't included; if the containing folder *is* the root,
110 # this is a zero-length list.) The first value is the same as the folder's
111 # inode in the fixed portion of the record, if both exist.
112  
113 # The network mount info record appears to contain a network mount type,
114 # flags word, and URL of the mount point.
115  
116 # The high-resolution dates (16 and 17) seem to be normal Mac-epoch dates
117 # scaled by 2^16. In practice the fractional seconds always seem to
118 # be zero. Not clear what they are the dates of.
119  
120 # [1] For reference on volume data types and magic numbers, see TN1150.
121 # [2] From the textfile: Fixed HD = 0; Network Disk = 1; 400kB FD = 2;
122 # 800kB FD = 3; 1.4MB FD = 4; Other Ejectable Media = 5
123 # [3] From and To are unclear to me. If unspecified they are -1 (65535),
124 # and in the aliases I've examined they are always -1. The textfile
125 # describes them as the number of "directories from alias thru to root"
126 # and "directories from root thru to source".
127 # [4] From textfile.
128 # [5] These contain a (redundant?) 2-byte length followed by UTF-16-BE data.
129  
130 # If an inode/fileID is missing (e.g. some network filesystems) it
131 # is stored as 0xFFFFFFFF.
132  
133 2 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
134 2 ▶use Exporter ( );
Subroutine BEGIN: called CC=1 SCAR=0.0
135 2 ▶use Carp ( 'carp', 'croak' );
Subroutine BEGIN: called CC=1 SCAR=0.0
136 2 ▶use Encode;
Subroutine BEGIN: called CC=1 SCAR=0.0
137 2 ▶use Math::BigInt;
Subroutine BEGIN: called CC=1 SCAR=0.0
138 2 ▶use Math::BigFloat;
Subroutine BEGIN: called CC=1 SCAR=0.0
139 2 ▶use Unicode::Normalize ( 'NFD', 'NFC' );
Subroutine BEGIN: called CC=1 SCAR=0.0
140  
141 2 our $VERSION = '0.20';
142 2 our @ISA = 'Exporter';
143 2 our @EXPORT_OK = qw( &unpack_alias &pack_alias );
144  
145 2 ▶sub unpack_alias {
Subroutine unpack_alias: called CC=30 SCAR=36.5
Pod undocumented
146 2 my($bytes) = @_;
147 2 my(%into, %vol, %dir, %targ, $appinfo, $recsize, $version,
148 $file_length, $file_name, $vol_length, $vol_name, $extra_ptr,
149 @extra);
150  
151 2 ($appinfo, $recsize, $version) = unpack('a4 nn', $bytes);
152  
153 2 ▶ warn 'Alias record is truncated'
Branch: 1 branch
BranchTrueFalseTotal
if $recsize > length $bytes or 150 > length $bytes 0 2 2
Condition33%1/3
$recsize > length $bytes or 150 > length $bytes
l!l&&r!l&&!r
002
MC/DC0%0/2
$recsize > length $bytes or 150 > length $bytes
$recsize > length $bytes 150 > length $bytes
Truth table33%1/3
A or B
A= $recsize > length $bytesB= 150 > length $bytes
ABresult
1X1
011
000
154 if ($recsize > length($bytes) || 150 > length($bytes));
155
156 2 ▶ warn "Unexpected alias record version (found $version, expected 2)\n"
Branch: 1 branch
BranchTrueFalseTotal
if $version != 2 0 2 2
157 if ($version != 2);
158  
159 # Unpack the fixed-length portion of the alias record.
160 (
161 $targ{'kind'},
162 $vol_length, $vol_name,
163 @vol{qw( created signature type )},
164 $dir{'inode'},
165 $file_length, $file_name,
166 @targ{qw( inode created type creator )},
167 @into{qw( xfrom xto )},
168 @vol{qw( flags fsid )},
169 2 $into{'reserved'},
170 ) = unpack('x8 n C a27 N a2 nN C a63 NN a4 a4 nnNa2 a10', $bytes);
171 2 $extra_ptr = 150;
172  
173 2 $vol{'name'} = substr($vol_name, 0, $vol_length);
174 2 $targ{'name'} = substr($file_name, 0, $file_length);
175
176 2 $into{'volume'} = \%vol;
177 2 $into{'folder'} = \%dir;
178 2 $into{'target'} = \%targ;
179
180 # Remove fields with known "missing value" values
181 2 ▶ $into{'appinfo'} = $appinfo unless $appinfo eq "\x00\x00\x00\x00";
Branch: 1 branch
BranchTrueFalseTotal
unless $appinfo eq "\0\0\0\0" 0 2 2
182 2 ▶ delete $into{'xfrom'} if $into{'xfrom'} == 65535;
Branch: 1 branch
BranchTrueFalseTotal
if $into{"xfrom"} == 65535 2 0 2
183 2 ▶ delete $into{'xto'} if $into{'xto'} == 65535;
Branch: 1 branch
BranchTrueFalseTotal
if $into{"xto"} == 65535 2 0 2
184 2 ▶ delete $targ{'creator'} if $targ{'creator'} eq "\x00\x00\x00\x00";
Branch: 1 branch
BranchTrueFalseTotal
if $targ{"creator"} eq "\0\0\0\0" 2 0 2
185 2 ▶ delete $targ{'type'} if $targ{'type'} eq "\x00\x00\x00\x00";
Branch: 1 branch
BranchTrueFalseTotal
if $targ{"type"} eq "\0\0\0\0" 2 0 2
186 2 ▶ delete $targ{'inode'} if $targ{'inode'} eq 0xFFFFFFFF;
Branch: 1 branch
BranchTrueFalseTotal
if $targ{"inode"} eq 4294967295 0 2 2
187 2 ▶ delete $into{'reserved'} if $into{'reserved'} eq ( "\x00" x 10 );
Branch: 1 branch
BranchTrueFalseTotal
if $into{"reserved"} eq "\0\0\0\0\0\0\0\0\0\0" 2 0 2
188 2 ▶ delete $vol{'fsid'} if $vol{'fsid'} eq "\x00\x00";
Branch: 1 branch
BranchTrueFalseTotal
if $vol{"fsid"} eq "\0\0" 2 0 2
189 2 ▶ delete $dir{'inode'} if $dir{'inode'} eq 0xFFFFFFFF;
Branch: 1 branch
BranchTrueFalseTotal
if $dir{"inode"} eq 4294967295 0 2 2
190  
191 # If the extra tag-length-value section exists, parse it
192 2 ▶ if (length($bytes) > $extra_ptr) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $bytes > $extra_ptr) 2 0 2
193 2 my(@extra);
194
195 2 ▶ while(length($bytes) >= (4+$extra_ptr)) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $bytes >= 4 + $extra_ptr) 22 0 22
196
197 # Extract the next record
198 22 my($t, $l) = unpack('nn', substr($bytes, $extra_ptr, 4));
199 22 ▶ last if $t == 65535;
Branch: 1 branch
BranchTrueFalseTotal
if $t == 65535 2 20 22
200 20 my($f) = substr($bytes, 4+$extra_ptr, $l);
201 20 $extra_ptr += 4 + $l;
202 20 ▶ $extra_ptr ++ if ( $l % 2 ) != 0;
Branch: 1 branch
BranchTrueFalseTotal
if $l % 2 != 0 2 18 20
203
204 # Parse a few known record types.
205 20 ▶ if ($t == 0) {
Branch: 12 branches
BranchTrueFalseTotal
if ($t == 0) { } 2 18 20
elsif ($t == 1) { } 2 16 18
elsif ($t == 2) { } 2 14 16
elsif ($t == 9) { } 0 14 14
elsif ($t == 14) { } 2 12 14
elsif ($t == 15) { } 2 10 12
elsif ($t == 16) { } 2 8 10
elsif ($t == 17) { } 2 6 8
elsif ($t == 18) { } 2 4 6
elsif ($t == 19) { } 2 2 4
elsif ($t == 20) { } 0 2 2
elsif ($t == 21) { } 2 0 2
206 2 $dir{'name'} = $f;
207 } elsif ($t == 1) {
208 2 $into{'inode_path'} = [ unpack('N*', $f) ];
209 } elsif ($t == 2) {
210 2 $into{'carbon_path'} = $f;
211 } elsif ($t == 9) {
212 # Unknown format, but known to be volume info.
213 0 $vol{'9'} = $f;
214 } elsif ($t == 14) {
215 2 $targ{'long_name'} = &unpackUC($f);
216 } elsif ($t == 15) {
217 2 $vol{'long_name'} = &unpackUC($f);
218 } elsif ($t == 16) {
219 2 $vol{'createdUTC'} = &unpackLongTime($f);
220 } elsif ($t == 17) {
221 2 $targ{'createdUTC'} = &unpackLongTime($f);
222 } elsif ($t == 18) {
223 2 $into{'posix_path'} = $f;
224 } elsif ($t == 19) {
225 2 $vol{'posix_path'} = $f;
226 } elsif ($t == 20) {
227 0 $vol{'alias'} = &unpack_alias($f);
228 } elsif ($t == 21) {
229 2 $into{'posix_homedir_length'} = unpack('n', $f);
230 } else {
231 0 push(@extra, $t, $f);
232 }
233 }
234
235 2 ▶ $into{'extra'} = \@extra if @extra;
Branch: 1 branch
BranchTrueFalseTotal
if @extra 0 2 2
236 }
237  
238 2 \%into;
239 }
240  
241 1 ▶sub pack_alias {
Subroutine pack_alias: called CC=30 SCAR=36.7
Pod undocumented
242 1 my(%alis) = @_;
243  
244 # Extract the hashes into local copies so we can
245 # remove entries as we process them.
246 1 my(%vol, %dir, %targ);
247 1 ▶ %vol = %{ delete $alis{'volume'} } if exists $alis{'volume'};
Branch: 1 branch
BranchTrueFalseTotal
if exists $alis{"volume"} 1 0 1
248 1 ▶ %dir = %{ delete $alis{'folder'} } if exists $alis{'folder'};
Branch: 1 branch
BranchTrueFalseTotal
if exists $alis{"folder"} 1 0 1
249 1 ▶ %targ = %{ delete $alis{'target'} } if exists $alis{'target'};
Branch: 1 branch
BranchTrueFalseTotal
if exists $alis{"target"} 1 0 1
250  
251 1 my($k, $i, @extra, $extra);
252  
253 # Populate the fixed-length portion of the record.
254 my(@fixed) = (
255 (delete $alis{'appinfo'}), undef, 2,
256 (delete $targ{'kind'}),
257 undef, (delete($vol{'name'})),
258 (delete @vol{qw( created signature type )}),
259 (delete $dir{'inode'}),
260 undef, (delete($targ{'name'})),
261 (delete @targ{qw( inode created type creator )}),
262 (delete @alis{qw( xfrom xto )}),
263 (delete @vol{qw( flags fsid )}),
264 1 (delete $alis{'reserved'})
265 );
266  
267 # Fail if any required info is missing.
268 1 my(%required) = (
269 3 => 'target->{"kind"}',
270 5 => 'volume->{"name"}',
271 7 => 'volume->{"signature"}',
272 8 => 'volume->{"type"}',
273 11 => 'target->{"name"}'
274 );
275 1 foreach $k (keys %required) {
276 5 ▶ croak "Missing value ".$required{$k}
Branch: 1 branch
BranchTrueFalseTotal
unless defined $fixed[$k] 0 5 5
277 unless defined($fixed[$k]);
278 }
279  
280 1 $fixed[4] = length($fixed[5]);
281 1 $fixed[10] = length($fixed[11]);
282  
283 # Fill in any missing values with their appropriate markers.
284 1 my($fc0) = "\x00\x00\x00\x00"; # FourCharCode all zeros
285 1 my(@missings) = (
286 $fc0, undef, 2,
287 undef, undef, undef,
288 0, undef, 5,
289 0xFFFFFFFF,
290 undef, undef,
291 0xFFFFFFFF, 0, $fc0, $fc0,
292 0xFFFF, 0xFFFF,
293 0, "\x00\x00",
294 ( "\x00" x 10 )
295 );
296 1 ▶ die unless (21 == @fixed) and (@fixed == @missings);
Branch: 1 branch
BranchTrueFalseTotal
unless 21 == @fixed and @fixed == @missings 0 1 1
Condition33%1/3
21 == @fixed and @fixed == @missings
!ll&&!rl&&r
001
MC/DC0%0/2
21 == @fixed and @fixed == @missings
21 == @fixed @fixed == @missings
Truth table33%1/3
A and B
A= 21 == @fixedB= @fixed == @missings
ABresult
0X0
100
111
297 1 ▶ for($i = 0; $i < 21; $i++) {
Branch: 1 branch
BranchTrueFalseTotal
if ($i < 21) 21 1 22
298 21 ▶ $fixed[$i] = $missings[$i] if !defined $fixed[$i];
Branch: 1 branch
BranchTrueFalseTotal
unless defined $fixed[$i] 8 13 21
299 }
300
301 # Process any remaining keys into the 'extra' array.
302 1 @extra = ();
303 1 foreach $k (keys %alis) {
304 4 my($v) = $alis{$k};
305 4 ▶ if ($k eq 'inode_path') {
Branch: 5 branches
BranchTrueFalseTotal
if ($k eq 'inode_path') { } 1 3 4
elsif ($k eq 'carbon_path') { } 1 2 3
elsif ($k eq 'posix_path') { } 1 1 2
elsif ($k eq 'posix_homedir_length') { } 1 0 1
elsif ($k eq 'extra') { } 0 0 0
306 1 push(@extra, 1, pack('N*', @$v));
307 } elsif ($k eq 'carbon_path') {
308 1 push(@extra, 2, $v);
309 } elsif ($k eq 'posix_path') {
310 1 push(@extra, 18, Encode::encode('utf8', $v));
311 } elsif ($k eq 'posix_homedir_length') {
312 1 push(@extra, 21, pack('n', $v));
313 } elsif ($k eq 'extra') {
314 0 push(@extra, @$v);
315 } else {
316 0 carp "Unrecognized alias key \"$k\"";
317 }
318 }
319 1 foreach $k (keys %vol) {
320 3 my($v) = $vol{$k};
321 3 ▶ if ($k eq 'long_name') {
Branch: 5 branches
BranchTrueFalseTotal
if ($k eq 'long_name') { } 1 2 3
elsif ($k eq 'posix_path') { } 1 1 2
elsif ($k eq 'alias') { } 0 1 1
elsif ($k eq 'createdUTC') { } 1 0 1
elsif ($k eq '9') { } 0 0 0
322 1 push(@extra, 15, &packUC($v));
323 } elsif ($k eq 'posix_path') {
324 1 push(@extra, 19, Encode::encode('utf8', $v));
325 } elsif ($k eq 'alias') {
326 0 push(@extra, 20, &pack_alias(%$v));
327 } elsif ($k eq 'createdUTC') {
328 1 push(@extra, 16, &packLongTime($v));
329 } elsif ($k eq '9') {
330 # Unknown format, but known to be volume info.
331 0 push(@extra, 9, $v);
332 } else {
333 0 carp "Unrecognized alias key volume->{\"$k\"}";
334 }
335 }
336 1 foreach $k (keys %dir) {
337 1 my($v) = $dir{$k};
338 1 ▶ if ($k eq 'name') {
Branch: 1 branch
BranchTrueFalseTotal
if ($k eq 'name') { } 1 0 1
339 1 push(@extra, 0, $v);
340 } else {
341 0 carp "Unrecognized alias key folder->{\"$k\"}";
342 }
343 }
344 1 foreach $k (keys %targ) {
345 2 my($v) = $targ{$k};
346 2 ▶ if ($k eq 'long_name') {
Branch: 2 branches
BranchTrueFalseTotal
if ($k eq 'long_name') { } 1 1 2
elsif ($k eq 'createdUTC') { } 1 0 1
347 1 push(@extra, 14, &packUC($v));
348 } elsif ($k eq 'createdUTC') {
349 1 push(@extra, 17, &packLongTime($v));
350 } else {
351 0 carp "Unrecognized alias key target->{\"$k\"}";
352 }
353 }
354
355 1 $extra = '';
356 1 ▶ if (@extra) {
Branch: 1 branch
BranchTrueFalseTotal
if (@extra) 1 0 1
357 1 push(@extra, 0xFFFF, '');
358  
359 1 ▶ while(@extra) {
Branch: 1 branch
BranchTrueFalseTotal
if (@extra) 11 1 12
360 11 my($t) = shift @extra;
361 11 my($v) = shift @extra;
362 11 $extra .= pack('nn', $t, length($v)) . $v;
363 11 ▶ if ((length($v) % 2) == 1) {
Branch: 1 branch
BranchTrueFalseTotal
if (length($v) % 2 == 1) 1 10 11
364 1 $extra .= "\x00";
365 }
366 }
367  
368 }
369  
370 1 $fixed[1] = 150 + length($extra);
371
372 1 return pack('a4nnn Ca27 Na2nN Ca63 NNa4a4 nnNa2 a10', @fixed) . $extra;
373 }
374  
375 7 ▶sub unpackUC {
Subroutine unpackUC: called CC=2 SCAR=7.0
Pod undocumented
376 7 my($buf) = @_;
377  
378 7 my($count) = unpack('n', $buf);
379 7 my($bufsz) = (length($buf) - 2) / 2;
380 7 ▶ warn "Unicode string has unexpected count (count=$count, expecting $bufsz)\n"
Branch: 1 branch
BranchTrueFalseTotal
if $count != $bufsz 0 7 7
381 if ($count != $bufsz);
382 7 return Encode::decode('utf-16be', substr($buf, 2));
383 }
384  
385 5 ▶sub packUC {
Subroutine packUC: called CC=1 SCAR=0.0
Pod undocumented
386 5 my($str) = @_;
387 5 my($bytes) = Encode::encode('utf-16be', NFD($str));
388 5 return pack('n', length($bytes)/2) . $bytes;
389 }
390  
391 9 ▶sub unpackLongTime {
Subroutine unpackLongTime: called CC=3 SCAR=11.0
Pod undocumented
392 # Precise times are stored in 48.16-fixed-point time format
393 # This corresponds to the UTCDateTime format.
394 # It represents the number of seconds (and fractional seconds)
395 # since the Mac epoch of Jan 1, 1904.
396 # The offset from the common POSIX epoch is 2082844800 seconds.
397 9 my($h, $m, $l) = unpack('nNn', $_[0]);
398 9 my($t);
399
400 9 ▶ if ($h == 0) {
Branch: 1 branch
BranchTrueFalseTotal
if ($h == 0) { } 7 2 9
401 7 $t = $m;
402 } else {
403 2 $t = from_hex Math::BigInt '0x'.unpack('H*', substr($_[0], 0, 6));
404 }
405  
406 9 ▶ return $t if ($l == 0);
Branch: 1 branch
BranchTrueFalseTotal
if $l == 0 7 2 9
407
408 2 $l = new Math::BigFloat $l;
409 2 $l->precision(-5);
410 2 $l->bdiv(65536);
411 2 $l->badd($t);
412 2 return $l;
413 }
414  
415 7 ▶sub packLongTime {
Subroutine packLongTime: called CC=4 SCAR=15.0
Pod undocumented
416 7 my($str) = @_;
417 7 my(@x);
418  
419 7 ▶ if (@x = ($str =~ /^(\d+):(\d+):(\d+)$/)) {
Branch: 3 branches
BranchTrueFalseTotal
if (@x = $str =~ /^(\d+):(\d+):(\d+)$/) { } 0 7 7
elsif ($str =~ /^(\d+)(\.\d+)$/) { } 2 5 7
elsif ($str =~ /^\d+$/) { } 5 0 5
420 0 return pack('nNn', @x);
421 } elsif ($str =~ /^(\d+)(\.\d+)$/) {
422 2 return pack('nNn', 0, int($1), 65536 * ('0' . $2));
423 } elsif ($str =~ /^\d+$/) {
424 5 return pack('nNn', 0, $str, 0);
425 } else {
426 0 croak "Cannot pack \"$str\" into 48.16-bit time";
427 }
428 }
429  
430 =head1 CREDITS
431  
432 The initial information about the structure of alias records was derived
433 from an unattributed text file found in various places on the internet.
434  
435 Perl implementation and additional format investigation by Wim Lewis.
436  
437 =head1 COPYRIGHT
438  
439 Copyright 2011-2013, Wim Lewis E<lt>wiml@hhhh.orgE<gt>
440  
441 This software is available under the same terms as perl.
442  
443 =cut
444  
445 2 1;
↑ Summary