Removed DOS task fields from the NE_MODULE structure.
[wine] / documentation / cdrom-labels
1                Drive labels and serial numbers with wine
2                -----------------------------------------
3
4        Until now, your only possibility of specifying drive volume labels
5 and serial numbers was to set them manually in the wine config file.
6 By now, wine can read them directly from the device as well. This may be
7 useful for many Win 9x games or for setup programs distributed on CD-ROMs
8 that check for volume label.
9
10 WHAT'S SUPPORTED ?
11
12     *  FAT systems (types 'hd' and 'floppy'): reads labels and serial num's.
13     *  Iso9660 ('cdrom'):                     reads labels only.
14
15 HOW TO SET UP ?
16
17         Reading labels and serial numbers just works automagically if
18 you specify a 'Device=' line in the [Drive X] section in your wine.conf.
19 Note that the device has to exist and must be accessible if you do this,
20 though.
21 If you don't do that, then you should give fixed 'Label=' or 'Serial=' entries
22 in wine.conf, as Wine returns these entries instead if no device is given.
23 If they don't exist, then Wine will return default values (label "Drive X"
24 and serial 12345678).
25
26 Now a seldom needed one:
27 If you want to give a 'Device=' entry *only* for drive raw sector accesses, but
28 not for reading the volume info from the device (i.e. you want a *fixed*,
29 preconfigured label), you need to specify 'ReadVolInfo=0' to tell Wine to skip
30 the volume reading.
31
32 EXAMPLES
33
34 *** Simple example of cdrom and floppy; labels will be read from the device on
35 both cdrom and floppy; serial numbers on floppy only:
36
37 [Drive A]
38 Path=/mnt/floppy
39 Type=floppy
40 Device=/dev/fd0
41 Filesystem=msdos
42
43 [Drive R]
44 Path=/mnt/cdrom
45 Type=cdrom
46 Device=/dev/hda1
47 Filesystem=win95
48
49 *** CD-ROM. We want to override the label:
50
51 [Drive J]
52 Path=/mnt/cdrom
53 Type=cdrom
54 Label=X234GCDSE
55 ; note that the device isn't really needed here as we have a fixed label
56 Device=/dev/cdrom
57 Filesystem=msdos
58
59 TODO / OPEN ISSUES
60
61  - The cdrom label can be read only if the data track of the disk resides in
62 the first track and the cdrom is iso9660.
63  - Better checking for FAT superblock (it now check's only one byte).
64  - Support for labels/serial num's WRITING.
65  - Can the label be longer than 11 chars? (iso9660 has 32 chars).
66  - What about reading ext2 volume label? ....
67
68 Petr Tomasek                            changes by:     Andreas Mohr
69 <tomasek@etf.cuni.cz>                                   <a.mohr@mailto.de>
70 Nov 14 1999                                             Jan 25 2000