dc395x SCSI Driver | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

dc395x.rst:1-114

dc395x EEPROM·safe preset, speed·bitmap·tag·reset parameter를 설명합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. SPDX-License-Identifier: GPL-2.0

3 ==================

4 dc395x SCSI driver

5 ==================

7 Status

8 ------

9 The driver has been tested with CD-R and CD-R/W drives. These should

10 be safe to use. Testing with hard disks has not been done to any

11 great degree and caution should be exercised if you want to attempt

12 to use this driver with hard disks.

14 This driver is evolved from `the original 2.4 driver

15 <https://web.archive.org/web/20140129181343/http://www.garloff.de/kurt/linux/dc395/>`_.

16 Problems, questions and patches should be submitted to the `Linux SCSI

17 mailing list <linux-scsi@vger.kernel.org>`_.

19 Parameters

20 ----------

21 The driver uses the settings from the EEPROM set in the SCSI BIOS

22 setup. If there is no EEPROM, the driver uses default values.

23 Both can be overridden by command line parameters (module or kernel

24 parameters).

26 The following parameters are available:

28 safe

29 Default: 0, Acceptable values: 0 or 1

31 If safe is set to 1 then the adapter will use conservative

32 ("safe") default settings. This sets:

34 shortcut for dc395x=7,4,9,15,2,10

36 adapter_id

37 Default: 7, Acceptable values: 0 to 15

39 Sets the host adapter SCSI ID.

41 max_speed

42 Default: 1, Acceptable value: 0 to 7

44 == ========

45 0 20 Mhz

46 1 12.2 Mhz

47 2 10 Mhz

48 3 8 Mhz

49 4 6.7 Mhz

50 5 5.8 Hhz

51 6 5 Mhz

52 7 4 Mhz

53 == ========

55 dev_mode

56 Bitmap for device configuration

58 DevMode bit definition:

60 === ======== ======== =========================================

61 Bit Val(hex) Val(dec) Meaning

62 === ======== ======== =========================================

63 0 0x01 1 Parity check

64 1 0x02 2 Synchronous Negotiation

65 2 0x04 4 Disconnection

66 3 0x08 8 Send Start command on startup. (Not used)

67 4 0x10 16 Tagged Command Queueing

68 5 0x20 32 Wide Negotiation

69 === ======== ======== =========================================

71 adapter_mode

72 Bitmap for adapter configuration

74 AdaptMode bit definition

76 ===== ======== ======== ====================================================

77 Bit Val(hex) Val(dec) Meaning

78 ===== ======== ======== ====================================================

79 0 0x01 1 Support more than two drives. (Not used)

80 1 0x02 2 Use DOS compatible mapping for HDs greater than 1GB.

81 2 0x04 4 Reset SCSI Bus on startup.

82 3 0x08 8 Active Negation: Improves SCSI Bus noise immunity.

83 4 0x10 16 Immediate return on BIOS seek command. (Not used)

84 (*)5 0x20 32 Check for LUNs >= 1.

85 ===== ======== ======== ====================================================

87 tags

88 Default: 3, Acceptable values: 0-5

90 The number of tags is 1<<x, if x has been specified

92 reset_delay

93 Default: 1, Acceptable values: 0-180

95 The seconds to not accept commands after a SCSI Reset

98 For the built in driver the parameters should be prefixed with

99 dc395x. (eg "dc395x.safe=1")

100

101

102 Copyright

103 ---------

104 The driver is free software. It is protected by the GNU General Public

105 License (GPL). Please read it, before using this driver. It should be

106 included in your kernel sources and with your distribution. It carries the

107 filename COPYING. If you don't have it, please ask me to send you one by

108 email.

109

110 Note: The GNU GPL says also something about warranty and liability.

111 Please be aware the following: While we do my best to provide a working and

112 reliable driver, there is a chance, that it will kill your valuable data.

113 We refuse to take any responsibility for that. The driver is provided as-is

114 and YOU USE IT AT YOUR OWN RESPONSIBILITY.

115

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

검증 범위와 문제 보고

1-17

`dc395x` driver는 CD-R과 CD-RW에서 시험되어 비교적 안전하지만 hard disk 시험은 충분하지 않으므로 data disk 사용에는 주의가 필요하다. Linux 2.4용 기존 driver에서 발전했다.

문제·질문·patch는 Linux SCSI mailing list `linux-scsi@vger.kernel.org`로 보낸다. 원문 archive link는 과거 dc395 driver page를 가리킨다.

시험 상태

Device상태

CD-R / CD-RW시험됨

Hard disk제한적 시험, 주의

문의Linux SCSI mailing list

Device 종류별 문서의 신뢰 범위입니다.

.. SPDX-License-Identifier: GPL-2.0

==================
dc395x SCSI driver
==================

Status
------
The driver has been tested with CD-R and CD-R/W drives. These should
be safe to use. Testing with hard disks has not been done to any
great degree and caution should be exercised if you want to attempt
to use this driver with hard disks.

This driver is evolved from `the original 2.4 driver
<https://web.archive.org/web/20140129181343/http://www.garloff.de/kurt/linux/dc395/>`_.
Problems, questions and patches should be submitted to the `Linux SCSI
mailing list <linux-scsi@vger.kernel.org>`_.

EEPROM과 safe preset

18-37

Driver는 SCSI BIOS setup이 EEPROM에 저장한 값을 우선 사용하고 EEPROM이 없으면 기본값을 쓴다. Module 또는 kernel command-line parameter가 두 경우를 모두 override한다.

`safe=1`은 보수적인 preset을 적용하며 `dc395x=7,4,9,15,2,10`의 shortcut이다. `adapter_id`는 host adapter SCSI ID로 기본 7, 범위 0~15다.

