ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
Public Member Functions
getid3_tar Class Reference

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g // More...

+ Inheritance diagram for getid3_tar:
+ Collaboration diagram for getid3_tar:

Public Member Functions

 getid3_tar (&$fd, &$ThisFileInfo)
 
 display_perms ($mode)
 
 get_flag_type ($typflag)
 
 Analyze ()
 
 display_perms ($mode)
 
 get_flag_type ($typflag)
 
- Public Member Functions inherited from getid3_handler
 __construct (getID3 $getid3, $call_module=null)
 
 Analyze ()
 
 AnalyzeString ($string)
 
 setStringMode ($string)
 
 saveAttachment ($name, $offset, $length, $image_mime=null)
 

Additional Inherited Members

- Protected Member Functions inherited from getid3_handler
 ftell ()
 
 fread ($bytes)
 
 fseek ($bytes, $whence=SEEK_SET)
 
 feof ()
 
 isDependencyFor ($module)
 
 error ($text)
 
 warning ($text)
 
 notice ($text)
 
- Protected Attributes inherited from getid3_handler
 $getid3
 
 $data_string_flag = false
 
 $data_string = ''
 
 $data_string_position = 0
 
 $data_string_length = 0
 

Detailed Description

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g //

Definition at line 17 of file module.archive.tar.php.

Member Function Documentation

◆ Analyze()

getid3_tar::Analyze ( )

Reimplemented from getid3_handler.

Definition at line 26 of file module.archive.tar.php.

26 {
27 $info = &$this->getid3->info;
28
29 $info['fileformat'] = 'tar';
30 $info['tar']['files'] = array();
31
32 $unpack_header = 'a100fname/a8mode/a8uid/a8gid/a12size/a12mtime/a8chksum/a1typflag/a100lnkname/a6magic/a2ver/a32uname/a32gname/a8devmaj/a8devmin/a155prefix';
33 $null_512k = str_repeat("\x00", 512); // end-of-file marker
34
35 $this->fseek(0);
36 while (!feof($this->getid3->fp)) {
37 $buffer = $this->fread(512);
38 if (strlen($buffer) < 512) {
39 break;
40 }
41
42 // check the block
43 $checksum = 0;
44 for ($i = 0; $i < 148; $i++) {
45 $checksum += ord($buffer{$i});
46 }
47 for ($i = 148; $i < 156; $i++) {
48 $checksum += ord(' ');
49 }
50 for ($i = 156; $i < 512; $i++) {
51 $checksum += ord($buffer{$i});
52 }
53 $attr = unpack($unpack_header, $buffer);
54 $name = (isset($attr['fname'] ) ? trim($attr['fname'] ) : '');
55 $mode = octdec(isset($attr['mode'] ) ? trim($attr['mode'] ) : '');
56 $uid = octdec(isset($attr['uid'] ) ? trim($attr['uid'] ) : '');
57 $gid = octdec(isset($attr['gid'] ) ? trim($attr['gid'] ) : '');
58 $size = octdec(isset($attr['size'] ) ? trim($attr['size'] ) : '');
59 $mtime = octdec(isset($attr['mtime'] ) ? trim($attr['mtime'] ) : '');
60 $chksum = octdec(isset($attr['chksum'] ) ? trim($attr['chksum'] ) : '');
61 $typflag = (isset($attr['typflag']) ? trim($attr['typflag']) : '');
62 $lnkname = (isset($attr['lnkname']) ? trim($attr['lnkname']) : '');
63 $magic = (isset($attr['magic'] ) ? trim($attr['magic'] ) : '');
64 $ver = (isset($attr['ver'] ) ? trim($attr['ver'] ) : '');
65 $uname = (isset($attr['uname'] ) ? trim($attr['uname'] ) : '');
66 $gname = (isset($attr['gname'] ) ? trim($attr['gname'] ) : '');
67 $devmaj = octdec(isset($attr['devmaj'] ) ? trim($attr['devmaj'] ) : '');
68 $devmin = octdec(isset($attr['devmin'] ) ? trim($attr['devmin'] ) : '');
69 $prefix = (isset($attr['prefix'] ) ? trim($attr['prefix'] ) : '');
70 if (($checksum == 256) && ($chksum == 0)) {
71 // EOF Found
72 break;
73 }
74 if ($prefix) {
75 $name = $prefix.'/'.$name;
76 }
77 if ((preg_match('#/$#', $name)) && !$name) {
78 $typeflag = 5;
79 }
80 if ($buffer == $null_512k) {
81 // it's the end of the tar-file...
82 break;
83 }
84
85 // Read to the next chunk
86 $this->fseek($size, SEEK_CUR);
87
88 $diff = $size % 512;
89 if ($diff != 0) {
90 // Padding, throw away
91 $this->fseek((512 - $diff), SEEK_CUR);
92 }
93 // Protect against tar-files with garbage at the end
94 if ($name == '') {
95 break;
96 }
97 $info['tar']['file_details'][$name] = array (
98 'name' => $name,
99 'mode_raw' => $mode,
100 'mode' => self::display_perms($mode),
101 'uid' => $uid,
102 'gid' => $gid,
103 'size' => $size,
104 'mtime' => $mtime,
105 'chksum' => $chksum,
106 'typeflag' => self::get_flag_type($typflag),
107 'linkname' => $lnkname,
108 'magic' => $magic,
109 'version' => $ver,
110 'uname' => $uname,
111 'gname' => $gname,
112 'devmajor' => $devmaj,
113 'devminor' => $devmin
114 );
115 $info['tar']['files'] = getid3_lib::array_merge_clobber($info['tar']['files'], getid3_lib::CreateDeepArray($info['tar']['file_details'][$name]['name'], '/', $size));
116 }
117 return true;
118 }
$size
$size
Definition: RandomTest.php:79
getid3_handler\fseek
fseek($bytes, $whence=SEEK_SET)
Definition: getid3.php:1697
getid3_handler\fread
fread($bytes)
Definition: getid3.php:1685
getid3_handler\feof
feof()
Definition: getid3.php:1727
getid3_lib\CreateDeepArray
CreateDeepArray($ArrayPath, $Separator, $Value)
Definition: getid3.lib.php:465
getid3_lib\array_merge_clobber
array_merge_clobber($array1, $array2)
Definition: getid3.lib.php:358
$info
$info
Definition: example_052.php:80

