1 README for sg3_utils/scripts 2 ============================ 3Introduction 4============ 5This directory contains bash shell scripts. Most of them call one or 6more utilities from the sg3_utils package. They assume the sg3_utils 7package utilities are on the PATH of the user. 8 9rescan-scsi-bus.sh is written by Kurt Garloff (formerly from Suse Labs) 10with patches from Hannes Reinecke (Suse) and Redhat. 11 12scsi_logging_level is written by Andreas Herrmann <aherrman at de dot ibm 13dot com>. It sets the logging level of the SCSI subsystem in the Linux 142.6 series kernels. See that file for more information. 15 16The other scripts are written by the author. Some do testing while others 17do bulk tasks (e.g. stopping multiple disks). 18 19Details 20======= 21Each script supplies more information, typically by supplying a '-h' 22or '--help' option. The script source often contains explanatory 23information. Following is a usage summary with a one line description: 24 rescan-scsi-bus.sh [OPTIONS] 25 - see the output of 'rescan-scsi-bus.sh --help' 26 scsi_logging_level [OPTIONS] 27 - set Linux SCSI subsystem logging level 28 scsi_mandat [-h] [-L] [-q] <device> 29 - check for mandatory SCSI command support 30 scsi_readcap [-b] [-h] [-v] <device>+ 31 - fetch capacity/size information for each <device> 32 scsi_ready [-h] [-v] <device>+ 33 - check the media ready status on each <device> 34 scsi_satl [-h] [-L] [-q] [-v] <device> 35 - check <device> for SCSI to ATA Translation Layer (SATL) 36 scsi_start [-h] [-v] [-w] <device>+ 37 - start media (i.e. spin up) in each <device> 38 scsi_stop [-h] [-v] [-w] <device>+ 39 - stop media (i.e. spin down) in each <device> 40 scsi_temperature [-h] [-v] <device>+ 41 - check temperature in each <device> 42 43These scripts assume that the main sg3_utils utilities are installed 44and are on the user's PATH. 45 46This directory, prior to sg3_utils-1.28, contained the sas_disk_blink 47script. Since it depends on the sdparm utility it has been moved to 48the sdparm package in its scripts directory. 49 5059-scsi-sg3_utils.rules is a Linux specific file for udev. These rules use 51'sg_inq --export' to help udev create identifying device nodes, for example 52/dev/disk/by-id/wwn-0x5001501234567890-part1. 53 54Douglas Gilbert 554th October 2021 56