OS Manuals

/usr/bin/cdrskin

Library for reading, mastering and writing optical discs

From libburn 1.5.8-r2 (os), captured 2026-11-05 by running cdrskin --help (exit 0). permalink

cdrskin 1.5.8 : limited cdrecord compatibility wrapper for libburn

Usage: /usr/bin/cdrskin [options|source_addresses]
Burns preformatted data to CD or DVD via libburn.
For the cdrecord compatible options which control the work of
blanking and burning see output of option -help rather than --help.
Non-cdrecord options:
 --abort_handler    do not leave the drive in busy state
 --adjust_speed_to_drive  set only speeds offered by drive and media
 --allow_emulated_drives  dev=stdio:<path> on file objects
 --allow_setuid     disable setuid warning (setuid is insecure !)
 --allow_untested_media   enable implemented untested media types
 --any_track        allow source_addresses to match '^-.' or '='
 assert_write_lba=<lba>  abort if not next write address == lba
 --audio_not_raw    refuse to burn audio files of unrecognized format
 cd_start_tno=<number>  set number of first track in CD SAO session
 --cdtext_dummy     show CD-TEXT pack array instead of writing CD
 cdtext_to_textfile=<path>  extract CD-TEXT from CD to disk file
 cdtext_to_v07t=<path|"-">  report CD-TEXT from CD to file or stdout
 --cdtext_verbose   show CD-TEXT pack array before writing CD
 direct_write_amount=<size>  write random access to media like DVD+RW
 --demand_a_drive   exit !=0 on bus scans with empty result
 --devices          list accessible devices (tells /dev/...)
 --device_links     list accessible devices by (udev) links
 dev_translation=<sep><from><sep><to>   set input address alias
                    e.g.: dev_translation=+ATA:1,0,0+/dev/sg1
 --drive_abort_on_busy  abort process if busy drive is found
                    (might be triggered by a busy hard disk)
 --drive_blocking   try to wait for busy drive to become free
                    (might be stalled by a busy hard disk)
 --drive_f_setlk    obtain exclusive lock via fcntl.
 --drive_not_exclusive  combined not_o_excl and not_f_setlk.
 --drive_not_f_setlk  do not obtain exclusive lock via fcntl.
 --drive_not_o_excl   do not ask kernel to prevent opening
                    busy drives. Effect is kernel dependent.
 drive_scsi_dev_family=<sr|scd|sg|default> select Linux device
                    file family to be used for (pseudo-)SCSI.
 --drive_scsi_exclusive  try to exclusively reserve device files
                    /dev/srN, /dev/scdM, /dev/stK of drive.
 dvd_obs="default"|number
                    set number of bytes per DVD/BD write: 32k or 64k
 extract_audio_to=<dir>
                    Copy all tracks of an audio CD as separate
                    .WAV files <dir>/track<NN>.wav to hard disk
 extract_basename=<name>
                    Compose track files as <dir>/<name><NN>.wav
 --extract_dap      Enable flaw obscuring mechanisms for audio reading
 extract_tracks=<number[,number[,...]]>
                    Restrict extract_audio_to= to list of tracks.
 fallback_program=<cmd>  use external program for exotic CD jobs.
 --fifo_disable     disable fifo despite any fs=...
 --fifo_per_track   use a separate fifo for each track
 fifo_start_at=<number> do not wait for full fifo but start burning
                    as soon as the given number of bytes is read
 --fill_up_media    cause the last track to have maximum size
 --four_channel     indicate that audio tracks have 4 channels
 grab_drive_and_wait=<num>  grab drive, wait given number of
                    seconds, release drive, and do normal work
 --grow_overwriteable_iso  emulate multi-session on media like DVD+RW
 --ignore_signals   try to ignore any signals rather than to abort
 input_sheet_v07t=<path>  read a Sony CD-TEXT definition file
 --list_formats     list format descriptors for loaded media.
 --list_ignored_options list all ignored cdrecord options.
 --list_speeds      list speed descriptors for loaded media.
 --list_features    list SCSI features reported by the drive
 --long_toc         print overview of media content
 modesty_on_drive=<options> no writing into full drive buffer
 --no_abort_handler  exit even if the drive is in busy state
 --no_blank_appendable  refuse to blank appendable CD-RW
 --no_convert_fs_adr  only literal translations of dev=
 --no_load          do not try to load the drive tray
 --no_rc            as first argument: do not read startup files
 --obs_pad          pad DVD DAO to full 16 or 32 blocks
 --bdr_obs_exempt   possibly exempt BD-R from padding to full 64k
 --old_pseudo_scsi_adr  use and report literal Bus,Target,Lun
                    rather than real SCSI and pseudo ATA.
 --pacifier_with_newline  do not overwrite pacifier line by next one.
 --prodvd_cli_compatible  react on some DVD types more like
                    cdrecord-ProDVD with blank= and -multi
 --perform_opc      perform Optimum Power Calibration
 --perform_opc_growisofs  perform Optimum Power Calibration only
                    with DVD-R and unformatted DVD-RW and only if
                    the drive offers no OPC table entries
 sao_postgap="off"|number
                    defines whether the next track will get a
                    post-gap and how many sectors it shall have
 sao_pregap="off"|number
                    defines whether the next track will get a
                    pre-gap and how many sectors it shall have
 --single_track     accept only last argument as source_address
 stream_recording="on"|"off"|number
                    "on" requests to prefer speed over write
                    error management. A number prevents this with
                    byte addresses below that number.
 stdio_sync="default"|"off"|number
                    set number of bytes after which to force output
                    to drives with prefix "stdio:".
 tao_to_sao_tsize=<num>  use num as fixed track size if in a
                    non-TAO mode track data are read from "-"
                    and no tsize= was specified.
 --tell_media_space  print maximum number of writeable data blocks
 textfile_to_v07t=file_path
                    print CD-TEXT file in Sony format and exit.
 --two_channel      indicate that audio tracks have 2 channels
 use_immed_bit=on|off|default  real control over SCSI Immed bit
 write_start_address=<num>  write to given byte address (DVD+RW)
 --xa1-ignore       with -xa1 do not strip 8 byte headers
 -xamix             DO NOT USE (Dummy announcement to make K3B use -xa)