References $info, $size, getid3_lib\array_merge_clobber(), getid3_lib\CreateDeepArray(), getid3_handler\feof(), getid3_handler\fread(), and getid3_handler\fseek().

+ Here is the call graph for this function:

◆ display_perms() [1/2]

getid3_tar::display_perms (   $mode)

Definition at line 109 of file module.archive.tar.php.

109 {
110 // Determine Type
111 if ($mode & 0x1000) $type='p'; // FIFO pipe
112 elseif ($mode & 0x2000) $type='c'; // Character special
113 elseif ($mode & 0x4000) $type='d'; // Directory
114 elseif ($mode & 0x6000) $type='b'; // Block special
115 elseif ($mode & 0x8000) $type='-'; // Regular
116 elseif ($mode & 0xA000) $type='l'; // Symbolic Link
117 elseif ($mode & 0xC000) $type='s'; // Socket
118 else $type='u'; // UNKNOWN
119
120 // Determine permissions
121 $owner['read'] = (($mode & 00400) ? 'r' : '-');
122 $owner['write'] = (($mode & 00200) ? 'w' : '-');
123 $owner['execute'] = (($mode & 00100) ? 'x' : '-');
124 $group['read'] = (($mode & 00040) ? 'r' : '-');
125 $group['write'] = (($mode & 00020) ? 'w' : '-');
126 $group['execute'] = (($mode & 00010) ? 'x' : '-');
127 $world['read'] = (($mode & 00004) ? 'r' : '-');
128 $world['write'] = (($mode & 00002) ? 'w' : '-');
129 $world['execute'] = (($mode & 00001) ? 'x' : '-');
130
131 // Adjust for SUID, SGID and sticky bit
132 if ($mode & 0x800) $owner['execute'] = ($owner['execute'] == 'x') ? 's' : 'S';
133 if ($mode & 0x400) $group['execute'] = ($group['execute'] == 'x') ? 's' : 'S';
134 if ($mode & 0x200) $world['execute'] = ($world['execute'] == 'x') ? 't' : 'T';
135
136 $s = sprintf('%1s', $type);
137 $s .= sprintf('%1s%1s%1s', $owner['read'], $owner['write'], $owner['execute']);
138 $s .= sprintf('%1s%1s%1s', $group['read'], $group['write'], $group['execute']);
139 $s .= sprintf('%1s%1s%1s'."\n", $world['read'], $world['write'], $world['execute']);
140 return $s;
141 }

