SCSI kernel parameter

현재 parameter를 확인하고 runtime에 변경하기

Module parameter 지정의 일반 규칙은 `Documentation/admin-guide/kernel-parameters.rst`를 참고한다. 이 문서는 완전히 최신이거나 포괄적이지 않을 수 있다.

Load 가능한 module의 현재 parameter 목록은 `modinfo -p ${modulename}`으로 확인한다. Module을 실행 중인 kernel에 load하면 `/sys/module/${modulename}/parameters/`에도 parameter가 나타난다. 일부는 `echo -n ${value} > /sys/module/${modulename}/parameters/${parm}`으로 runtime에 바꿀 수 있다.

.. SPDX-License-Identifier: GPL-2.0

======================
SCSI Kernel Parameters
======================

See Documentation/admin-guide/kernel-parameters.rst for general information on
specifying module parameters.

This document may not be entirely up to date and comprehensive. The command
``modinfo -p ${modulename}`` shows a current list of all parameters of a loadable
module. Loadable modules, after being loaded into the running kernel, also
reveal their parameters in /sys/module/${modulename}/parameters/. Some of these
parameters may be changed at runtime by the command
``echo -n ${value} > /sys/module/${modulename}/parameters/${parm}``.

Adapter driver별 parameter 안내

`advansys`는 `drivers/scsi/advansys.c` header, `aha152x`는 `Documentation/scsi/aha152x.rst`, `aic7xxx`와 `aic79xx`는 각각 같은 이름의 SCSI 문서를 참고한다. `aha1542` 형식은 `<portbase>[,<buson>,<busoff>[,<dmaspeed>]]`이다.

`atascsi`는 `drivers/scsi/atari_scsi.c`, `BusLogic`은 `drivers/scsi/BusLogic.c`의 `BusLogic_ParseDriverOptions()` 앞 주석, `ips`는 Adaptec/IBM ServeRAID controller용 `drivers/scsi/ips.c` header, `mac5380`은 `drivers/scsi/mac_scsi.c`를 참고한다. `gvp11`은 별도 설명이 없다.

::

        advansys=        [HW,SCSI]
                        See header of drivers/scsi/advansys.c.

        aha152x=        [HW,SCSI]
                        See Documentation/scsi/aha152x.rst.

        aha1542=        [HW,SCSI]
                        Format: <portbase>[,<buson>,<busoff>[,<dmaspeed>]]

        aic7xxx=        [HW,SCSI]
                        See Documentation/scsi/aic7xxx.rst.

        aic79xx=        [HW,SCSI]
                        See Documentation/scsi/aic79xx.rst.

        atascsi=        [HW,SCSI]
                        See drivers/scsi/atari_scsi.c.

        BusLogic=        [HW,SCSI]
                        See drivers/scsi/BusLogic.c, comment before function
                        BusLogic_ParseDriverOptions().

        gvp11=                [HW,SCSI]

        ips=                [HW,SCSI] Adaptec / IBM ServeRAID controller
                        See header of drivers/scsi/ips.c.

        mac5380=        [HW,SCSI]
                        See drivers/scsi/mac_scsi.c.

LUN 탐색 한계와 NCR driver

`scsi_mod.max_luns`는 probe할 LUN의 최대 수로 1 이상 `2^32-1` 이하여야 한다. `scsi_mod.max_report_luns`는 REPORT LUNS로 받을 최대 LUN 수이며 1~16384 범위다.

`NCR_D700`은 `drivers/scsi/NCR_D700.c` header를 참고한다. `ncr5380`, `ncr53c400`, `ncr53c400a`는 모두 `Documentation/scsi/g_NCR5380.rst`를 참고하며 `ncr53c8xx`에는 별도 설명이 없다.

        scsi_mod.max_luns=
                        [SCSI] Maximum number of LUNs to probe.
                        Should be between 1 and 2^32-1.

        scsi_mod.max_report_luns=
                        [SCSI] Maximum number of LUNs received.
                        Should be between 1 and 16384.

        NCR_D700=        [HW,SCSI]
                        See header of drivers/scsi/NCR_D700.c.

        ncr5380=        [HW,SCSI]
                        See Documentation/scsi/g_NCR5380.rst.

        ncr53c400=        [HW,SCSI]
                        See Documentation/scsi/g_NCR5380.rst.

        ncr53c400a=        [HW,SCSI]
                        See Documentation/scsi/g_NCR5380.rst.

        ncr53c8xx=        [HW,SCSI]

Tape, debug, device flag와 logging

`osst`는 SCSI tape driver이며 형식은 `<buffer_size>,<write_threshold>`이고 `Documentation/scsi/st.rst`도 참고한다. `scsi_debug_*`는 `drivers/scsi/scsi_debug.c`에 설명돼 있다. `scsi_mod.default_dev_flags`는 정수 형식의 기본 SCSI device flag다.

`scsi_mod.dev_flags`는 vendor/model black·white list entry이며 `<vendor>:<model>:<flags>` 형식이고 flags는 정수다. `scsi_mod.scsi_logging_level`은 logging level bit mask다. Bit는 `drivers/scsi/scsi_logging.h`를 참고하며 `dev.scsi.logging_level`, 즉 `/proc/sys/dev/scsi/logging_level` sysctl로도 설정한다.

S390-tools에는 편리한 `scsi_logging_level` script가 있으며 `https://github.com/ibm-s390-linux/s390-tools/blob/master/scripts/scsi_logging_level`에서 받을 수 있다.

        osst=                [HW,SCSI] SCSI Tape Driver
                        Format: <buffer_size>,<write_threshold>
                        See also Documentation/scsi/st.rst.

        scsi_debug_*=        [SCSI]
                        See drivers/scsi/scsi_debug.c.

        scsi_mod.default_dev_flags=
                        [SCSI] SCSI default device flags
                        Format: <integer>

        scsi_mod.dev_flags=
                        [SCSI] Black/white list entry for vendor and model
                        Format: <vendor>:<model>:<flags>
                        (flags are integer value)

        scsi_mod.scsi_logging_level=
                        [SCSI] a bit mask of logging levels
                        See drivers/scsi/scsi_logging.h for bits.  Also
                        settable via sysctl at dev.scsi.logging_level
                        (/proc/sys/dev/scsi/logging_level).
                        There is also a nice 'scsi_logging_level' script in the
                        S390-tools package, available for download at
                        https://github.com/ibm-s390-linux/s390-tools/blob/master/scripts/scsi_logging_level

SCSI bus scan mode와 나머지 driver

`scsi_mod.scan=sync`는 발견하는 즉시 SCSI bus를 동기 scan하며 기본값이다. `async`는 kernel thread에서 scan해 boot가 계속 진행되게 한다. `none`은 bus를 무시하고 user space가 scan할 것으로 기대한다.

`sim710`은 `drivers/scsi/sim710.c` header를 참고한다. `st`는 buffer 등을 포함한 SCSI tape parameter이며 `Documentation/scsi/st.rst`에 설명돼 있다. `wd33c93`은 `drivers/scsi/wd33c93.c` header를 참고한다.

        scsi_mod.scan=        [SCSI] sync (default) scans SCSI busses as they are
                        discovered.  async scans them in kernel threads,
                        allowing boot to proceed.  none ignores them, expecting
                        user space to do the scan.

        sim710=                [SCSI,HW]
                        See header of drivers/scsi/sim710.c.

        st=                [HW,SCSI] SCSI tape parameters (buffers, etc.)
                        See Documentation/scsi/st.rst.

        wd33c93=        [HW,SCSI]
                        See header of drivers/scsi/wd33c93.c.