Preconfigured arguments are read from the following startup files
if they exist and are readable. The sequence is as listed here:
  /etc/default/cdrskin         /etc/opt/cdrskin/rc
  /etc/cdrskin/cdrskin.conf    $HOME/.cdrskinrc
Each file line is a single argument. No whitespace.
By default any argument that does not match grep '^-.' or '=' is
used as track source. If it is "-" then stdin is used.
cdrskin  : http://scdbackup.sourceforge.net/cdrskin_eng.html
           mailto:scdbackup@gmx.net  (Thomas Schmitt)
libburn  : http://libburnia-project.org
cdrecord : ftp://ftp.berlios.de/pub/cdrecord/
My respect to the authors of cdrecord and libburn.
scdbackup: http://scdbackup.sourceforge.net/main_eng.html
Options (85)
OptionDescriptionSource
--abort_handlerEstablish default signal handling not to leave a drive in busy state but rather to shut it down and to wait until it has ended the final operations.help + man
--adjust_speed_to_driveCurb explicitly given speed= values to the maximum which is announced by the drive for the loaded media.help + man
--allow_emulated_drivesEnable drive addresses of the form dev=stdio:<path>.help + man
--allow_setuidDisable the loud warning about insecure discrepance between login user and effective user which indicates application of chmod u+s to the program binary.help + man
--allow_untested_mediaEnable the use of media profiles which have been implemented but not yet tested.help + man
--any_trackAllow source_addresses to begin with "-" (plus further characters) or to contain a "=" character.help + man
--audio_not_rawDemand that all audio track sources are recognizable MS-WAVE or SUN Audio files with suitable parameters.help + man
--cdtext_dummyPrepare a burn run, report the effective array of CD-TEXT packs to stdout, and then end the program run without starting to burn the session.help + man
--cdtext_verboseLike --cdtext_dummy but without preventing the burn run.help + man
--demand_a_driveExit with a nonzero value if no drive can be found during a bus scan.help + man
--devicesList the device file addresses of all accessible CD drives.help + man
--device_linksLike --devices, but presenting the drives with addresses of symbolic links which point to the actual device files.help + man
--drive_abort_on_busyabort process if busy drive is found (might be triggered by a busy hard disk)help + man
--drive_blockingtry to wait for busy drive to become free (might be stalled by a busy hard disk)help + man
--drive_f_setlkLinux specific: Try to get exclusive lock on drive device file via fcntl(2).help + man
--drive_not_exclusiveLinux specific: Combine --drive_not_f_setlk and --drive_not_o_excl.help + man
--drive_not_f_setlkLinux specific: Do not try to get exclusive lock on drive device file via fcntl(2).help + man
--drive_not_o_exclLinux specific: Do not ask the operating system to prevent opening busy drives.help + man
--drive_scsi_exclusiveLinux specific: Try to exclusively reserve device files /dev/srN, /dev/scdM, /dev/sgK of drives.help + man
--extract_dapEnable Digital Audio Play flaw obscuring mechanisms like audio data mute and interpolate.help + man
--fifo_disabledisable fifo despite any fs=...help + man
--fifo_per_trackUse a separate fifo for each track.help + man
--fill_up_mediaExpand the last track of the session to occupy all remaining free space on the media.help + man
--four_channelIndicate for subsequent tracks that they were mastered with four channels.help + man
--grow_overwriteable_isoEnable emulation of multi-session writing on overwriteable media which contain an ISO-9660 filesystem.help + man
--ignore_signalsTry to ignore any signals rather than to abort the program.help + man
--list_formatsList the available format descriptors as reported by the drive for the loaded media.help + man
--list_speedsPut out a list of speed values as reported by the output drive with the loaded medium.help + man
--list_featuresList the SCSI/MMC features which were obtained from the drive when it was last acquired or re-assessed.help + man
--long_tocLike option -toc but marking each session start by a line "first: X last: Y" and each session end by "track:lout ...".help + man
--no_abort_handlerOn signals exit even if the drive is in busy state.help + man
--no_blank_appendableRefuse to blank appendable CD-RW or DVD-RW.help + man
--no_convert_fs_adrDo only literal translations of dev=.help + man
--no_loadWhen aquiring the optical drive, do not try to load its tray.help + man
--no_rcOnly if used as first command line argument this option prevents reading and interpretation of eventual startup files.help + man
--obs_padPad the data of the last write operation of a DVD-R[W] DAO session, or BD-R session, or stdio: pseudo-drive session up to the full size of an output chunk.help + man
--bdr_obs_exemptExempt BD-R media from automatic unconditional transaction end padding, provided that this padding is not requested by --obs_pad and that no stream_recording is requested.help + man
--old_pseudo_scsi_adrLinux specific: Use and report literal Bus,Target,Lun addresses rather than real SCSI and pseudo ATA addresses.help + man
--pacifier_with_newlineAdds a newline character to each pacifier line that would elsewise be overwritten by the next pacifier line.help + man
--prodvd_cli_compatibleActivates behavior modifications with some DVD situations which bring cdrskin nearer to the behavior of cdrecord-ProDVD: Option -multi with unsuitable media is not an error but simply has no effect.help + man
--perform_opcOrder the drive to perform Optimum Power Calibration (OPC) before writing begins.help + man
--perform_opc_growisofsOrder the drive to perform Optimum Power Calibration before writing begins, but only with DVD-R and unformatted DVD-RW and only if the drive offers no OPC table entries.help + man
--single_trackAccept only the last argument of the command line as track source address.help + man
--tell_media_spacePrepare a recording session, do not perform it but rather inquire the maximum number of 2048 byte data blocks which may be written in the current state of media with the prepared setup.help + man
--two_channelIndicate for subsequent tracks that they were mastered with two channels.help + man
--xa1-ignoreSilently interpret option -xa1 as -data.help + man
-xamixDO NOT USE (Dummy announcement to make K3B use -xa)help
--helpShow non-cdrecord compatible options. (in the manual page but not in --help)man
-helpShow cdrecord compatible options. (in the manual page but not in --help)man
-versionPrint cdrskin id line, compatibility lure line, libburn version, cdrskin version, version timestamp, build timestamp (if available), and then exit. (in the manual page but not in --help)man
-atipRetrieve some info about media state. (in the manual page but not in --help)man
-audioAnnounce that the subsequent tracks are to be burned as audio. (in the manual page but not in --help)man
-checkdriveRetrieve some info about the addressed drive and then exit. (in the manual page but not in --help)man
-copyCreate the subsequent tracks with permission for an unlimited number of copies. (in the manual page but not in --help)man
-daoAlias for option -sao. (in the manual page but not in --help)man
-dataSubsequent tracks are data tracks. (in the manual page but not in --help)man
-xa1Subsequent tracks are data tracks with input suitable for CD-ROM XA mode 2 form 1. (in the manual page but not in --help)man
-dummyTry to perform the drive operations without actually affecting the inserted media. (in the manual page but not in --help)man
-ejectEject the disc after work is done. (in the manual page but not in --help)man
-forceAssume that the user knows better in situations when cdrskin or libburn are refusing because of concerns about drive or media state. (in the manual page but not in --help)man
-formatSame as blank=format_overwrite_full -force but restricted to DVD+RW. (in the manual page but not in --help)man
-immedEquivalent to: modesty_on_drive=1:min_percent=75:max_percent=95 The name of this cdrecord option stems from the "Immed" bit which can make some long running drive commands asynchronous and thus eases… (in the manual page but not in --help)man
-inqPrint the identification of the drive and then exit. (in the manual page but not in --help)man
-isosizeThe next track following this option will try to obtain its source size from the header information out of the first few blocks of the source data. (in the manual page but not in --help)man
-loadLoad the media and exit. (in the manual page but not in --help)man
-lockLike option -load but leave the drive's eject button disabled if there is any media found and not option -eject is given. (in the manual page but not in --help)man
-minfoPrint information about the loaded media. (in the manual page but not in --help)man
-msinfoRetrieve multi-session info for preparing a follow-up session by option -C of programs mkisofs, genisoimage, or xorriso -as mkisofs. (in the manual page but not in --help)man
-multiThis option keeps CD, unformatted DVD-R[W], DVD+R, or BD-R appendable after the current session has been written. (in the manual page but not in --help)man
-nocopyCreate subsequent tracks with permission for a single level of copies. (in the manual page but not in --help)man
-nopadDo not add trailing zeros to the data stream. (in the manual page but not in --help)man
-nopreempIndicate for subsequent tracks that they were mastered without pre-emphasis. (in the manual page but not in --help)man
-padAdd 30 kiB of trailing zeros to each data track. (in the manual page but not in --help)man
-preempIndicate for subsequent tracks that they were mastered with pre-emphasis. (in the manual page but not in --help)man
-saoWrite CD in Session At Once mode or sequential DVD-R[W] in Disc-at-once (DAO) mode. (in the manual page but not in --help)man
-scanbusScan the system for drives. (in the manual page but not in --help)man
-scmsCreate subsequent tracks without permission for being copied. (in the manual page but not in --help)man
-swabAnnounce that the raw audio data source of subsequent tracks is byte swapped versus the expectations of cdrecord. (in the manual page but not in --help)man
-taoWrite CD in Track At Once (TAO) mode, sequential DVD-R[W] in Incremental Streaming mode, or DVD+R[/DL] without traditional -sao restrictions. (in the manual page but not in --help)man
-textEnable writing of CD-TEXT attributes read by option cuefile=. (in the manual page but not in --help)man
-tocPrint the table of content (TOC) which describes the tracks recorded on disc. (in the manual page but not in --help)man
-vIncrement verbosity level by one. (in the manual page but not in --help)man
-VEnable logging of SCSI commands to stderr. (in the manual page but not in --help)man
-waitiWait until input data is available at stdin or EOF occurs at stdin. (in the manual page but not in --help)man
--list_ignored_optionsList all ignored cdrecord options. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.