.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Device::Cdio::ISO9660::FS 3pm" .TH Device::Cdio::ISO9660::FS 3pm "2018-11-01" "perl v5.28.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Device::Cdio::ISO9660::FS \- Class for ISO 9660 CD reading .SH "SYNOPSIS" .IX Header "SYNOPSIS" This encapsulates \s-1ISO 9660\s0 Filesystem aspects of \s-1CD\s0 Tracks. As such this is a This library however needs to be used in conjunction with Device::Cdio::ISO9660. .PP .Vb 3 \& use Device::Cdio::ISO9660:FS; \& $cd = Device::Cdio::ISO9660::FS\->new(\-source=>\*(Aq/dev/cdrom\*(Aq); \& $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; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This is an Object-Oriented interface to the \s-1GNU CD\s0 Input and Control library (\f(CW\*(C`libcdio\*(C'\fR) which is written in C. This class handles \s-1ISO 9660\s0 tracks on a \s-1CD\s0 or in a CD-ROM. .PP Note that working with a \s-1CD\s0 in a CD-ROM which has tracks in the \&\s-1ISO\-9660\s0 format is distinct working with a \fIfile\fR in a filesystem which contains an \s-1ISO\-9660\s0 image. See also Device::Cdio::ISO9660::IFS for working with an \s-1ISO 9660\s0 image stored as a file in a filesystem. .SS "\s-1CALLING ROUTINES\s0" .IX Subsection "CALLING ROUTINES" Routines accept named parameters as well as positional parameters. For named parameters, each argument name is preceded by a dash. For example: .PP .Vb 1 \& Device::Cdio::ISO9660::FS\->new(\-source=>\*(AqMYISO.CUE\*(Aq) .Ve .PP 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. .PP 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 \*(L"close_tray\*(R" the documentation below reads: .PP .Vb 2 \& close_tray(drive=undef, driver_id=$perlcdio::DRIVER_UNKNOWN) \& \-> ($drc, $driver_id) .Ve .PP So the parameter names are \*(L"drive\*(R", and \*(L"driver_id\*(R". Neither parameter is required. If \*(L"drive\*(R" is not specified, a value of \*(L"undef\*(R" will be used. And if \*(L"driver_id\*(R" is not specified, a value of \&\f(CW$perlcdio::DRIVER_UNKNOWN\fR is used. .PP The older, more traditional style of positional parameters is also supported. So the \*(L"new\*(R" example from above can also be written: .PP .Vb 1 \& Device::Cdio::ISO9660::FS\->new(\*(AqMYISO.CUE\*(Aq) .Ve .PP Finally, since no parameter name can be confused with a an integer, negative values will not get confused as a named parameter. .SS "find_lsn" .IX Subsection "find_lsn" .Vb 1 \& find_lsn(lsn)\->$stat_href .Ve .PP Find the filesystem entry that contains \s-1LSN\s0 and return information about it. Undef is returned on error. .SS "readdir" .IX Subsection "readdir" .Vb 1 \& readdir(dirname)\->@iso_stat .Ve .PP Read path (a directory) and return a list of iso9660 stat references .PP Each item of \f(CW@iso_stat\fR is a hash reference which contains .IP "\s-1LSN\s0" 4 .IX Item "LSN" the Logical sector number (an integer) .IP "size" 4 .IX Item "size" the total size of the file in bytes .IP "sec_size" 4 .IX Item "sec_size" the number of sectors allocated .IP "filename" 4 .IX Item "filename" the file name of the statbuf entry .IP "\s-1XA\s0" 4 .IX Item "XA" if the file has \s-1XA\s0 attributes; 0 if not .IP "is_dir" 4 .IX Item "is_dir" 1 if a directory; 0 if a not; .PP \&\s-1FIXME:\s0 If you look at iso9660.h you'll see more fields, such as for Rock-Ridge specific fields or \s-1XA\s0 specific fields. Eventually these will be added. Volunteers? .SS "read_pvd" .IX Subsection "read_pvd" .Vb 1 \& read_pvd()\->pvd .Ve .PP Read the Super block of an \s-1ISO 9660\s0 image. This is the Primary Volume Descriptor (\s-1PVD\s0) and perhaps a Supplemental Volume Descriptor if (Joliet) extensions are acceptable. .SS "read_superblock" .IX Subsection "read_superblock" .Vb 1 \& read_superblock(iso_mask=$libiso9660::EXTENSION_NONE)\->bool .Ve .PP Read the Super block of an \s-1ISO 9660\s0 image. This is the rimary Volume Descriptor (\s-1PVD\s0) and perhaps a Supplemental Volume Descriptor if (Joliet) extensions are acceptable. .SS "stat" .IX Subsection "stat" .Vb 1 \& stat(path, translate=0)\->\e%stat .Ve .PP Return file status for path name psz_path. \s-1NULL\s0 is returned on error. .PP If translate is 1, version numbers in the \s-1ISO 9660\s0 name are dropped, i.e. ;1 is removed and if level 1 \s-1ISO\-9660\s0 names are lowercased. .PP Each item of \f(CW@iso_stat\fR is a hash reference which contains .IP "\s-1LSN\s0" 4 .IX Item "LSN" the Logical sector number (an integer) .IP "size" 4 .IX Item "size" the total size of the file in bytes .IP "sec_size" 4 .IX Item "sec_size" the number of sectors allocated .IP "filename" 4 .IX Item "filename" the file name of the statbuf entry .IP "\s-1XA\s0" 4 .IX Item "XA" if the file has \s-1XA\s0 attributes; 0 if not .IP "is_dir" 4 .IX Item "is_dir" 1 if a directory; 0 if a not; .SH "SEE ALSO" .IX Header "SEE ALSO" This is a subclass of Device::Cdio::Device. See also Device::Cdio::Device. See Device::Cdio::ISO9660::IFS for working with \s-1ISO 9660\s0 images. .PP perliso9660 is the lower-level interface to \f(CW\*(C`libiso9660\*(C'\fR, the \s-1ISO 9660\s0 library of \f(CW\*(C`libcdio\*(C'\fR. .PP is documentation via doxygen of \f(CW\*(C`libiso9660\*(C'\fR. doxygen. .SH "AUTHORS" .IX Header "AUTHORS" Rocky Bernstein .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2006, 2007, 2008, 2017 Rocky Bernstein .PP This program is free software: you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program. If not, see The \s-1GNU\s0 General Public License .