설정 우선순위

순위출처

1Module/kernel parameter

2EEPROM SCSI BIOS

3Driver default

가장 구체적인 command-line 값이 최종 적용됩니다.

Safe preset

safe=1dc395x tupleAdapter ID와 speedDevice·adapter modeTags와 reset delay

단일 flag가 보수적 parameter 묶음으로 확장됩니다.


Parameters
----------
The driver uses the settings from the EEPROM set in the SCSI BIOS
setup. If there is no EEPROM, the driver uses default values.
Both can be overridden by command line parameters (module or kernel
parameters).

The following parameters are available:

safe
   Default: 0, Acceptable values: 0 or 1

   If safe is set to 1 then the adapter will use conservative
   ("safe") default settings. This sets:

                shortcut for dc395x=7,4,9,15,2,10

adapter_id
   Default: 7, Acceptable values: 0 to 15

Speed, bitmap, tag와 reset delay

38-99

`max_speed` 기본 1, 범위 0~7은 20, 12.2, 10, 8, 6.7, 5.8, 5, 4MHz 순이다. 원문의 5.8 `Hhz` 표기는 오타로 보이지만 원문에 보존한다.

`dev_mode` bitmap의 bit 0~5는 parity check, synchronous negotiation, disconnection, 미사용 startup Start command, tagged command queueing, wide negotiation이다. 값은 각각 `0x01`, `0x02`, `0x04`, `0x08`, `0x10`, `0x20`이다.

`adapter_mode` bit 0~5는 미사용 two-drive 초과 지원, 1GB 초과 disk DOS mapping, startup SCSI bus reset, noise immunity를 높이는 active negation, 미사용 BIOS seek immediate return, LUN 1 이상 검사다.

`tags`는 기본 3, 범위 0~5이며 실제 tag 수는 `1 << x`다. `reset_delay`는 기본 1초, 범위 0~180초로 SCSI reset 뒤 command를 받지 않는 시간이다. Built-in driver parameter에는 `dc395x.` prefix를 붙여 `dc395x.safe=1`처럼 쓴다.

max_speed selector

값MHz

020

112.2

210

46.7

55.8

Selector가 클수록 전송 clock은 낮아집니다.

dev_mode bit

BitHex기능

00x01Parity check

10x02Synchronous negotiation

20x04Disconnection

30x08Start command, 미사용

40x10Tagged queueing

50x20Wide negotiation

Target device 기능 bitmap입니다.

adapter_mode bit

BitHex기능

00x01>2 drives, 미사용

10x02>1GB DOS mapping

20x04Startup bus reset

30x08Active negation

40x10BIOS seek return, 미사용

50x20LUN >= 1 검사

Adapter 동작 bitmap입니다.


   Sets the host adapter SCSI ID.

max_speed
   Default: 1, Acceptable value: 0 to 7

   ==  ========
   0   20   Mhz
   1   12.2 Mhz
   2   10   Mhz
   3   8    Mhz
   4   6.7  Mhz
   5   5.8  Hhz
   6   5    Mhz
   7   4    Mhz
   ==  ========

dev_mode
   Bitmap for device configuration

   DevMode bit definition:

      === ======== ========  =========================================
      Bit Val(hex) Val(dec)  Meaning
      === ======== ========  =========================================
       0    0x01       1     Parity check
       1    0x02       2     Synchronous Negotiation
       2    0x04       4     Disconnection
       3    0x08       8     Send Start command on startup. (Not used)
       4    0x10      16     Tagged Command Queueing
       5    0x20      32     Wide Negotiation
      === ======== ========  =========================================

adapter_mode
   Bitmap for adapter configuration

   AdaptMode bit definition

    ===== ======== ========  ====================================================
      Bit Val(hex) Val(dec)  Meaning
    ===== ======== ========  ====================================================
       0    0x01       1     Support more than two drives. (Not used)
       1    0x02       2     Use DOS compatible mapping for HDs greater than 1GB.
       2    0x04       4     Reset SCSI Bus on startup.
       3    0x08       8     Active Negation: Improves SCSI Bus noise immunity.
       4    0x10      16     Immediate return on BIOS seek command. (Not used)
    (*)5    0x20      32     Check for LUNs >= 1.
    ===== ======== ========  ====================================================

tags
   Default: 3, Acceptable values: 0-5

   The number of tags is 1<<x, if x has been specified

reset_delay
   Default: 1, Acceptable values: 0-180

   The seconds to not accept commands after a SCSI Reset


For the built  in driver the parameters should be prefixed with
dc395x. (eg "dc395x.safe=1")

GPL과 data 손실 경고

100-114

Driver는 GNU GPL로 배포되는 free software이며 kernel source 또는 배포판의 `COPYING`을 읽어야 한다.

원문은 warranty와 liability가 없고, 작동하고 신뢰할 수 있는 driver를 제공하려 노력해도 data를 파괴할 가능성이 있다고 경고한다. Driver는 as-is이며 사용 책임은 사용자에게 있다.

책임 범위

항목내용

LicenseGNU GPL

보증없음

위험Data 손실 가능

책임사용자 책임

License와 운영 위험을 구분합니다.



Copyright
---------
The driver is free software. It is protected by the GNU General Public
License (GPL). Please read it, before using this driver. It should be
included in your kernel sources and with your distribution. It carries the
filename COPYING. If you don't have it, please ask me to send you one by
email.

Note: The GNU GPL says also something about warranty and liability.
Please be aware the following: While we do my best to provide a working and
reliable driver, there is a chance, that it will kill your valuable data.
We refuse to take any responsibility for that. The driver is provided as-is
and YOU USE IT AT YOUR OWN RESPONSIBILITY.