Manual Pages for UNIX Darwin command on man drutil

DRUTIL(1) BSD General Commands Manual DRUTIL(1)

NAME

ddrruuttiill - interact with CD/DVD burners

SYNOPSIS

ddrruuttiill verb [options]

DESCRIPTION

ddrruuttiill uses the DiscRecording framework to interact with attached burning devices. Common verbs include bbuurrnn, eerraassee, eejjeecctt, hheellpp, iinnffoo, lliisstt, ssttaattuuss, and ttrraayy. The rest of the verbs are: bbuullkkeerraassee, ccddtteexxtt, ddiisscciinnffoo, dduummppiissoo, dduummppuuddff, ffiilleennaammee, ggeettccoonnffiigg, ppoollll, ssiizzee, ssuubbcchhaannnneell, ttrraacckkiinnffoo, and vveerrssiioonn. VVEERRBBSS Each verb is listed with its description and individual arguments. Drive selection arguments must appear before individual arguments. Drive

selection and argument descriptions can be found after the verb descrip-

tions in the Drive Selection Criteria section.

-ddrriivvee drive(s)

Lets you specify a drive or drives, per the output of lliisstt, for those verbs that can operate on one or more drives. See the Drive Selection Criterion section for more info. hheellpp verb Display the usage information for the specified verb. aattiipp

Displays the Absolute Time in Pre-Groove (ATIP) for inserted

CD-R/RW media.

bbuullkkeerraassee type Starts bulk erase mode, in which the drive will continually

erase inserted -RW media, eject it, and prompt for another

disc until terminated. Types of erase: qquuiicckk Performs a quick erase, doing the minimal amount of work to make the disc appear blank. This operation typically takes only a minute or two. ffuullll Performs a complete erase, erasing every block on the

disk. This operation is slow (on the order of 30 min-

utes) to complete. bbuurrnn options path Burns a valid directory or image file to disc. The default is to burn the specified directory to a new filesystem. The

-aauuddiioo option creates an audio CD (redbook) in which any valid

QuickTime audio file present in the path is converted to a track (in alphabetical order). If a file is specified (valid image files only: .dmg, .iso, .cue/bin, and .toc) the contents

of the image file are burned. Pre-burn and post-burn options,

and filesystem exclusions can be specificed for enhanced func-

tionality. Last option takes precedence. Invalid commands are ignored. path A valid path to a directory or file.

options Specify an arbitrary valid burn option(s): -tteesstt,

-aappppeennddaabbllee, -eerraassee, -mmoouunntt, -nnoovveerriiffyy, -nnoohhffsspplluuss,

-nnooiissoo99666600, -nnoojjoolliieett, -nnoouuddff, -nnooffss, -aauuddiioo, -ssppeeeedd,

-pprreeggaapp. Or specify a default burn option: -nnootteesstt,

-nnooaappppeennddaabbllee, -nnooeerraassee, -aallllffss, -hhffsspplluuss, -iissoo99666600,

-jjoolliieett, -uuddff, -ddaattaa, -eejjeecctt, -vveerriiffyy.

ccddtteexxtt

Reads and displays any CD-Text information reported by the

drive. The drive must contain an audio CD, and be capable of

reading CD-Text.

ddiisscciinnffoo [-xml]

Displays detailed information about present media. From the MMC command of the same name. dduummppiissoo device block [format]

Tool to inspect and interpret ISO-9660 and Joliet structures

on the media. device Disk node, e.g. /dev/disk1, /dev/disk1s1, /dev/rdisk1. block Block number to dump (in decimal or 0x hex notation).

Blocks are assumed to be 2048-byte blocks.

format How to interpret the block. If format is not speci-

fied, dumpiso will attempt to guess. If present, this argument should be one of the following: NNoonnee, BBoooott, BBoooottCCaatt, PPVVDD, SSVVDD, VVPPDD, VVDDSSTT, MMPPaatthh, LLPPaatthh, DDiirr, HHFFSSPPlluussVVHH. dduummppuuddff device block Tool to inspect and interpret UDF structures on the media. device Disk node, e.g. /dev/disk1, /dev/disk1s1, /dev/rdisk1. block Block number to dump (in decimal or 0x hex notation).

Blocks are assumed to be 2048-byte blocks.

eejjeecctt Synonym for ddrruuttiill ttrraayy eejjeecctt. eerraassee type

Erases -RW media in the drive(s) and ejects it.

Types of erase: qquuiicckk Performs a quick erase, doing the minimal amount of work to make the disc appear blank. This operation typically takes only a minute or two. ffuullll Performs a complete erase, erasing every block on the

disk. This operation is slow (on the order of 30 min-

utes) to complete. ffiilleennaammee name Shows how the specified filename will be modified to comply with the naming rules of the filesystems that DiscRecording generates. ggeettccoonnffiigg type Displays device feature and profile list. Types of config information: ccuurrrreenntt Displays current features and profiles for a drive. ssuuppppoorrtteedd Displays all supported features and profiles for a drive.

iinnffoo [-xml]

Displays various pieces of information for each drive, includ-