Referenced by getid3_tar().

+ Here is the caller graph for this function:

◆ display_perms() [2/2]

getid3_tar::display_perms (   $mode)

Definition at line 121 of file module.archive.tar.php.

121 {
122 // Determine Type
123 if ($mode & 0x1000) $type='p'; // FIFO pipe
124 elseif ($mode & 0x2000) $type='c'; // Character special
125 elseif ($mode & 0x4000) $type='d'; // Directory
126 elseif ($mode & 0x6000) $type='b'; // Block special
127 elseif ($mode & 0x8000) $type='-'; // Regular
128 elseif ($mode & 0xA000) $type='l'; // Symbolic Link
129 elseif ($mode & 0xC000) $type='s'; // Socket
130 else $type='u'; // UNKNOWN
131
132 // Determine permissions
133 $owner['read'] = (($mode & 00400) ? 'r' : '-');
134 $owner['write'] = (($mode & 00200) ? 'w' : '-');
135 $owner['execute'] = (($mode & 00100) ? 'x' : '-');
136 $group['read'] = (($mode & 00040) ? 'r' : '-');
137 $group['write'] = (($mode & 00020) ? 'w' : '-');
138 $group['execute'] = (($mode & 00010) ? 'x' : '-');
139 $world['read'] = (($mode & 00004) ? 'r' : '-');
140 $world['write'] = (($mode & 00002) ? 'w' : '-');
141 $world['execute'] = (($mode & 00001) ? 'x' : '-');
142
143 // Adjust for SUID, SGID and sticky bit
144 if ($mode & 0x800) $owner['execute'] = ($owner['execute'] == 'x') ? 's' : 'S';
145 if ($mode & 0x400) $group['execute'] = ($group['execute'] == 'x') ? 's' : 'S';
146 if ($mode & 0x200) $world['execute'] = ($world['execute'] == 'x') ? 't' : 'T';
147
148 $s = sprintf('%1s', $type);
149 $s .= sprintf('%1s%1s%1s', $owner['read'], $owner['write'], $owner['execute']);
150 $s .= sprintf('%1s%1s%1s', $group['read'], $group['write'], $group['execute']);
151 $s .= sprintf('%1s%1s%1s'."\n", $world['read'], $world['write'], $world['execute']);
152 return $s;
153 }

◆ get_flag_type() [1/2]

getid3_tar::get_flag_type (   $typflag)

Definition at line 144 of file module.archive.tar.php.

144 {
145 static $flag_types = array(
146 '0' => 'LF_NORMAL',
147 '1' => 'LF_LINK',
148 '2' => 'LF_SYNLINK',
149 '3' => 'LF_CHR',
150 '4' => 'LF_BLK',
151 '5' => 'LF_DIR',
152 '6' => 'LF_FIFO',
153 '7' => 'LF_CONFIG',
154 'D' => 'LF_DUMPDIR',
155 'K' => 'LF_LONGLINK',
156 'L' => 'LF_LONGNAME',
157 'M' => 'LF_MULTIVOL',
158 'N' => 'LF_NAMES',
159 'S' => 'LF_SPARSE',
160 'V' => 'LF_VOLHDR'
161 );
162 return @$flag_types[$typflag];
163 }

Referenced by getid3_tar().

+ Here is the caller graph for this function:

◆ get_flag_type() [2/2]

getid3_tar::get_flag_type (   $typflag)

Definition at line 156 of file module.archive.tar.php.

156 {
157 static $flag_types = array(
158 '0' => 'LF_NORMAL',
159 '1' => 'LF_LINK',
160 '2' => 'LF_SYNLINK',
161 '3' => 'LF_CHR',
162 '4' => 'LF_BLK',
163 '5' => 'LF_DIR',
164 '6' => 'LF_FIFO',
165 '7' => 'LF_CONFIG',
166 'D' => 'LF_DUMPDIR',
167 'K' => 'LF_LONGLINK',
168 'L' => 'LF_LONGNAME',
169 'M' => 'LF_MULTIVOL',
170 'N' => 'LF_NAMES',
171 'S' => 'LF_SPARSE',
172 'V' => 'LF_VOLHDR'
173 );
174 return (isset($flag_types[$typflag]) ? $flag_types[$typflag] : '');
175 }

