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.
CONSTANTS
Driver ID's
DRIVER_UNKNOWN
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_AIX
Driver for IBM's AIX.
DRIVER_BSDI
Driver for BSDI.
DRIVER_FREEBSD
Driver for Free BSD
DRIVER_LINUX
Driver for GNU/LINUX
DRIVER_SOLARIS
Driver for Solaris
DRIVER_OSX
Driver for Apple's OS X.
DRIVER_WIN32
Driver for Microsoft Windows
DRIVER_CDRDAO
Image Driver for cdrdao
DRIVER_BINCUE
Image driver for CDRWin BIN/CUE
DRIVER_NRG
Image driver for Nero NRG
DRIVER_DEVICE
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.
Real OS driver numbers come before image-disc drivers. Here are
constants that can be used in iteration.
MIN_DRIVER
Smallest image or OS driver number.
MIN_DEVICE_DRIVER
Smallest OS device driver number.
MAX_DRIVER
Largest image or OS device driver number.
MAX_DEVICE_DRIVER
Largest device driver number.
Driver Return codes
May driver operations return a status code.
DRIVER_OP_SUCCESS
Driver operation was successful
DRIVER_OP_ERROR
Driver operation had an error of some sort
DRIVER_OP_UNSUPPORTED
Operation is not supported for this driver. For example ejecting a
CD from an image driver.
DRIVER_OP_UNINIT
Source is not initialized for this operation.
DRIVER_OP_NOT_PERMITTED
Operation is not permitted
DRIVER_OP_BAD_PARAMETER
An invalid parameter was passed to the routine
DRIVER_OP_BAD_POINTER
A pointer somehow got corrupted.
DRIVER_OP_NO_DRIVER
No driver has been set.
Device Capabilities
Miscellaneous
DRIVE_CAP_ERROR
DRIVE_CAP_UNKNOWN
DRIVE_CAP_MISC_CLOSE_TRAY
DRIVE_CAP_MISC_EJECT
DRIVE_CAP_MISC_LOCK
DRIVE_CAP_MISC_SELECT_SPEED
DRIVE_CAP_MISC_SELECT_DISC
DRIVE_CAP_MISC_MULTI_SESSION
DRIVE_CAP_MISC_MEDIA_CHANGED
DRIVE_CAP_MISC_RESET
DRIVE_CAP_MISC_FILE
Read Capabilities
DRIVE_CAP_READ_AUDIO
DRIVE_CAP_READ_CD_DA
DRIVE_CAP_READ_CD_G
DRIVE_CAP_READ_CD_R
DRIVE_CAP_READ_CD_RW
DRIVE_CAP_READ_DVD_R
DRIVE_CAP_READ_DVD_PR
DRIVE_CAP_READ_DVD_RAM
DRIVE_CAP_READ_DVD_ROM
DRIVE_CAP_READ_DVD_RW
DRIVE_CAP_READ_DVD_RPW
DRIVE_CAP_READ_C2_ERRS
DRIVE_CAP_READ_MODE2_FORM1
DRIVE_CAP_READ_MODE2_FORM2
DRIVE_CAP_READ_MCN
DRIVE_CAP_READ_ISRC
Writing masks
DRIVE_CAP_WRITE_CD_R
DRIVE_CAP_WRITE_CD_RW
DRIVE_CAP_WRITE_DVD_R
DRIVE_CAP_WRITE_DVD_PR
DRIVE_CAP_WRITE_DVD_RAM
DRIVE_CAP_WRITE_DVD_RW
DRIVE_CAP_WRITE_DVD_RPW
DRIVE_CAP_WRITE_MT_RAINIER
DRIVE_CAP_WRITE_BURN_PROOF
Derived Capabilities
DRIVE_CAP_WRITE_CD
Has some sort of CD writer ability
DRIVE_CAP_WRITE_DVD
Has some sort of DVD writer ability
DRIVE_CAP_WRITE
Has some sort of writer ability
Filesystem type constants
These constants are used in getting drive capabilities:
FS_AUDIO
audio only - not really a filesystem
FS_HIGH_SIERRA
High-Sierra Filesystem
FS_ISO_9660
ISO-9660 filesystem
FS_INTERACTIVE
FS_HFS
file system used on the Macintosh system in MacOS 6 through MacOS 9
and deprecated in OSX
FS_UFS
Generic Unix file system derived from the Berkeley fast file
system.
FS_EXT2
EXT2 was the GNU/Linux native filesystem for early kernels. Newer
GNU/Linux OS's may use EXT3 which EXT2 with a journal.
FS_ISO_HFS
both HFS & ISO-9660 filesystem
FS_ISO_9660_INTERACTIVE
both CD-RTOS and ISO filesystem
FS_3DO
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.
FS_XISO
Microsoft X-BOX CD
FS_UDFX
FS_UDF
FS_ISO_UDF
FS_ANAL_XA
eXtended Architecture format
FS_ANAL_MULTISESSION
CD has multisesion
FS_ANAL_PHOTO_CD
Is a Kodak Photo CD
FS_ANAL_HIDDEN_TRACK
Hidden track at the beginning the CD
FS_ANAL_CDTV
FS_ANAL_BOOTABLE
CD is bootable
FS_ANAL_VIDEOCD
VCD 1.1
FS_ANAL_ROCKRIDGE
Has Rock Ridge Extensions to ISO 9660
FS_ANAL_JOLIET
Microsoft Joliet extensions to ISO 9660
FS_ANAL_SVCD
Super VCD or Choiji Video CD
FS_ANAL_CVD
Choiji Video CD
FS_ANAL_XISO
XBOX CD determined by some analysis
FS_MATCH_ALL
bitmask which can be used to specify matching any sort of CD
Sector size constants
CD_FRAMESIZE
CD_FRAMESIZE_RAW
Size of a Philip Red book CD-DA block. It is also the maximum CD
sector size possible: 2352 bytes.
ISO_BLOCKSIZE
Size of an ISO 9660 block. Also the size of the data portion in CD
data reads: 2048 bytes.
M2F2_SECTOR_SIZE
Mode 2 Form 2 Data size: 2328 bytes.
M2RAW_SECTOR_SIZE
Mod1 Form 1 Data size: 2336 bytes.
Reading Modes
READ_MODE_AUDIO
audio mode (CD-DA) read. Blocksize is a multiple of
$perlcdio::CD_FRAMESIZE_RAW (2352) bytes.
READ_MODE_M1F1
Mode 1 Form 1 read. Blocksize is a multiple of
$perlcdio::CD_FRAMESIZE (2048) bytes.
READ_MODE_M1F2
Mode 1 Form 2 read. Blocksize is a multiple of
$perlcdio::M2RAW_SECTIOR_SIZE (2336) bytes.
READ_MODE_M2F1
Mode 2 Form 1 read. Blocksize is a multiple of
$perlcdio::CD_FRAMESIZE (2048) bytes.
READ_MODE_M2F2
Mode 2 Form 1 read. Blocksize is a multiple of (2328) bytes.
Miscellaneous
VERSION_NUM
libcdio version that is getting used
INVALID_LBA
Canonical value used for an invalid LBA.
INVALID_LSN
Canonical value used for an invalid LSN.
INVALID_TRACK
Canonical value used for an invalid track number. (Valid range is 0
to 99.)
LEADOUT_TRACK
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.
METHODS
cdio_version
perlcdio::cdio_version
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 <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/>.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
