요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
===============================================================
Driver for Western Digital WD7193, WD7197 and WD7296 SCSI cards
===============================================================
The card requires firmware that can be cut out of the Windows NT driver that
can be downloaded from WD at:
http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
There is no license anywhere in the file or on the page - so the firmware
probably cannot be added to linux-firmware.
This script downloads and extracts the firmware, creating wd719x-risc.bin and
d719x-wcs.bin files. Put them in /lib/firmware/::
#!/bin/sh
wget http://support.wdc.com/download/archive/pciscsi.exe
lha xi pciscsi.exe pci-scsi.exe
lha xi pci-scsi.exe nt/wd7296a.sys
rm pci-scsi.exe
dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
rm wd7296a.sys
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Firmware 출처와 배포 제약
1-13GPL-2.0 driver 문서는 Western Digital WD7193, WD7197, WD7296 SCSI card를 다룬다. Card에는 WD support URL에서 받는 Windows NT driver 안의 firmware가 필요하다. File과 download page 어디에도 license가 없으므로 firmware를 `linux-firmware`에 추가하기는 어려울 것으로 판단한다.
.. SPDX-License-Identifier: GPL-2.0
===============================================================
Driver for Western Digital WD7193, WD7197 and WD7296 SCSI cards
===============================================================
The card requires firmware that can be cut out of the Windows NT driver that
can be downloaded from WD at:
http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
There is no license anywhere in the file or on the page - so the firmware
probably cannot be added to linux-firmware.
Windows driver에서 firmware 추출
14-24원문의 shell script는 `pciscsi.exe`를 내려받고 `lha`로 `pci-scsi.exe`, 다시 `nt/wd7296a.sys`를 추출한다. `dd`로 offset 5760에서 14,336 byte를 잘라 `wd719x-risc.bin`, offset 20,096에서 514 byte를 잘라 `wd719x-wcs.bin`을 만든다. 중간 file을 지운 뒤 두 firmware file을 `/lib/firmware/`에 둔다. URL, command, filename, byte offset과 count를 모두 보존한다.
Shell script의 `dd` 좌표를 구조화했다.
Windows package에서 Linux driver용 binary 두 개를 얻는 순서다.
This script downloads and extracts the firmware, creating wd719x-risc.bin and
d719x-wcs.bin files. Put them in /lib/firmware/::
#!/bin/sh
wget http://support.wdc.com/download/archive/pciscsi.exe
lha xi pciscsi.exe pci-scsi.exe
lha xi pci-scsi.exe nt/wd7296a.sys
rm pci-scsi.exe
dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
rm wd7296a.sys
요약·해설
wd719x.rst:1-24WD7193·WD7197·WD7296 card에 필요한 firmware의 출처, licensing 제약과 정확한 binary 추출 절차를 설명합니다.