요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
========================
tcm_qla2xxx Driver Notes
========================
tcm_qla2xxx jam_host attribute
------------------------------
There is now a new module endpoint attribute called jam_host
attribute::
jam_host: boolean=0/1
This attribute and accompanying code is only included if the
Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y
By default this jammer code and functionality is disabled
Use this attribute to control the discarding of SCSI commands to a
selected host.
This may be useful for testing error handling and simulating slow drain
and other fabric issues.
Setting a boolean of 1 for the jam_host attribute for a particular host
will discard the commands for that host.
Reset back to 0 to stop the jamming.
Enable host 4 to be jammed::
echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
Disable jamming on host 4::
echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
jam_host attribute와 build 조건
1-22GPL-2.0으로 배포되는 `tcm_qla2xxx` driver에는 module endpoint의 새 `jam_host` boolean attribute가 있다. 값은 0 또는 1이다. 이 attribute와 관련 code는 Kconfig parameter `TCM_QLA2XXX_DEBUG`를 Y로 설정했을 때만 포함되며 기본적으로 jammer code와 기능은 비활성이다.
`jam_host`는 선택한 host로 들어오는 SCSI command를 버릴지 제어한다. Error handling 시험, slow drain과 다른 fabric 문제를 모의하는 데 유용하다. 특정 host에서 1로 설정하면 그 host의 command를 폐기하고, 0으로 되돌리면 jamming을 중단한다.
Debug build에서 host별 command 폐기를 켜고 끄는 흐름이다.
.. SPDX-License-Identifier: GPL-2.0
========================
tcm_qla2xxx Driver Notes
========================
tcm_qla2xxx jam_host attribute
------------------------------
There is now a new module endpoint attribute called jam_host
attribute::
jam_host: boolean=0/1
This attribute and accompanying code is only included if the
Kconfig parameter TCM_QLA2XXX_DEBUG is set to Y
By default this jammer code and functionality is disabled
Use this attribute to control the discarding of SCSI commands to a
selected host.
This may be useful for testing error handling and simulating slow drainHost 4 jamming 명령
23-36예시 target WWPN `21:00:00:24:ff:27:8f:ae`의 `tpgt_1`에서 host 4 jamming을 켜려면 `/sys/kernel/config/target/qla2xxx/.../attrib/jam_host`에 1을 쓴다. 같은 경로에 0을 쓰면 jamming을 끈다. 원문의 두 `echo` 명령과 전체 configfs 경로를 그대로 보존한다.
동일 endpoint에 쓰는 boolean과 효과다.
and other fabric issues.
Setting a boolean of 1 for the jam_host attribute for a particular host
will discard the commands for that host.
Reset back to 0 to stop the jamming.
Enable host 4 to be jammed::
echo 1 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
Disable jamming on host 4::
echo 0 > /sys/kernel/config/target/qla2xxx/21:00:00:24:ff:27:8f:ae/tpgt_1/attrib/jam_host
요약·해설
tcm_qla2xxx.rst:1-36qla2xxx target host의 command를 의도적으로 버려 fabric error handling을 시험하는 jam_host debug attribute를 설명합니다.