Imported Upstream version 1.1.11
[platform/upstream/cdrkit.git] / doc / genisoimage / README.session
1 /* @(#)README.session   1.3 99/03/02 eric */
2
3         This release of genisoimage has basic support completed for
4 multiple sessions.  However, we still need some interaction 
5 between wodim and genisoimage for this to work correctly. This is needed as
6 only wodim knows the different ways to gather these numbers for all 
7 different drives. It may be that future versions of genisoimage will include 
8 the needed support for MMC compliant drives.
9
10         There are a few new options to genisoimage to allow for this.
11 The first one is "-M /dev/scd0", and is used so that genisoimage can examine
12 the entirety of the previous image so that it can figure out what additional
13 files need to be written in the new session. Note that there are operating
14 systems that don't allow to read from CD drives with a sector size
15 of 2048 bytes per sector. To use genisoimage on such an operating system, you
16 will need a version of genisoimage that includes the SCSI transport library 
17 from wodim. Simply use the dev= syntax from wodim with -M in
18 such a case. It will tell genisoimage to use the SCSI transport library to 
19 read from the CD instead of using the standard read() OS interface.
20
21         There is also a temporary hack in genisoimage in the form of a '-C' option.
22 The -C option takes two numbers as input, which are delimited by commas.
23 For example, you could specify "-C 1000,1020", but you should never just
24 make up numbers to use here.  These numbers are determined from wodim.
25
26         Note that if you use -C and omit -M, it effectively means that
27 you are writing a new session, starting at a non-zero block number,
28 and you are effectively ignoring all of the previous session contents.
29 When this session is sent to the writer, the new session effectively
30 "erases" the previous session.
31
32         In practice you should be able to do something like:
33
34 genisoimage [other options] -C `wodim dev=b,t,l -msinfo` \
35                 -M /dev/cdblkdev
36
37 Replace 'b,t,l' by the aproriate numbers for SCSIbus, target and lun
38 of your drive.
39
40 Note: As of the 1.12b5 release, the multi-session technology has
41 matured quite significantly.  It is entirely possible that bugs
42 exists, or that further tweaks will be required somewhere along the
43 way to get things working correctly.  The data gathering mode of
44 wodim has been tested, and I believe it works correctly.  Caveat
45 Emptor.
46
47 [Mar 1, 1999].
48
49
50 Source: README.session from cdrtools package
51 Edited for cdrkit by Christian Fromme <kaner@strace.org> and 
52 Eduard Bloch <blade@debian.org>
53