1This README was written by Dr. Eberhard Heuser-Hofmann
2	vaxinf@chclu.chemie.uni-konstanz.de
3
4If you are looking for a *.zip file instead of the tar archive,
5check this address:
6
7ftp://v36.chemie.uni-konstanz.de/cdrecord_vms/
8
9/*--------------------------------------------------------------------------*/
10Hi,
11
12this is the OpenVMS Version of J.Schilling's cdrecord-program.
13
14There is a command-procedure called build_all.com in the [.cdrecord] subdir,
15that compiles and links the code. The cdrecord-program is been produced in
16[.cdrecord.vms] subdirectory.
17
18Define this program as a symbol via
19
20$ cdrecord:==$disk:[dir]cdrecord.exe
21
22$ cdrecord -help gives an idea about the options, that are possible:
23
24cdrecord -help
25Usage: cdrecord.exe [options] track1...trackn
26Options:
27        -version        print version information and exit
28        dev=target      SCSI target to use as CD/DVD-Recorder
29        gracetime=#     set the grace time before starting to write to #.
30        timeout=#       set the default SCSI command timeout to #.
31        debug=#,-d      Set to # or increment misc debug level
32        kdebug=#,kd=#   do Kernel debugging
33        -verbose,-v     increment general verbose level by one
34        -Verbose,-V     increment SCSI command transport verbose level by one
35        -silent,-s      do not print status of failed SCSI commands
36        driver=name     user supplied driver name, use with extreme care
37        driveropts=opt  a comma separated list of driver specific options
38        -checkdrive     check if a driver for the drive is present
39        -prcap          print drive capabilities for MMC compliant drives
40        -inq            do an inquiry for the drive and exit
41        -scanbus        scan the SCSI bus and exit
42        -reset          reset the SCSI bus with the cdrecorder (if possible)
43        -overburn       allow to write more than the official size of a medium
44        -ignsize        ignore the known size of a medium (may cause problems)
45        -useinfo        use *.inf files to overwrite audio options.
46        speed=#         set speed of drive
47        blank=type      blank a CD-RW disc (see blank=help)
48        -load           load the disk and exit (works only with tray loader)
49        -eject          eject the disk after doing the work
50        -dummy          do everything with laser turned off
51        -msinfo         retrieve multi-session info for mkisofs >= 1.10
52        -toc            retrieve and print TOC/PMA data
53        -atip           retrieve and print ATIP data
54        -multi          generate a TOC that allows multi session
55                        In this case default track type is CD-ROM XA2
56        -fix            fixate a corrupt or unfixated disk (generate a TOC)
57        -nofix          do not fixate disk after writing tracks
58        -waiti          wait until input is available before opening SCSI
59        -immed          Try to use the SCSI IMMED flag with certain long lasting commands
60        -force          force to continue on some errors to allow blanking bad disks
61        -dao            Write disk in SAO mode. This option will be replaced in the future.
62        -raw            Write disk in RAW mode. This option will be replaced in the future.
63        -raw96r         Write disk in RAW/RAW96R mode. This option will be replaced in the future.
64        -raw96p         Write disk in RAW/RAW96P mode. This option will be replaced in the future.
65        -raw16          Write disk in RAW/RAW16 mode. This option will be replaced in the future.
66        tsize=#         Length of valid data in next track
67        padsize=#       Amount of padding for next track
68        pregap=#        Amount of pre-gap sectors before next track
69        defpregap=#     Amount of pre-gap sectors for all but track #1
70        mcn=text        Set the media catalog number for this CD to 'text'
71        isrc=text       Set the ISRC number for the next track to 'text'
72        index=list      Set the index list for the next track to 'list'
73        -text           Write CD-Text from information from *.inf files
74        textfile=name   Set the file with CD-Text data to 'name'
75        -audio          Subsequent tracks are CD-DA audio tracks
76        -data           Subsequent tracks are CD-ROM data mode 1 (default)
77        -mode2          Subsequent tracks are CD-ROM data mode 2
78        -xa1            Subsequent tracks are CD-ROM XA mode 1
79        -xa2            Subsequent tracks are CD-ROM XA mode 2
80        -cdi            Subsequent tracks are CDI tracks
81        -isosize        Use iso9660 file system size for next data track
82        -preemp         Audio tracks are mastered with 50/15 �s preemphasis
83        -nopreemp       Audio tracks are mastered with no preemphasis (default)
84        -copy           Audio tracks have unlimited copy permission
85        -nocopy         Audio tracks may only be copied once for personal use (default)
86        -scms           Audio tracks will not have any copy permission at all
87        -pad            Pad data tracks with 15 zeroed sectors
88                        Pad audio tracks to a multiple of 2352 bytes
89        -nopad          Do not pad data tracks (default)
90        -shorttrack     Subsequent tracks may be non Red Book < 4 seconds if in SAO or RAW mode
91        -noshorttrack   Subsequent tracks must be >= 4 seconds
92        -swab           Audio data source is byte-swapped (little-endian/Intel)
93The type of the first track is used for the toc type.
94Currently only form 1 tracks are supported.
95
96One important point is how the CDR-device is being selected:
97
98dev=i,j,k
99
100where:
101i: 0   1   2   3   4   5   6   7   8   9    ...  32  33
102   dka dkb dkc dkd gka gkb gkc gkd dqa dqb  ...  dqy dqz
103
104j: scsi-id
105k: sub-lun (usually 0)
106
107As an example:
108
109dev=1,5,2 selects dkb502:
110
111An typical example how to put virtual disk data onto a cd-rom is given here:
112
113$ cdrecord -speed 2 dev=0,4,0 dka200:[000000]vda0.dsk
114
115Additional hints:
116
1171. Due to timeout problems use -immed switch for IDE-burners under OpenVMS 7.3
118   or modify the timeout value in the dqdriver source.
119
1202. HP has written a command procedure, that calls cdrecord. You should
121   modify this com-file to activate the cdrecord burnproof option:
122   "driveropts=burnproof".
123
124Be aware that cdrecord has copyright on it.
125
126Eberhard
127
128===============================================================================
129
130Dr. Eberhard Heuser-Hofmann
131Univ. Konstanz
132Fakultaet fuer Chemie
133Universitaets-Strasse 10
134D-78464 Konstanz
135Germany
136Phone: +49-7531-88-2026, FAX: +49-7531-88-3139
137email: vaxinf@chclu.chemie.uni-konstanz.de
138
139===============================================================================
140
141