;;; GNU Guix --- Functional package management for GNU
;;; Copyright © 2016 Chris Marusich <cmmarusich@gmail.com>
;;; Copyright © 2018, 2020, 2021 Tobias Geerinckx-Rice <me@tobias.gr>
;;;
;;; This file is part of GNU Guix.
;;;
;;; GNU Guix is free software; you can redistribute it and/or modify it
;;; under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 3 of the License, or (at
;;; your option) any later version.
;;;
;;; GNU Guix is distributed in the hope that it will be useful, but
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with GNU Guix.  If not, see <http://www.gnu.org/licenses/>.

(define-module (gnu packages scsi)
  #:use-module ((guix licenses)
                #:select (gpl2+ bsd-2 bsd-3))
  #:use-module (guix packages)
  #:use-module (guix download)
  #:use-module (guix build-system gnu))

(define-public sg3-utils
  (package
    (name "sg3-utils")
    (version "1.46")
    (source (origin
              (method url-fetch)
              (uri (string-append "http://sg.danny.cz/sg/p/sg3_utils-"
                                  version ".tar.xz"))
              (sha256
               (base32
                "185rlxppnsmi6q7garfhglmw31gji2ff24xg2yjk3klk1fqnihjr"))))
    (build-system gnu-build-system)
    (home-page "http://sg.danny.cz/sg/sg3_utils.html")
    (synopsis "SCSI device utilities")
    (description
     "sg3-utils is a collection of utilities for devices that use the Small
Computer System Interface (@dfn{SCSI}) command set.  It includes utilities to
read data from, write data to, control, modify, and query the state of SCSI
devices.

For example, this package provides command-line tools to:
@itemize
@item copy data based on @code{dd} syntax and semantics (called @command{sg_dd},
@command{sgp_dd}, and @command{sgm_dd})
@item check @code{INQUIRY} data and @code{VPD pages} (@command{sg_inq})
@item check mode and log pages (@command{sginfo}, @command{sg_modes}, and
@command{sg_logs})
@item spin up and down disks (@command{sg_start})
@item do self-tests (@code{sg_senddiag})
@item parse sense data (@code{sg_decode_sense})
@item and perform various other functions.
@end itemize

In addition, this package includes a library, called libsgutils, which can be
used in C and C++ programs to interact with SCSI devices.")
    ;; See README: "All utilities and libraries have either a "2 clause" BSD
    ;;   license or are "GPL-2ed". [...] That BSD license was updated from the
    ;;   "3 clause" to the newer "2 clause" version on 20180119. To save space
    ;;   various source code files refer to a file called "BSD_LICENSE" [...]."
    ;; Some files (like sg_compare_and_write.c) retain their 3-clause headers!
    (license (list gpl2+ bsd-2 bsd-3))))
 (uuid-&gt;string (uuid "00CA-050E" 'fat32))
  ⇒ "CA-50E"
  (string-&gt;uuid "CA-50E" 'fat32)
  ⇒ #f

* gnu/system/uuid.scm (fat-uuid-&gt;string): Pad digits with zeros.
* tests/uuid.scm ("uuid, FAT32, leading zeros preserved"): New test.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2018-05-19 00:14:52 +0200'>2018-05-19</span></td><td><a href='/guix/commit/tests/uuid.scm?id=263c9941a1e523b360ca9f42d1ed6b11e6e6e285'>uuid: 'uuid' returns #f when 'string-&gt;uuid' returns #f.</a><span class='msg-avail'>...<span class='msg-tooltip'>* gnu/system/uuid.scm (uuid): When STR is not a literal, return #f when
'string-&gt;uuid' returns #f.
* tests/uuid.scm ("uuid, dynamic value"): New test.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2017-10-06 14:16:23 +0200'>2017-10-06</span></td><td><a href='/guix/commit/tests/uuid.scm?id=0b12324284f3fbf378d363070f91b794058ae570'>uuid: Fix typo in 'uuid=?' test.</a><span class='msg-avail'>...<span class='msg-tooltip'>* tests/uuid.scm ("uuid=?"): Change to 'test-assert'.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2017-10-05 12:09:17 +0200'>2017-10-05</span></td><td><a href='/guix/commit/tests/uuid.scm?id=aed1f1b049f6e7ef9f2f2db58bdca6cd3effe94b'>uuid: Add 'uuid=?' and use it.</a><span class='msg-avail'>...<span class='msg-tooltip'>* gnu/system/uuid.scm (uuid=?): New procedure.
* tests/uuid.scm ("uuid=?"): New test.
* gnu/build/file-systems.scm (partition-uuid-predicate)
(luks-partition-uuid-predicate): Use it instead of 'bytevector=?'.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2017-09-22 18:40:57 +0200'>2017-09-22</span></td><td><a href='/guix/commit/tests/uuid.scm?id=8a7d81a5e23c4d59fbabf2550db32d4ba5572e4b'>uuid: Add a parser for FAT32 UUIDs.</a><span class='msg-avail'>...<span class='msg-tooltip'>* gnu/system/uuid.scm (%fat32-uuid-rx): New variable.
(string-&gt;fat32-uuid): New procedure.
(%uuid-parsers): Add it.
* tests/uuid.scm ("uuid, FAT32, format preserved"): New test.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2017-09-14 00:10:13 +0200'>2017-09-14</span></td><td><a href='/guix/commit/tests/uuid.scm?id=8f3b63b5d73c0b49139c8a20b7576732abfdeeb8'>uuid: Move tests to 'tests/uuid.scm'.</a><span class='msg-avail'>...<span class='msg-tooltip'>* tests/file-systems.scm ("uuid-&gt;string", "string-&gt;uuid")
("uuid", "uuid, syntax error"): Move to...
* tests/uuid.scm: ... here.  New file.
("uuid, ISO-9660, format preserved"): New test.
</span></span></td><td>Ludovic Courtès</td></tr>