SG_SES(8) SG3_UTILS SG_SES(8) (NAME) sg_ses - SCSI (SES) (SYNOPSIS) sg_ses [--all] [--ALL] [--descriptor=DES] [--dev-slot-num=SN] [--eiioe=A_F] [--filter] [--get=STR] [--hex] [--index=IIA | --index=TIA,II] [--inner-hex] [--join] [--json[=JO]] [--js-file=JFN] [--maxlen=LEN] [--no-config] [--no-time] [--page=PG] [--quiet] [--raw] [--readonly] [--sas-addr=SA] [--status] [--verbose] [--warn] DEVICE sg_ses --control [--byte1=B1] [--clear=STR] [--data=H,H...] [--data=@FN] [--descriptor=DES] [--dev-slot-num=SN] [--index=IIA | --index=TIA,II] [--mask] [--maxlen=LEN] [--nickname=SEN] [--nickid=SEID] [--page=PG] [--readonly] [--sas-addr=SA] [--set=STR] [--verbose] DEVICE sg_ses --data=@FN --status [--raw --raw] [< >] sg_ses --inhex=FN --status [--raw --raw] [< >] sg_ses [--enumerate] [--index=IIA] [--list] [--help] [--version] (DESCRIPTION) SCSI (SES) . SES . DEVICE SES Peripheral Device Type ( ) INQUIRY 13 [0xd] . SCSI ( ) EncServ INQUIRY . DEVICE SES ( dpage) . dpage SES . SCSI Enclosure Services 4 T10/BSR INCITS 555 5 https://www.t10.org . SES SES-2 SES-3 ANSI INCITS 305-1998 ANSI INCITS 448-2008 ANSI INCITS 518-2017 . SAS SES . HBA ( SCSI) SES . SCSI SES HBA ( SAS) SES HBA . SES () HBA SCSI . SYNOPSIS ( ) dpage DEVICE SES . SCSI RECEIVE DIAGNOSTIC RESULTS DEVICE dpage . dpage --hex --raw --raw . SYNOPSIS dpage DEVICE SES . SCSI SEND DIAGNOSTIC dpage <<>> (control) DEVICE . ( LED "ident" () ) -- (read-modify-write) . << >> . SYNOPSIS . ( FN) dpage SES . '-HHHH' . SCSI DEVICE . SYNOPSIS ( ) dpage (--enumerate) . https://sg.danny.cz/sg/sg_ses.html . SES sg_ses_microcode . "dpage" SCSI RECEIVE DIAGNOSTIC RESULTS SCSI SEND DIAGNOSTIC DEVICE --data= --inhex=FN . (OPTIONS) . . -a, --all --join dpage SES . --join dpage Threshold In "other SES dpages" ( dpage SES) . <<>> dpage SES --join . --page=all . dpage Threshold In ( ) --join . dpage Threshold In "other SES dpages" . --ALL . --control --status . -HHH -HHHH -HHHHH . -H ( ). --page=all -HHH -HHHH -HHHHH : SES . -z, --ALL --join dpage SES . --join dpage Threshold In dpage "other SES dpages" . --control --status . -b, --byte1=B1 dpage ( ) . dpage Enclosure Control INFO NON-CRIT CRIT UNRECOV . dpage Subenclosure String Out Subenclosure Nickname Control Download Microcode Control . --control --data=H,H... 0 . --clear=STR --set=STR . B1 '0x' '0X' ( 'h' 'H' ). -C, --clear=STR dpage Enclosure Control Threshold Out . . --page=PG dpage Enclosure Control . << >> (STR FORMAT) << >> (CLEAR, GET, SET) . -c, --control SCSI SEND DIAGNOSTIC DEVICE . --status . dpage Enclosure Control String Out Threshold Out Array Control ( SES-2 ) Subenclosure String Out Subenclosure Nickname Control Download Microcode . --clear=STR --set=STR . -d, --data=H,H... (ASCII) ( ). () . dpage . ( ) . << >> (DATA SUPPLIED) . -d, --data=- (stdin) 2**16 . stdin ASCII ( --data=H,H...). stdin . EOF stdin . << >> (DATA SUPPLIED) . -d, --data=@FN FN 2**16 . stdin . << >> (DATA SUPPLIED) . -D, --descriptor=DES DES () dpage Element Descriptor . --index= . DES ( ) ( ). << >> . -x, --dev-slot-num=SN, --dsn=SN SN dpage Additional Element Status . FCP SAS ( EIP=1) . SN 0 255 ( ) . 255 . --index= . << >> . -E, --eiioe=A_F A_F 'auto' 'force'. 'element index' dpage Additional Element Status ( AES) SES-2 SES-3 . EIIOE . 12 SES-3 EIIOE EIIOE . '--eiioe=force' AES EIIOE 1 . '--eiioe=auto' AES AES EIP element index 1 EIIOE 1 ( EIIOE 1 0). EIIOE 1 . HP JBOD --eiioe=auto . -e, --enumerate (dpage) SES . DEVICE . . --enumerate --clear=STR --get=STR --set=STR . DEVICE . dpage Enclosure Control/Status --index=IIA ( "sg_ses -ee -I ts" (Temperature Sensor Element Type) dpage Enclosure Control/Status). -f, --filter dpage Enclosure Status dpage Additional Element Status . ( 0) ( ). ( ) . "status=ok" ( dpage Enclosure status) . --filter --join . -G, --get=STR . . dpage Enclosure Status dpage dpage Threshold In Additional Element Status . stdout ( ) "0x" --hex . << >> (STR FORMAT) << >> (CLEAR, GET, SET) . -h, --help . . . ( '-hh') . : --enumerate << >> : '-ee'. -H, --hex --get=STR ( ) "0x" . / . ASCII . ( ) . dpage ( --join ). --raw . dpage stdout ASCII -HHH -HHHH . H dpage . dpage ( --page=all) H dpage ('#') . H . ( -HHHHH) . --inner-hex . --inner-hex . -HHHH ( ) --inner-hex . '-H' '-HH' "2.72 20230130" sg3_utils(8) . -I, --index=IIA IIA (II) (A) . <<>> . --page=PG dpage Enclosure Status ( Control) . --join --clear=STR --get=STR --set=STR . --enumerate . -I, --index=TIA,II TIA,II (TI) (A) (II) . <<>> . --page=PG dpage Enclosure Status ( Control) . --join --clear=STR --get=STR --set=STR . --enumerate . -X, --inhex=FN FN . --data=@FN . FN '-' (stdin) . --inhex=FN ( --in=FN) . "HEX, BINARY AND JSON FORMATS" sg3_utils . -i, --inner-hex dpage () ( Element Status Descriptor) . dpage dpage Configuration --no-config . / --join . . --json[=JO] dpage . . << JSON>> . --hex ASCII . --hex ASCII --hex ASCII . -j, --join dpage Element Descriptor Enclosure Status Additional Element Status . dpage Threshold In . dpage Configuration dpage . "join" . . . . --filter ( ) . "--page=aes" ( "-p 0xa") dpage "aes" . <<>> << >> . --status . --control . -J[=JO], --json[=JO] JSON . "=" "=" . sg3_utils_json '?' JO . JSON << JSON>> . -Q, --js-file=JFN JSON JFN . () . JSON (stdout) . --json[=JO] . --json[=JO] JO . -l, --list --enumerate . . -M, --mask ( ) ( --clear=STR --set=STR) . 1.98 sg_ses SES-3 6 ( ). . . ( ) --- . -m, --maxlen=LEN LEN ALLOCATION LENGTH SCSI RECEIVE DIAGNOSTIC RESULTS . SES ( ). 65535 65532 () . . LEN 0 65535 . LEN 0 4 ( stderr ). -n, --nickname=SEN SEN . () SEN . << >> . -N, --nickid=SEID SEID (SEN) . SEID . 0 . -F, --no-config dpage Element status Array status () Element Descriptor Additional element status Threshold In dpage Configuration . dpage dpage . . dpage dpage Configuration . --inner-hex . dpage dpage Configuration dpage Configuration . -y, --no-time SCSI REPORT TIMESTAMP INQUIRY . - (uptime) . (epoch) . . FreeBSD 00:00 1970 UTC . - RFC 2822 UTC . REPORT TIMESTAMP . . SCSI DEVICE DEVICE . -p, --page=PG PG ( ) dpage . PG 0x . 0 255 (0x0 0xff) . dpage 'sdp' page_code 0 ( "Supported Diagnostic Pages") . 0xff "all" dpage ( dpage 0x3f ) dpage SES 0x2f . -HHHH -rr ASCII (stdout) . . --warn --page=all . dpage "xxx" PG --enumerate . -q, --quiet . . -r, --raw dpage ASCII --data= . dpage ( ) . ( -rr) dpage stdout . --raw sg3_utils . -rr --data=- --data=@FN --inhex=FN FN (EOF) . raw 0 . -rr . -R, --readonly DEVICE ( O_RDONLY). - . -A, --sas-addr=SA SAS ( SAS) . dpage Additional Element Status SAS SA . SAS SAS . SAS . SATA SAS (manufactured) SAS SAS SAS . WWN SATA . SA . '0x' '0X' 'h' 'H' . --index= . << >> . -S, --set=STR dpage Enclosure Control Threshold Out . . --page=PG dpage Enclosure Control . << >> (STR FORMAT) << >> (CLEAR, GET, SET) . -s, --status dpage SCSI RECEIVE DIAGNOSTIC RESULTS ( --data=@FN) DEVICE . dpage ( --control --set=STR) --status --data= . --data= : --control . -v, --verbose . ( : '-vvvv') stderr . -V, --version . -w, --warn stderr . (join) dpage . SES T10 ( EIIOE ) . dpage --page=all . (INDEXES) dpage . ( ) dpage . ( ( ) ). ( ) . Configuration : << >> (type headers) ( Array Device Slot) (0 ) << >> (Number of possible elements) . Enclosure Status <<>> (overall) << >> . << >> 0 Enclosure Status <<>> . Element Descriptor Threshold ( ) Enclosure Status . "-1" . Configuration "n" -1 n-1 . Additional Element Status . << >> . <<>> . dpage "Element Index Present" (EIP) . EIP "Element Index" Enclosure Status . : TI II. TI=0 Device Slot Array Device Slot ( SES-2). II -1 II . (TI) (A) ( "ps" ) ( "ps" "ps1" ). : --index=TIA,II TIA (TI) (A) ( "ps" "ps1"). II "-1" . --index=IIA IIA (II) (A) . IIA --index=0,II . IIA --index=A,-1 . . : . : '3:5' . -1:255 . '-' -1-1 -1 ( ) 0 1 ( ) . ( 128 255 ) (underscore) . : --index=arr --index=_23 Array Device Slot 23 . --index=ps1 --index=_2_1 . : Configuration Array Device Slot --index=0,-1 --index=arr . --index=arr,3 --index=3 . --index= ( ). --clear=STR --get=STR --set=STR STR . (DESCRIPTOR NAME, DEVICE SLOT NUMBER AND SAS ADDRESS) : --descriptor=DES --dev-slot-num=SN --sas-addr=SA --index= . . (join) ( ). SES . --descriptor=DES dpage Element Descriptor SES . "0" . ( ) . ( 3). --clear=STR --get=STR --set=STR . ( "do not remove" (dnr)) --get=STR ( ). (STR FORMAT) STR --clear=STR --get=STR --set=STR . : [=] :[:][=] ( "ident" "fault") . 0 3 0 7 1 64 ( 1 ). SES . 2:7:8 2:7 2:0 . --get=STR . --set=STR 1 --clear=STR 0 . . --enumerate ( "-ee") . (CLEAR, GET, SET) --clear=STR --get=STR --set=STR . STR dpage . (: ) . . --clear=STR --set=STR dpage . (DATA SUPPLIED) --data= . --data= ( --data=- ) ( --data=@thresh_in_dpage.hex) . --control . dpage <<>> SCSI SEND DIAGNOSTIC DEVICE . dpage . --page=PG PG 0 . --byte1=B1 1 0 . ( ) 2 3 . --status ( --control) . SCSI RECEIVE DIAGNOSTIC RESULTS . () . '-HHH' '-HHHH' ( ) . dpage . --join dpage : dpage Configuration Enclosure status Element descriptor Additional element status. --page=all dpage . ASCII . ('#') . LF CR,LF . ( ) ( '0x' 'h' ). . '-rr' . --data=H,H... 'H' ASCII . (--data=- --data=@FN) . '-rr' --data=@FN . (CHANGING STATE) SES . -- . dpage "status" ( "in") dpage "control" ( "out") . dpage <<>> --raw . (: Enclosure Control SELECT ). dpage --data=H,H... --control --byte1=B1 . dpage Enclosure Control ( dpage Threshold Out) . dpage ( dpage Enclosure Control ). ( Element Descriptor ). ( "ident" RQST IDENT) ( Array Device Slot Control RQST IDENT ("2:1:1")). --set=STR 1 --clear=STR 0 . (SETTING SUBENCLOSURE NICKNAME) dpage Subenclosure Nickname dpage . ( 0 ) dpage . --data ( ). --nickname=SEN --nickid=SEID . SEN : ( ). --nickid=SEID 0 . --control . --page=PG --page=snic . --nickname=SEN dpage Subenclosure Nickname Status Generation Code . Generation Code (SEN) (SEID) dpage Subenclosure Nickname Control . <<>> . NVME (NVME ENCLOSURES) NVMe ( NVM Express) sg_ses ( ) . 1.43 sg3_utils 2.34 sg_ses . NVME-MI ( ) SES-3 . NVME-MI SES Send SES Receive dpage SES . JSON (JSON INFORMATION) JSON ( --json[=JO] ) --join . SES ( dpage Enclosure Status Element Descriptor dpage Configuration ). --json[=JO] --page=PG PG . dpage Element Descriptor dpage Configuration . ( dpage ) dpage . --inner-hex . dpage ( dpage Enclosure Status) dpage Configuration . dpage Element Descriptor ASCII --inner-hex . --inner-hex . --json[=JO] --page=PG PG (snake_case) . "_diagnostic_page" . --json[=JO] --join ( --page=PG __ ) "join_of_diagnostic_pages" (JSON) "element_list" . "element_type" "descriptor" "element_number" . "descriptor" . "element_type" "overall_element" . "element_number" "overall_element" -1 . "element_type" "element_list" "element_number" 0 . "element_number" "overall" 0 ( "individual") 1 ( "overall") . "individual" true ( "individual") false . "status_descriptor" dpage "Enclosure Status" . Additional element status Element descriptor by type element Threshold status . ( ) 0 . JSON . (NOTES) dpage ( SES) ( SCSI READ DIAGNOSTIC) . --page=PG --hex . dpage SES sg_senddiag . (join) Additional Element Status . SES SES-2 "element index" . "element index" SES-2 . SES-3 EIIOE (Element Index Includes Overall Elements) . --eiioe=A_F . SES-3 5 "Door Lock" "Door" ( OPEN ). 'dl' 'do' . RAID SES . MegaRAID : perccli /cx set backplane expose= perccli Dell storcli BroadCom (LSI) . SAF-TE ( SCSI) ( RAID) . SCSI SAF-TE "Processor" (0x3) INQUIRY . sg_safte safte-monitor . MX_JOIN_ROWS . 520 . (EXAMPLES) https://sg.danny.cz/sg/sg_ses.html . . sg3_utils(8) . dpage : sg_ses /dev/bsg/6:0:2:0 dpage Configuration: sg_ses --page=cf /dev/bsg/6:0:2:0 dpage Enclosure Status: sg_ses --page=es /dev/bsg/6:0:2:0 SAS () ( dpage Additional Element Sense (dpage 10) ) : sg_ses -p aes -D ArrayDevice07 -G at_sas_addr -H /dev/sg3 dpage Enclosure Status Element Descriptor Additional Element Status --join : sg_ses --join /dev/sg3 . --filter : sg_ses --join --filter /dev/sg3 dpage Enclosure Control Threshold --clear=STR --set=STR . [ dpage --raw --data=H,H... .] LED "ident" ( "locate") "ArrayDevice07" ( ) : sg_ses --index=7 --set=2:1:1 /dev/sg3 --set= --control . --clear= . --get= --status . dpage Element Descriptor "ArrayDevice07" 7 : sg_ses --descriptor=ArrayDevice07 --set=2:1:1 /dev/sg3 ( ) Array Device Slot Control RQST IDENT LED . "ident" ( "locate") : sg_ses --descriptor=ArrayDevice07 --set=ident /dev/sg3 LED: sg_ses --dev-slot-num=7 --clear=ident /dev/sg3 'ArrayDevice07' 7 . dpage . dpage String ( ) ( dpage Enclosure Status/Control). : . dpage String (In) : sg_ses --page=str /dev/bsg/6:0:2:0 <<>>. dpage String ( ) . ASCII . stdout "t" : sg_ses --page=str --raw /dev/bsg/6:0:2:0 > t SES-3 ( 3: 6.1.6) t . : sg_ses --page=str --control --data=- /dev/bsg/6:0:2:0 < t dpage String . : sg_ses --page=str /dev/bsg/6:0:2:0 : sg_ses --nickname='1st enclosure' --control /dev/bsg/6:0:2:0 ( SES) : sg_ses --page=all -HHHH /dev/sg5 > enc_sg5_all.hex stderr ( stdout ). enc_sg5_all.hex . enc_sg5_all.hex "join" . join . sg_ses --data=@enc_sg5_all.hex --status --join : sg_ses --inhex=enc_sg5_all.hex --join --join --status . (EXIT STATUS) sg_ses 0 . sg3_utils(8) . (AUTHORS) Douglas Gilbert. (REPORTING BUGS) . (COPYRIGHT) (C) 2004-2023 Douglas Gilbert . BSD-2-Clause . . (SEE ALSO) sg_inq, sg_safte, sg_senddiag, sg_ses_microcode, sg3_utils (sg3_utils); safte-monitor (Internet) sg3_utils-1.48 SG_SES(8)