Imported Upstream version 1.1.11
[platform/upstream/cdrkit.git] / doc / plattforms / README.linux
1
2 Requirements of cdrkit on Linux:
3
4  - Linux kernel 2.4 or newer 
5  - Glibc 2.2 or newer
6  - libcap library package is required, with development files (headers)
7  - kernel headers useable with the combination of glibc and kernel, as approved
8    by the distribution. Do not blindly use random kernel headers, do not
9    symlink them to /usr/include/linux or /usr/include/asm*.
10
11 Notes about support on Linux:
12
13  - Linux kernel versions between 2.6.8 and 2.6.11 are known to have invasive
14    SCSI command filtering which makes the use of wodim almost inpossible or
15    complicated for non-root users. Avoid those kernel versions, unless they
16    have been patched to disable that filtering.
17
18  - support of generic scsi was limited on 2.4, ie. not available directly with
19    IDE/ATAPI devices. The ide-scsi driver could be used map ATAPI devices to
20    SCSI ids, however this driver had other problems. See README.ATAPI for
21    details. Note that there also the ATAPI:... device access method which uses
22    deprecated funtionality of kernel 2.4. Don't use it unless it is really
23    neccessary. The support for it may be removed in future versions of cdrkit.
24
25  - the DMA transfer size is limited with some device controllers and the Linux
26    kernel 2.6.x (2.6.19 currently) provides no method to retrieve it for
27    exactly one device. Wodim scans sysfs to retrieve this information, but it
28    needs to be mounted. Use the ts= option of wodim to limit the transfer size
29    on problems.
30
31
32 Additional comments moved from the wodim.1 manpage (originaly cdrecord.1):
33
34 The sg driver on Linux has several severe bugs:
35
36  - It cannot see if a SCSI command could not be sent at all.
37  - It cannot get the SCSI status byte.  wodim for that reason cannot report
38    failing SCSI commands in some situations.
39  - It cannot get real DMA count of transfer. wodim cannot tell you if there is
40    an DMA residual count.
41  - It cannot get number of bytes valid in auto sense data. wodim cannot tell
42    you if device transfers no sense data at all.
43  - It fetches too few data in auto request sense (CCS/SCSI-2/SCSI-3 needs
44    >= 18).
45
46  -- Reviewed by Eduard Bloch -- 12/2006