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 ( )

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

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

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_lib\array_merge_clobber
array_merge_clobber($array1, $array2)
Definition: getid3.lib.php:358
$info
$info
Definition: example_052.php:80
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_handler\fseek
fseek($bytes, $whence=SEEK_SET)
Definition: getid3.php:1697
+ 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.

Referenced by getid3_tar().

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  }
+ 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.

Referenced by getid3_tar().

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  }
+ 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.

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().

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  }
$size
$size
Definition: RandomTest.php:79
getid3_lib\array_merge_clobber
array_merge_clobber($array1, $array2)
Definition: getid3.lib.php:358
getid3_tar\display_perms
display_perms($mode)
Definition: module.archive.tar.php:109
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_handler\fseek
fseek($bytes, $whence=SEEK_SET)
Definition: getid3.php:1697
getid3_tar\get_flag_type
get_flag_type($typflag)
Definition: module.archive.tar.php:144
+ Here is the call graph for this function:
The documentation for this class was generated from the following file: