aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog2
-rw-r--r--README27
-rw-r--r--debian/changelog2
-rw-r--r--examples/sg_unmap_example.txt10
-rw-r--r--sg3_utils.spec2
-rw-r--r--src/sg_unmap.c4
6 files changed, 35 insertions, 12 deletions
diff --git a/ChangeLog b/ChangeLog
index 2355f4bd..63e55cc1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -2,7 +2,7 @@ Each utility has its own version number, date of last change and
some description at the top of its ".c" file. All utilities in the main
directory have their own "man" pages. There is also a sg3_utils man page.
-Changelog for sg3_utils-1.28 [20090827] [svn: r291]
+Changelog for sg3_utils-1.28 [20090906] [svn: r299]
- sg_unmap: new utility for thin provisioning
- add examples/sg_unmap_example.txt
- sg_read_block_limits: new utility for tape drives
diff --git a/README b/README
index 45a70047..96d733d6 100644
--- a/README
+++ b/README
@@ -6,7 +6,7 @@ This package contains low level utilities for devices that use a SCSI
command set. Apart from SCSI parallel interface (SPI) devices, the SCSI
command set is used by ATAPI devices (CD/DVDs and tapes), USB mass storage
devices, Fibre Channel disks, IEEE 1394 storage devices (that use the
-"SBP" protocol), SAS, iSCSI and FCoE (and others).
+"SBP" protocol), SAS, iSCSI and FCoE devices (amongst others).
This package originally targeted the Linux SCSI subsystem. Since most
operating systems contain a SCSI command pass-through mechanism, many
@@ -150,6 +150,29 @@ Darwin is not supported because the Apple folks do not want to give their
users a pass-through SCSI interface. The author has read about creative
hackers using a VM containing a real OS to circumvent the Apple restriction.
+Building
+========
+This package is designed to be built with the usual:
+ "./configure ; make ; make install"
+sequence. In some situations that may need to be prefixed by a call to
+the "./autogen.sh" script which invokes autoconf and automake. That in turn
+may require packages containing those utilities to be installed. The
+libtool utility is also required. Naturally a C compiler is required
+and due to the vagaries of libtool a C++ compiler also.
+
+The C code in this package is written for portability rather than speed.
+It assumes a level of C99 compliance and favours POSIX system and library
+calls over OS specific calls.
+
+More generic build information can be found in the INSTALL file.
+
+In Linux there are package build files for "rpm" based and for "deb" based
+systems. The 'sg3_utils.spec' file in the main directory can be used like
+this: 'rpmbuild -ba sg3_utils.spec' in a rpmbuild tree SPECS directory.
+The 'build_debian.sh' script should build several "deb" packages and place
+them in the parent directory. In debian based systems doing
+a 'apt-get install build-essential' is one way to get most of build
+environment needed if it has not already been loaded.
Warning
=======
@@ -338,4 +361,4 @@ See http://sg.danny.cz/sg/tools.html
Doug Gilbert
-27th August 2009
+6th September 2009
diff --git a/debian/changelog b/debian/changelog
index ac32f681..29322326 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,7 +2,7 @@ sg3-utils (1.28-0.1) unstable; urgency=low
* New upstream version
- -- Doug Gilbert <dgilbert@interlog.com> Thu, 27 Aug 2009 13:00:00 -0400
+ -- Doug Gilbert <dgilbert@interlog.com> Sun, 06 Sep 2009 12:00:00 -0400
sg3-utils (1.27-0.1) unstable; urgency=low
diff --git a/examples/sg_unmap_example.txt b/examples/sg_unmap_example.txt
index 34b7e66f..1a5f44d0 100644
--- a/examples/sg_unmap_example.txt
+++ b/examples/sg_unmap_example.txt
@@ -2,11 +2,11 @@
# This is an example of the contents of a file that can be given to sg_unmap
# For example, assume the /dev/sdc is a scratch disk (e.g. one made by the
# scsi_debug kernel module) then:
-# sg_unmap --in=sg_map_example.txt /dev/sdc
+# sg_unmap --in=sg_unmap_example.txt /dev/sdc
-0x12345678,1 # unmap LBA 0x12345678
+0x12345677,1 # unmap LBA 0x12345677
0x12345678 2 # unmap LBA 0x12345678 and 0x12345679
-0x12345678 3333 # unmap 3333 blocks starting at LBA 0x12345678
+0x12340000 3333 # unmap 3333 blocks starting at LBA 0x12340000
0X5a5a5a5a5a 0 # unmaps 0 blocks (i.e. does nothing)
@@ -21,9 +21,9 @@
# open /dev/sg2 with flags=0x802
# unmap cdb: 42 00 00 00 00 00 00 00 58 00
# unmap parameter list:
-# 00 56 00 50 00 00 00 00 00 00 00 00 12 34 56 78
+# 00 56 00 50 00 00 00 00 00 00 00 00 12 34 56 77
# 00 00 00 01 00 00 00 00 00 00 00 00 12 34 56 78
-# 00 00 00 02 00 00 00 00 00 00 00 00 12 34 56 78
+# 00 00 00 02 00 00 00 00 00 00 00 00 12 34 00 00
# 00 00 0d 05 00 00 00 00 00 00 00 5a 5a 5a 5a 5a
# 00 00 00 00 00 00 00 00 00 00 00 00 00 a5 a5 a5
# 00 00 00 07 00 00 00 00
diff --git a/sg3_utils.spec b/sg3_utils.spec
index a457e697..1593c96e 100644
--- a/sg3_utils.spec
+++ b/sg3_utils.spec
@@ -79,7 +79,7 @@ fi
%{_libdir}/*.la
%changelog
-* Thu Aug 27 2009 - dgilbert at interlog dot com
+* Sun Sep 06 2009 - dgilbert at interlog dot com
- add sg_unmap, sg_read_block_limits
* sg3_utils-1.28
diff --git a/src/sg_unmap.c b/src/sg_unmap.c
index 7d9b079c..98e85747 100644
--- a/src/sg_unmap.c
+++ b/src/sg_unmap.c
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005-2009 Douglas Gilbert.
+ * Copyright (c) 2009 Douglas Gilbert.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
@@ -51,7 +51,7 @@
* logical blocks.
*/
-static char * version_str = "1.00 20090611";
+static char * version_str = "1.00 20090906";
#define ME "sg_unmap: "