요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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를 설명합니다.