|perlcdio(3pm)||User Contributed Perl Documentation||perlcdio(3pm)|
NAME¶perlcdio - lower-level wrapper to libcdio, the CD Input and Control library
SYNOPSIS¶This is fairly straight-forward wrapper around the C library libcdio. Although this is perfectly usable on its own, it is expected that the Object-Oriented interface Device::Cdio is what most people will want to use.
There are various constants that are defined here.
DESCRIPTION¶Encapsulation is done in two parts. The lower-level Perl interface is called perlcdio (this file) and is generated via SWIG.
- Use when you don't know what kind of driver and you don't care if it is an CD image driver or a real CD-ROM driver. See also DRIVER_DEVICE which doesn't include image drivers.
- Driver for IBM's AIX.
- Driver for BSDI.
- Driver for Free BSD
- Driver for GNU/LINUX
- Driver for Solaris
- Driver for Apple's OS X.
- Driver for Microsoft Windows
- Image Driver for cdrdao
- Image driver for CDRWin BIN/CUE
- Image driver for Nero NRG
- Use when you don't know what kind of driver but the driver must be a real CD-ROM driver. See also DRIVER_UNKNOWN which includes image drivers.
Driver Return codes¶May driver operations return a status code.
- Driver operation was successful
- Driver operation had an error of some sort
- Operation is not supported for this driver. For example ejecting a CD from an image driver.
- Source is not initialized for this operation.
- Operation is not permitted
- An invalid parameter was passed to the routine
- A pointer somehow got corrupted.
- No driver has been set.
- Has some sort of CD writer ability
- Has some sort of DVD writer ability
- Has some sort of writer ability
Filesystem type constants¶These constants are used in getting drive capabilities:
- audio only - not really a filesystem
- High-Sierra Filesystem
- ISO-9660 filesystem
- file system used on the Macintosh system in MacOS 6 through MacOS 9 and deprecated in OSX
- Generic Unix file system derived from the Berkeley fast file system.
- EXT2 was the GNU/Linux native filesystem for early kernels. Newer GNU/Linux OS's may use EXT3 which EXT2 with a journal.
- both HFS & ISO-9660 filesystem
- both CD-RTOS and ISO filesystem
- The 3DO is, technically, a set of specifications created by the 3DO company. These specs are for making a 3DO Interactive Multiplayer which uses a CD-player. Panasonic in the early 90's was the first company to manufacture and market a 3DO player.
- Microsoft X-BOX CD
- eXtended Architecture format
- CD has multisesion
- Is a Kodak Photo CD
- Hidden track at the beginning the CD
- CD is bootable
- VCD 1.1
- Has Rock Ridge Extensions to ISO 9660
- Microsoft Joliet extensions to ISO 9660
- Super VCD or Choiji Video CD
- Choiji Video CD
- XBOX CD determined by some analysis
- bitmask which can be used to specify matching any sort of CD
Sector size constants¶
- Size of a Philip Red book CD-DA block. It is also the maximum CD sector size possible: 2352 bytes.
- Size of an ISO 9660 block. Also the size of the data portion in CD data reads: 2048 bytes.
- Mode 2 Form 2 Data size: 2328 bytes.
- Mod1 Form 1 Data size: 2336 bytes.
- audio mode (CD-DA) read. Blocksize is a multiple of $perlcdio::CD_FRAMESIZE_RAW (2352) bytes.
- Mode 1 Form 1 read. Blocksize is a multiple of $perlcdio::CD_FRAMESIZE (2048) bytes.
- Mode 1 Form 2 read. Blocksize is a multiple of $perlcdio::M2RAW_SECTIOR_SIZE (2336) bytes.
- Mode 2 Form 1 read. Blocksize is a multiple of $perlcdio::CD_FRAMESIZE (2048) bytes.
- Mode 2 Form 1 read. Blocksize is a multiple of (2328) bytes.
- libcdio version that is getting used
- Canonical value used for an invalid LBA.
- Canonical value used for an invalid LSN.
- Canonical value used for an invalid track number. (Valid range is 0 to 99.)
- Canonical value for the "leadout" or track just after the last track. So again this value is outside the range 0 to 99. The leadout track is often used to get the last LSN or LBA. The libcdio routines also allow the last actual track plus one as a synonym for the leadout track.
Returns the libcdio version string Device::Cdio is currently linked with.
this¶This seems to be an artifact of SWIG.
SEE ALSO¶<http://www.gnu.org/software/libcdio> has documentation on libcdio including the a manual and the API via doxygen.
AUTHORS¶Rocky Bernstein "<rocky at cpan.org>".
COPYRIGHT¶Copyright (C) 2006, 2008, 2011 Rocky Bernstein <firstname.lastname@example.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/>.