Device::Cdio::Util(3pm) User Contributed Perl Documentation Device::Cdio::Util(3pm)NAME
Device::Cdio::Util - Internal utilities used by Cdio modules
SYNOPSIS
none
DESCRIPTION
no public subroutines
AUTHOR INFORMATION
Code taken from CGI::Util.pm which reads: Copyright 1995-1998, Lincoln D. Stein. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
Device::Cdio
perl v5.14.2 2012-06-22 Device::Cdio::Util(3pm)
Check Out this Related Man Page
Device::Cdio::ISO9660::FS(3pm) User Contributed Perl Documentation Device::Cdio::ISO9660::FS(3pm)NAME
Device::Cdio::ISO9660::FS - Class for ISO 9660 CD reading
SYNOPSIS
This encapsulates ISO 9660 Filesystem aspects of CD Tracks. As such this is a This library however needs to be used in conjunction with
Device::Cdio::ISO9660.
use Device::Cdio::ISO9660:FS;
$cd = Device::Cdio::ISO9660::FS->new(-source=>'/dev/cdrom');
$statbuf = $cd->stat ($iso9660_path.$local_filename);
$blocks = POSIX::ceil($statbuf->{size} / $perlcdio::ISO_BLOCKSIZE);
for (my $i = 0; $i < $blocks; $i++) {
my $buf = $cd->read_data_blocks ($statbuf->{LSN} + $i);
die if !defined($buf);
}
print $buf;
DESCRIPTION
This is an Object-Oriented interface to the GNU CD Input and Control library ("libcdio") which is written in C. This class handles ISO 9660
tracks on a CD or in a CD-ROM.
Note that working with a CD in a CD-ROM which has tracks in the ISO-9660 format is distinct working with a file in a filesystem which
contains an ISO-9660 image. See also Device::Cdio::ISO9660::IFS for working with an ISO 9660 image stored as a file in a fileystem.
CALLING ROUTINES
Routines accept named parameters as well as positional parameters. For named parameters, each argument name is preceded by a dash. For
example:
Device::Cdio::ISO9660::FS->new(-source=>'MYISO.CUE')
Each argument name is preceded by a dash. Neither case nor order matters in the argument list. -driver_id, -Driver_ID, and -DRIVER_ID are
all acceptable. In fact, only the first argument needs to begin with a dash. If a dash is present in the first argument, we assume dashes
for the subsequent parameters.
In the documentation below and elsewhere in this package the parameter name that can be used in this style of call is given in the
parameter list. For example, for "close_tray" the documentation below reads:
close_tray(drive=undef, driver_id=$perlcdio::DRIVER_UNKNOWN)
-> ($drc, $driver_id)
So the parameter names are "drive", and "driver_id". Neither parameter is required. If "drive" is not specified, a value of "undef" will be
used. And if "driver_id" is not specified, a value of $perlcdio::DRIVER_UNKNOWN is used.
The older, more traditional style of positional parameters is also supported. So the "new" example from above can also be written:
Device::Cdio::ISO9660::FS->new('MYISO.CUE')
Finally, since no parameter name can be confused with a an integer, negative values will not get confused as a named parameter.
find_lsn
find_lsn(lsn)->$stat_href
Find the filesystem entry that contains LSN and return information about it. Undef is returned on error.
readdir
readdir(dirname)->@iso_stat
Read path (a directory) and return a list of iso9660 stat references
Each item of @iso_stat is a hash reference which contains
LSN the Logical sector number (an integer)
size
the total size of the file in bytes
sec_size
the number of sectors allocated
filename
the file name of the statbuf entry
XA if the file has XA attributes; 0 if not
is_dir
1 if a directory; 0 if a not;
FIXME: If you look at iso9660.h you'll see more fields, such as for Rock-Ridge specific fields or XA specific fields. Eventually these will
be added. Volunteers?
read_pvd
read_pvd()->pvd
Read the Super block of an ISO 9660 image. This is the Primary Volume Descriptor (PVD) and perhaps a Supplemental Volume Descriptor if
(Joliet) extensions are acceptable.
read_superblock
read_superblock(iso_mask=$libiso9660::EXTENSION_NONE)->bool
Read the Super block of an ISO 9660 image. This is the rimary Volume Descriptor (PVD) and perhaps a Supplemental Volume Descriptor if
(Joliet) extensions are acceptable.
stat
stat(path, translate=0)->\%stat
Return file status for path name psz_path. NULL is returned on error.
If translate is 1, version numbers in the ISO 9660 name are dropped, i.e. ;1 is removed and if level 1 ISO-9660 names are lowercased.
Each item of @iso_stat is a hash reference which contains
LSN the Logical sector number (an integer)
size
the total size of the file in bytes
sec_size
the number of sectors allocated
filename
the file name of the statbuf entry
XA if the file has XA attributes; 0 if not
is_dir
1 if a directory; 0 if a not;
SEE ALSO
This is a subclass of Device::Cdio::Device. See also Device::Cdio::Device. See Device::Cdio::ISO9660::IFS for working with ISO 9660 images.
perliso9660 is the lower-level interface to "libiso9660", the ISO 9660 library of "libcdio".
<http://www.gnu.org/software/libcdio/doxygen/iso9660_8h.html> is documentation via doxygen of "libiso9660". doxygen.
AUTHORS
Rocky Bernstein "<rocky at cpan.org>".
COPYRIGHT
Copyright (C) 2006, 2007, 2008 Rocky Bernstein <rocky@cpan.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 3 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/>.
perl v5.14.2 2012-06-22 Device::Cdio::ISO9660::FS(3pm)