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