ing how it's connected to the computer and a summary of capa-

bilities.

lliisstt [-xml]

Lists all burning devices connected to the machine. ppoollll Displays device and media notifications until terminated. ssiizzee options path Estimates the size of a valid directory or image file (in blocks). The default is to estimate the size of the specified

path as a hybrid filesystem. The -aauuddiioo option calculates the

contents of the directory as an audio CD (redbook) (for appli-

cable files). If a file is specified (valid image files only: .dmg, .iso, .cue/bin, and .toc) the contents of the image file will be calculated. Filesystem exclusions can be specificed for enhanced functionality. Calculated size will be compared

against blank media that is found unless the -nnooddrriivvee argument

is specified. Last option takes precedence. Invalid commands are ignored. path A valid path to a directory or file.

options Specify an arbitrary valid burn option(s): -nnooddrriivvee,

-nnoohhffsspplluuss, -nnooiissoo99666600, -nnoojjoolliieett, -nnoouuddff, -nnooffss,

-aauuddiioo, -pprreeggaapp. Or specify a default burn option:

-aallllffss, -hhffsspplluuss, -iissoo99666600, -jjoolliieett, -uuddff, -ddaattaa.

ssttaattuuss [-xml]

Displays detailed media-specific information.

ssuubbcchhaannnneell Displays information from the subchannels on CD media. This prints the MCN (media catalog number) for the disc, and the ISRC (international standard recording code) for all tracks. This command only works when CD media is present. From the MMC command of the same name. ttoocc Displays table of contents (TOC) of inserted media.

ttrraacckkiinnffoo [-xml]

Displays detailed information about all tracks present on the media. From the MMC command of the same name. ttrraayy command Performs a tray/media related command. Note that some drives do not have trays, and some have trays but may lack motorized eject or inject capability. Tray commands: ooppeenn Opens a drive's tray, if no media is present and the drive has a tray capable of motorized eject.

cclloossee Closes a drive's tray, if the drive has a tray capa-

ble of motorized inject. eejjeecctt Ejects media from the drive, if the drive has a tray capable of motorized eject. If no media is present, this is equivalent to ooppeenn. If media is present and can be unmounted, it will be unmounted and then ejected. If media is present but cannot be unmounted, the eject will fail. vveerrssiioonn Displays operating system and DiscRecording framework version numbers. OOPPTTIIOONNSS

-xxmmll

When specified (valid options only: ddiisscciinnffoo, iinnffoo, lliisstt, ssttaattuuss, aanndd ttrraacckkiinnffoo) the output for the specified verb will be shown in xml format. DDRRIIVVEE SSEELLEECCTTIIOONN CCRRIITTEERRIIAA Some functions of ddrruuttiill operate on a specific drive. Since any number of drives may be available, and they may come and go at any time, the device selection arguments provide a method for selecting among them. The candidate list starts out as a list of all attached drives. One or

more arguments of the form -ddrriivvee drive(s) may be specified. Each argu-

ment has the effect of narrowing the candidate list, depending on what drive(s) is. It may be:

++oo A positive decimal number, assumed to be a 1-based index

into the candidate list. The candidate list is trimmed to just that device. ++oo One of the following keywords: iinntteerrnnaall, eexxtteerrnnaall, uussbb, ffiirreewwiirree, aattaappii, ssccssii. The candidate list is trimmed to devices which match the specified location / bus. Case is ignored in this comparison. ++oo Any other string, assumed to be a vendor/product name. The candidate list is trimmed to devices whose vendor or product

strings exactly match the argument. Case (but not white-

space) is ignored in this comparison.

Multiple -ddrriivvee arguments may be specified; each argument narrows the

candidate list further. After all the -ddrriivvee arguments have been pro-

cessed, the candidate list is considered. If it contains exactly one item, that drive is used. If it contains zero items, ddrruuttiill prints an error message and exits. If it contains more than one item, the selected function is executed on all drives remaining in the list. EEXXAAMMPPLLEESS Simple verbs with no drive commands

drutil help status

Displays help for the verb "status".

drutil list

Displays a list of attached devices.

drutil info

Displays miscellaneous information for all attached devices.

drutil status

Displays media-specific information for all attached devices.

drutil -drive inernal burn -noverify -eject -speed 24 ~/Documents

Burns the Documents directory to the internal drive without verifying, then ejects the disc.

drutil -drive internal info -xml > driveInfo.xml

Creates a XML file containing info about internal drives. Examples of drive selection

drutil -drive 1 tray close

Closes the tray of the first burning device seen, if possible.

drutil -drive external info

Lists drive specific information for all externally connected burning devices.

drutil -drive firewire status

Lists media specific information for media present in attached firewire burning devices.

drutil -drive VENDOR tray open

Opens the tray of all burning devices whose vendor id is VENDOR, if possible.

drutil -drive 'CD-RW CDW827ES' getconfig supported

Lists supported features and profiles for attached devices

whose product id is 'CD-RW CDW827ES'.

HISTORY ddrruuttiill first appeared in MacOS X 10.3.