Release 0.5.0

README.rst

@@ -19,10 +19,11 @@ sasutils command-line tools
 * sas_discover
 * ses_report
 
-Also, two "zeroconf" udev scripts for use in udev rules that create friendly device aliases using SES-2 subenclosure nicknames.
+Also, a few "zeroconf" udev scripts for use in udev rules that create friendly device aliases using SES-2 subenclosure nicknames.
 
 * sas_mpath_snic_alias
 * sas_sd_snic_alias
+* sas_st_snic_alias
 
 .. note::
 
@@ -182,6 +183,11 @@ Below is an example with a large topology with multiple SAS HBAs, SAS switches a
                             `-- 51 x end_device -- disk
 
 
+Use ``sas_discover --counters`` to display the number of SCSI commands issued (`req`), completed or rejected (`done`) and the ones that completed with an error (`error`).
+
+.. image:: https://raw.githubusercontent.com/stanford-rc/sasutils/master/doc/examples/sas_discover_counters_tape.svg
+
+
 sas_devices
 -----------
 
@@ -265,17 +271,24 @@ Use -s to get the status of all detected SES Element Descriptors.
        **ses_report** requires a recent version of *sg3_utils* and won't work with the version shipped with CentOS 6 for example.
 
 
-sas_sd_snic_alias
------------------
+sas_sd_snic_alias and sas_st_snic_alias
+---------------------------------------
 
 Generate udev aliases using the SES-2 subenclosure nickname and bay identifier of each device.
+These scripts can also be used as examples and adapted to your specific needs.
 
-For example, add the following to your udev rules:
+For example, for block devices, add the following to your udev rules:
 
     .. code-block::
 
         KERNEL=="sd*", PROGRAM="/usr/bin/sas_sd_snic_alias %k", SYMLINK+="%c"
 
+Or, for SAS tape drives behind SAS switches (that act as enclosures):
+
+    .. code-block::
+
+        KERNEL=="st*", PROGRAM="/usr/bin/sas_st_snic_alias %k", SYMLINK+="%c"
+
 This should generate udev aliases made of the device subenclosure nickname followed by the bay identifier. In the following case, *io1-jbod1-0* is the subenclosure nickname (here SIM 0 of JBOD #1).
 
     .. code-block::

doc/man/man1/sas_counters.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH SAS_COUNTERS 1 "2023-02-16" "0.4.0" "sasutils"
+.TH SAS_COUNTERS 1 "2023-10-01" "0.5.0" "sasutils"
 .SH NAME
 sas_counters \- show Serial Attached SCSI (SAS) counters
 .

doc/man/man1/sas_devices.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH SAS_DEVICES 1 "2023-02-16" "0.4.0" "sasutils"
+.TH SAS_DEVICES 1 "2023-10-01" "0.5.0" "sasutils"
 .SH NAME
 sas_devices \- show Serial Attached SCSI (SAS) enclosures and devices
 .

doc/man/man1/sas_discover.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH SAS_DISCOVER 1 "2023-02-16" "0.4.0" "sasutils"
+.TH SAS_DISCOVER 1 "2023-10-01" "0.5.0" "sasutils"
 .SH NAME
 sas_discover \- display Serial Attached SCSI (SAS) topology
 .

doc/man/man1/ses_report.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH SES_REPORT 1 "2023-02-16" "0.4.0" "sasutils"
+.TH SES_REPORT 1 "2023-10-01" "0.5.0" "sasutils"
 .SH NAME
 ses_report \- SCSI Enclosure Services (SES) status and metrics reporting utility
 .

doc/txt/sas_counters.txt

@@ -7,9 +7,9 @@ show Serial Attached SCSI (SAS) counters
 ----------------------------------------
 
 :Author: Stephane Thiell <[email protected]>
-:Date:   2023-02-16
+:Date:   2023-10-01
 :Copyright: Apache License Version 2.0
-:Version: 0.4.0
+:Version: 0.5.0
 :Manual section: 1
 :Manual group: sasutils
 

doc/txt/sas_devices.txt

@@ -7,9 +7,9 @@ show Serial Attached SCSI (SAS) enclosures and devices
 ------------------------------------------------------
 
 :Author: Stephane Thiell <[email protected]>
-:Date:   2023-02-16
+:Date:   2023-10-01
 :Copyright: Apache License Version 2.0
-:Version: 0.4.0
+:Version: 0.5.0
 :Manual section: 1
 :Manual group: sasutils
 

doc/txt/sas_discover.txt

@@ -7,9 +7,9 @@ display Serial Attached SCSI (SAS) topology
 -------------------------------------------
 
 :Author: Stephane Thiell <[email protected]>
-:Date:   2023-02-16
+:Date:   2023-10-01
 :Copyright: Apache License Version 2.0
-:Version: 0.4.0
+:Version: 0.5.0
 :Manual section: 1
 :Manual group: sasutils
 

doc/txt/ses_report.txt

@@ -7,9 +7,9 @@ SCSI Enclosure Services (SES) status and metrics reporting utility
 ------------------------------------------------------------------
 
 :Author: Stephane Thiell <[email protected]>
-:Date:   2023-02-16
+:Date:   2023-10-01
 :Copyright: Apache License Version 2.0
-:Version: 0.4.0
+:Version: 0.5.0
 :Manual section: 1
 :Manual group: sasutils
 

sasutils-el7.spec

@@ -1,5 +1,5 @@
 Name:           sasutils
-Version:        0.3.13
+Version:        0.5.0
 Release:        1%{?dist}
 Summary:        Serial Attached SCSI (SAS) utilities
 
@@ -52,6 +52,9 @@ install -p -m 0644 doc/man/man1/ses_report.1 %{buildroot}/%{_mandir}/man1/
 %license LICENSE.txt
 
 %changelog
+* Sun Oct  1 2023 Stephane Thiell <[email protected]> 0.5.0-1
+- update version
+
 * Thu Feb 16 2023 Stephane Thiell <[email protected]> 0.4.0-1
 - update version
 

sasutils.spec

@@ -1,5 +1,5 @@
 Name:           sasutils
-Version:        0.4.0
+Version:        0.5.0
 Release:        1%{?dist}
 Summary:        Serial Attached SCSI (SAS) utilities
 
@@ -52,6 +52,9 @@ install -p -m 0644 doc/man/man1/ses_report.1 %{buildroot}/%{_mandir}/man1/
 %license LICENSE.txt
 
 %changelog
+* Sun Oct  1 2023 Stephane Thiell <[email protected]> 0.5.0-1
+- update version
+
 * Thu Feb 16 2023 Stephane Thiell <[email protected]> 0.4.0-1
 - update version
 

setup.py

@@ -17,7 +17,7 @@
 
 from setuptools import setup, find_packages
 
-VERSION = '0.4.0'
+VERSION = '0.5.0'
 
 setup(name='sasutils',
       version=VERSION,