◆ getid3_tar()

getid3_tar::getid3_tar ( &  $fd,
&  $ThisFileInfo 
)

Definition at line 19 of file module.archive.tar.php.

19 {
20 $ThisFileInfo['fileformat'] = 'tar';
21 $ThisFileInfo['tar']['files'] = array();
22
23 $unpack_header = 'a100fname/a8mode/a8uid/a8gid/a12size/a12mtime/a8chksum/a1typflag/a100lnkname/a6magic/a2ver/a32uname/a32gname/a8devmaj/a8devmin/a155/prefix';
24 $null_512k = str_repeat("\0", 512); // end-of-file marker
25
26 @fseek($fd, 0);
27 while (!feof($fd)) {
28 $buffer = fread($fd, 512);
29
30 // check the block
31 $checksum = 0;
32 for ($i = 0; $i < 148; $i++) {
33 $checksum += ord($buffer{$i});
34 }
35 for ($i = 148; $i < 156; $i++) {
36 $checksum += ord(' ');
37 }
38 for ($i = 156; $i < 512; $i++) {
39 $checksum += ord($buffer{$i});
40 }
41 $attr = unpack($unpack_header, $buffer);
42 $name = trim(@$attr['fname']);
43 $mode = octdec(trim(@$attr['mode']));
44 $uid = octdec(trim(@$attr['uid']));
45 $gid = octdec(trim(@$attr['gid']));
46 $size = octdec(trim(@$attr['size']));
47 $mtime = octdec(trim(@$attr['mtime']));
48 $chksum = octdec(trim(@$attr['chksum']));
49 $typflag = trim(@$attr['typflag']);
50 $lnkname = trim(@$attr['lnkname']);
51 $magic = trim(@$attr['magic']);
52 $ver = trim(@$attr['ver']);
53 $uname = trim(@$attr['uname']);
54 $gname = trim(@$attr['gname']);
55 $devmaj = octdec(trim(@$attr['devmaj']));
56 $devmin = octdec(trim(@$attr['devmin']));
57 $prefix = trim(@$attr['prefix']);
58 if (($checksum == 256) && ($chksum == 0)) {
59 // EOF Found
60 break;
61 }
62 if ($prefix) {
63 $name = $prefix.'/'.$name;
64 }
65 if ((preg_match('#/$#', $name)) && !$name) {
66 $typeflag = 5;
67 }
68 if ($buffer == $null_512k) {
69 // it's the end of the tar-file...
70 break;
71 }
72
73 // Read to the next chunk
74 fseek($fd, $size, SEEK_CUR);
75
76 $diff = $size % 512;
77 if ($diff != 0) {
78 // Padding, throw away
79 fseek($fd, (512 - $diff), SEEK_CUR);
80 }
81 // Protect against tar-files with garbage at the end
82 if ($name == '') {
83 break;
84 }
85 $ThisFileInfo['tar']['file_details'][$name] = array (
86 'name' => $name,
87 'mode_raw' => $mode,
88 'mode' => getid3_tar::display_perms($mode),
89 'uid' => $uid,
90 'gid' => $gid,
91 'size' => $size,
92 'mtime' => $mtime,
93 'chksum' => $chksum,
94 'typeflag' => getid3_tar::get_flag_type($typflag),
95 'linkname' => $lnkname,
96 'magic' => $magic,
97 'version' => $ver,
98 'uname' => $uname,
99 'gname' => $gname,
100 'devmajor' => $devmaj,
101 'devminor' => $devmin
102 );
103 $ThisFileInfo['tar']['files'] = getid3_lib::array_merge_clobber($ThisFileInfo['tar']['files'], getid3_lib::CreateDeepArray($ThisFileInfo['tar']['file_details'][$name]['name'], '/', $size));
104 }
105 return true;
106 }
getid3_tar\display_perms
display_perms($mode)
Definition: module.archive.tar.php:109
getid3_tar\get_flag_type
get_flag_type($typflag)
Definition: module.archive.tar.php:144

References $size, getid3_lib\array_merge_clobber(), getid3_lib\CreateDeepArray(), display_perms(), getid3_handler\feof(), getid3_handler\fread(), getid3_handler\fseek(), and get_flag_type().

+ Here is the call graph for this function:
The documentation for this class was generated from the following files: