.\" 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 "perlcdio 3pm" .TH perlcdio 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" perlcdio \- lower\-level wrapper to libcdio, the CD Input and Control library .SH "SYNOPSIS" .IX Header "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. .PP There are various constants that are defined here. .SH "DESCRIPTION" .IX Header "DESCRIPTION" Encapsulation is done in two parts. The lower-level Perl interface is called perlcdio (this file) and is generated via \s-1SWIG.\s0 .SH "CONSTANTS" .IX Header "CONSTANTS" .SS "Driver \s-1ID\s0's" .IX Subsection "Driver ID's" .IP "\s-1DRIVER_UNKNOWN\s0" 4 .IX Item "DRIVER_UNKNOWN" Use when you don't know what kind of driver and you don't care if it is an \s-1CD\s0 image driver or a real CD-ROM driver. See also \s-1DRIVER_DEVICE\s0 which doesn't include image drivers. .IP "\s-1DRIVER_AIX\s0" 4 .IX Item "DRIVER_AIX" Driver for \s-1IBM\s0's \s-1AIX.\s0 .IP "\s-1DRIVER_BSDI\s0" 4 .IX Item "DRIVER_BSDI" Driver for \s-1BSDI.\s0 .IP "\s-1DRIVER_FREEBSD\s0" 4 .IX Item "DRIVER_FREEBSD" Driver for Free \s-1BSD\s0 .IP "\s-1DRIVER_LINUX\s0" 4 .IX Item "DRIVER_LINUX" Driver for \s-1GNU/LINUX\s0 .IP "\s-1DRIVER_SOLARIS\s0" 4 .IX Item "DRIVER_SOLARIS" Driver for Solaris .IP "\s-1DRIVER_OSX\s0" 4 .IX Item "DRIVER_OSX" Driver for Apple's \s-1OS X.\s0 .IP "\s-1DRIVER_WIN32\s0" 4 .IX Item "DRIVER_WIN32" Driver for Microsoft Windows .IP "\s-1DRIVER_CDRDAO\s0" 4 .IX Item "DRIVER_CDRDAO" Image Driver for cdrdao .IP "\s-1DRIVER_BINCUE\s0" 4 .IX Item "DRIVER_BINCUE" Image driver for CDRWin \s-1BIN/CUE\s0 .IP "\s-1DRIVER_NRG\s0" 4 .IX Item "DRIVER_NRG" Image driver for Nero \s-1NRG\s0 .IP "\s-1DRIVER_DEVICE\s0" 4 .IX Item "DRIVER_DEVICE" Use when you don't know what kind of driver but the driver must be a real CD-ROM driver. See also \s-1DRIVER_UNKNOWN\s0 which includes image drivers. .SS "Driver Return codes" .IX Subsection "Driver Return codes" May driver operations return a status code. .IP "\s-1DRIVER_OP_SUCCESS\s0" 4 .IX Item "DRIVER_OP_SUCCESS" Driver operation was successful .IP "\s-1DRIVER_OP_ERROR\s0" 4 .IX Item "DRIVER_OP_ERROR" Driver operation had an error of some sort .IP "\s-1DRIVER_OP_UNSUPPORTED\s0" 4 .IX Item "DRIVER_OP_UNSUPPORTED" Operation is not supported for this driver. For example ejecting a \s-1CD\s0 from an image driver. .IP "\s-1DRIVER_OP_UNINIT\s0" 4 .IX Item "DRIVER_OP_UNINIT" Source is not initialized for this operation. .IP "\s-1DRIVER_OP_NOT_PERMITTED\s0" 4 .IX Item "DRIVER_OP_NOT_PERMITTED" Operation is not permitted .IP "\s-1DRIVER_OP_BAD_PARAMETER\s0" 4 .IX Item "DRIVER_OP_BAD_PARAMETER" An invalid parameter was passed to the routine .IP "\s-1DRIVER_OP_BAD_POINTER\s0" 4 .IX Item "DRIVER_OP_BAD_POINTER" A pointer somehow got corrupted. .IP "\s-1DRIVER_OP_NO_DRIVER\s0" 4 .IX Item "DRIVER_OP_NO_DRIVER" No driver has been set. .SS "Device Capabilities" .IX Subsection "Device Capabilities" \fIMiscellaneous\fR .IX Subsection "Miscellaneous" .IP "\s-1DRIVE_CAP_ERROR\s0" 4 .IX Item "DRIVE_CAP_ERROR" .PD 0 .IP "\s-1DRIVE_CAP_UNKNOWN\s0" 4 .IX Item "DRIVE_CAP_UNKNOWN" .IP "\s-1DRIVE_CAP_MISC_CLOSE_TRAY\s0" 4 .IX Item "DRIVE_CAP_MISC_CLOSE_TRAY" .IP "\s-1DRIVE_CAP_MISC_EJECT\s0" 4 .IX Item "DRIVE_CAP_MISC_EJECT" .IP "\s-1DRIVE_CAP_MISC_LOCK\s0" 4 .IX Item "DRIVE_CAP_MISC_LOCK" .IP "\s-1DRIVE_CAP_MISC_SELECT_SPEED\s0" 4 .IX Item "DRIVE_CAP_MISC_SELECT_SPEED" .IP "\s-1DRIVE_CAP_MISC_SELECT_DISC\s0" 4 .IX Item "DRIVE_CAP_MISC_SELECT_DISC" .IP "\s-1DRIVE_CAP_MISC_MULTI_SESSION\s0" 4 .IX Item "DRIVE_CAP_MISC_MULTI_SESSION" .IP "\s-1DRIVE_CAP_MISC_MEDIA_CHANGED\s0" 4 .IX Item "DRIVE_CAP_MISC_MEDIA_CHANGED" .IP "\s-1DRIVE_CAP_MISC_RESET\s0" 4 .IX Item "DRIVE_CAP_MISC_RESET" .IP "\s-1DRIVE_CAP_MISC_FILE\s0" 4 .IX Item "DRIVE_CAP_MISC_FILE" .PD .PP \fIRead Capabilities\fR .IX Subsection "Read Capabilities" .IP "\s-1DRIVE_CAP_READ_AUDIO\s0" 4 .IX Item "DRIVE_CAP_READ_AUDIO" .PD 0 .IP "\s-1DRIVE_CAP_READ_CD_DA\s0" 4 .IX Item "DRIVE_CAP_READ_CD_DA" .IP "\s-1DRIVE_CAP_READ_CD_G\s0" 4 .IX Item "DRIVE_CAP_READ_CD_G" .IP "\s-1DRIVE_CAP_READ_CD_R\s0" 4 .IX Item "DRIVE_CAP_READ_CD_R" .IP "\s-1DRIVE_CAP_READ_CD_RW\s0" 4 .IX Item "DRIVE_CAP_READ_CD_RW" .IP "\s-1DRIVE_CAP_READ_DVD_R\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_R" .IP "\s-1DRIVE_CAP_READ_DVD_PR\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_PR" .IP "\s-1DRIVE_CAP_READ_DVD_RAM\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_RAM" .IP "\s-1DRIVE_CAP_READ_DVD_ROM\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_ROM" .IP "\s-1DRIVE_CAP_READ_DVD_RW\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_RW" .IP "\s-1DRIVE_CAP_READ_DVD_RPW\s0" 4 .IX Item "DRIVE_CAP_READ_DVD_RPW" .IP "\s-1DRIVE_CAP_READ_C2_ERRS\s0" 4 .IX Item "DRIVE_CAP_READ_C2_ERRS" .IP "\s-1DRIVE_CAP_READ_MODE2_FORM1\s0" 4 .IX Item "DRIVE_CAP_READ_MODE2_FORM1" .IP "\s-1DRIVE_CAP_READ_MODE2_FORM2\s0" 4 .IX Item "DRIVE_CAP_READ_MODE2_FORM2" .IP "\s-1DRIVE_CAP_READ_MCN\s0" 4 .IX Item "DRIVE_CAP_READ_MCN" .IP "\s-1DRIVE_CAP_READ_ISRC\s0" 4 .IX Item "DRIVE_CAP_READ_ISRC" .PD .SS "Writing masks" .IX Subsection "Writing masks" .IP "\s-1DRIVE_CAP_WRITE_CD_R\s0" 4 .IX Item "DRIVE_CAP_WRITE_CD_R" .PD 0 .IP "\s-1DRIVE_CAP_WRITE_CD_RW\s0" 4 .IX Item "DRIVE_CAP_WRITE_CD_RW" .IP "\s-1DRIVE_CAP_WRITE_DVD_R\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD_R" .IP "\s-1DRIVE_CAP_WRITE_DVD_PR\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD_PR" .IP "\s-1DRIVE_CAP_WRITE_DVD_RAM\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD_RAM" .IP "\s-1DRIVE_CAP_WRITE_DVD_RW\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD_RW" .IP "\s-1DRIVE_CAP_WRITE_DVD_RPW\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD_RPW" .IP "\s-1DRIVE_CAP_WRITE_MT_RAINIER\s0" 4 .IX Item "DRIVE_CAP_WRITE_MT_RAINIER" .IP "\s-1DRIVE_CAP_WRITE_BURN_PROOF\s0" 4 .IX Item "DRIVE_CAP_WRITE_BURN_PROOF" .PD .PP \fIDerived Capabilities\fR .IX Subsection "Derived Capabilities" .IP "\s-1DRIVE_CAP_WRITE_CD\s0" 4 .IX Item "DRIVE_CAP_WRITE_CD" Has some sort of \s-1CD\s0 writer ability .IP "\s-1DRIVE_CAP_WRITE_DVD\s0" 4 .IX Item "DRIVE_CAP_WRITE_DVD" Has some sort of \s-1DVD\s0 writer ability .IP "\s-1DRIVE_CAP_WRITE\s0" 4 .IX Item "DRIVE_CAP_WRITE" Has some sort of writer ability .SS "Filesystem type constants" .IX Subsection "Filesystem type constants" These constants are used in getting drive capabilities: .IP "\s-1FS_AUDIO\s0" 4 .IX Item "FS_AUDIO" audio only \- not really a filesystem .IP "\s-1FS_HIGH_SIERRA\s0" 4 .IX Item "FS_HIGH_SIERRA" High-Sierra Filesystem .IP "\s-1FS_ISO_9660\s0" 4 .IX Item "FS_ISO_9660" \&\s-1ISO\-9660\s0 filesystem .IP "\s-1FS_INTERACTIVE\s0" 4 .IX Item "FS_INTERACTIVE" .PD 0 .IP "\s-1FS_HFS\s0" 4 .IX Item "FS_HFS" .PD file system used on the Macintosh system in MacOS 6 through MacOS 9 and deprecated in \s-1OSX\s0 .IP "\s-1FS_UFS\s0" 4 .IX Item "FS_UFS" Generic Unix file system derived from the Berkeley fast file system. .IP "\s-1FS_EXT2\s0" 4 .IX Item "FS_EXT2" \&\s-1EXT2\s0 was the GNU/Linux native filesystem for early kernels. Newer GNU/Linux \s-1OS\s0's may use \s-1EXT3\s0 which \s-1EXT2\s0 with a journal. .IP "\s-1FS_ISO_HFS\s0" 4 .IX Item "FS_ISO_HFS" both \s-1HFS & ISO\-9660\s0 filesystem .IP "\s-1FS_ISO_9660_INTERACTIVE\s0" 4 .IX Item "FS_ISO_9660_INTERACTIVE" both CD-RTOS and \s-1ISO\s0 filesystem .IP "\s-1FS_3DO\s0" 4 .IX Item "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. .IP "\s-1FS_XISO\s0" 4 .IX Item "FS_XISO" Microsoft X\-BOX \s-1CD\s0 .IP "\s-1FS_UDFX\s0" 4 .IX Item "FS_UDFX" .PD 0 .IP "\s-1FS_UDF\s0" 4 .IX Item "FS_UDF" .IP "\s-1FS_ISO_UDF\s0" 4 .IX Item "FS_ISO_UDF" .IP "\s-1FS_ANAL_XA\s0" 4 .IX Item "FS_ANAL_XA" .PD eXtended Architecture format .IP "\s-1FS_ANAL_MULTISESSION\s0" 4 .IX Item "FS_ANAL_MULTISESSION" \&\s-1CD\s0 has multisesion .IP "\s-1FS_ANAL_PHOTO_CD\s0" 4 .IX Item "FS_ANAL_PHOTO_CD" Is a Kodak Photo \s-1CD\s0 .IP "\s-1FS_ANAL_HIDDEN_TRACK\s0" 4 .IX Item "FS_ANAL_HIDDEN_TRACK" Hidden track at the beginning the \s-1CD\s0 .IP "\s-1FS_ANAL_CDTV\s0" 4 .IX Item "FS_ANAL_CDTV" .PD 0 .IP "\s-1FS_ANAL_BOOTABLE\s0" 4 .IX Item "FS_ANAL_BOOTABLE" .PD \&\s-1CD\s0 is bootable .IP "\s-1FS_ANAL_VIDEOCD\s0" 4 .IX Item "FS_ANAL_VIDEOCD" \&\s-1VCD 1.1\s0 .IP "\s-1FS_ANAL_ROCKRIDGE\s0" 4 .IX Item "FS_ANAL_ROCKRIDGE" Has Rock Ridge Extensions to \s-1ISO 9660\s0 .IP "\s-1FS_ANAL_JOLIET\s0" 4 .IX Item "FS_ANAL_JOLIET" Microsoft Joliet extensions to \s-1ISO 9660\s0 .IP "\s-1FS_ANAL_SVCD\s0" 4 .IX Item "FS_ANAL_SVCD" Super \s-1VCD\s0 or Choiji Video \s-1CD\s0 .IP "\s-1FS_ANAL_CVD\s0" 4 .IX Item "FS_ANAL_CVD" Choiji Video \s-1CD\s0 .IP "\s-1FS_ANAL_XISO\s0" 4 .IX Item "FS_ANAL_XISO" \&\s-1XBOX CD\s0 determined by some analysis .IP "\s-1FS_MATCH_ALL\s0" 4 .IX Item "FS_MATCH_ALL" bitmask which can be used to specify matching any sort of \s-1CD\s0 .SS "Sector size constants" .IX Subsection "Sector size constants" .IP "\s-1CD_FRAMESIZE\s0" 4 .IX Item "CD_FRAMESIZE" .PD 0 .IP "\s-1CD_FRAMESIZE_RAW\s0" 4 .IX Item "CD_FRAMESIZE_RAW" .PD Size of a Philip Red book CD-DA block. It is also the maximum \s-1CD\s0 sector size possible: 2352 bytes. .IP "\s-1ISO_BLOCKSIZE\s0" 4 .IX Item "ISO_BLOCKSIZE" Size of an \s-1ISO 9660\s0 block. Also the size of the data portion in \s-1CD\s0 data reads: 2048 bytes. .IP "M2F2_SECTOR_SIZE" 4 .IX Item "M2F2_SECTOR_SIZE" Mode 2 Form 2 Data size: 2328 bytes. .IP "M2RAW_SECTOR_SIZE" 4 .IX Item "M2RAW_SECTOR_SIZE" Mod1 Form 1 Data size: 2336 bytes. .SS "Reading Modes" .IX Subsection "Reading Modes" .IP "\s-1READ_MODE_AUDIO\s0" 4 .IX Item "READ_MODE_AUDIO" audio mode (CD-DA) read. Blocksize is a multiple of \&\f(CW$perlcdio::CD_FRAMESIZE_RAW\fR (2352) bytes. .IP "\s-1READ_MODE_M1F1\s0" 4 .IX Item "READ_MODE_M1F1" Mode 1 Form 1 read. Blocksize is a multiple of \f(CW$perlcdio::CD_FRAMESIZE\fR (2048) bytes. .IP "\s-1READ_MODE_M1F2\s0" 4 .IX Item "READ_MODE_M1F2" Mode 1 Form 2 read. Blocksize is a multiple of \f(CW$perlcdio::M2RAW_SECTIOR_SIZE\fR (2336) bytes. .IP "\s-1READ_MODE_M2F1\s0" 4 .IX Item "READ_MODE_M2F1" Mode 2 Form 1 read. Blocksize is a multiple of \f(CW$perlcdio::CD_FRAMESIZE\fR (2048) bytes. .IP "\s-1READ_MODE_M2F2\s0" 4 .IX Item "READ_MODE_M2F2" Mode 2 Form 1 read. Blocksize is a multiple of (2328) bytes. .SS "Miscellaneous" .IX Subsection "Miscellaneous" .IP "\s-1VERSION_NUM\s0" 4 .IX Item "VERSION_NUM" libcdio version that is getting used .IP "\s-1INVALID_LBA\s0" 4 .IX Item "INVALID_LBA" Canonical value used for an invalid \s-1LBA.\s0 .IP "\s-1INVALID_LSN\s0" 4 .IX Item "INVALID_LSN" Canonical value used for an invalid \s-1LSN.\s0 .IP "\s-1INVALID_TRACK\s0" 4 .IX Item "INVALID_TRACK" Canonical value used for an invalid track number. (Valid range is 0 to 99.) .IP "\s-1LEADOUT_TRACK\s0" 4 .IX Item "LEADOUT_TRACK" Canonical value for the \*(L"leadout\*(R" 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 \s-1LSN\s0 or \s-1LBA.\s0 The libcdio routines also allow the last actual track plus one as a synonym for the leadout track. .SH "METHODS" .IX Header "METHODS" .SS "cdio_version" .IX Subsection "cdio_version" .Vb 1 \& perlcdio::cdio_version .Ve .PP Returns the libcdio version string Device::Cdio is currently linked with. .SS "this" .IX Subsection "this" This seems to be an artifact of \s-1SWIG.\s0 .SH "SEE ALSO" .IX Header "SEE ALSO" has documentation on libcdio including the a manual and the \s-1API\s0 via doxygen. .SH "AUTHORS" .IX Header "AUTHORS" Rocky Bernstein \f(CW\*(C`\*(C'\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2006, 2008, 2011 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 .