Scroll to navigation

perlcdio(3pm) User Contributed Perl Documentation perlcdio(3pm)


perlcdio - lower-level wrapper to libcdio, the CD Input and Control library


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.


Encapsulation is done in two parts. The lower-level Perl interface is called perlcdio (this file) and is generated via SWIG.


Driver ID's

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.

Device Capabilities


Read Capabilities

Writing masks

Derived Capabilities

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.

Reading Modes

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 seems to be an artifact of SWIG.


<> has documentation on libcdio including the a manual and the API via doxygen.


Rocky Bernstein "<rocky at>".


Copyright (C) 2006, 2008, 2011 Rocky Bernstein <>

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

2022-06-08 perl v5.34.0