aboutsummaryrefslogtreecommitdiff
path: root/README.freebsd
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2010-04-24 20:56:46 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2010-04-24 20:56:46 +0000
commit3457b26ece045d246779a9e8f4a1e7cb840d7573 (patch)
tree0c4bb5037062b02b95d09648d721f45e25dcee26 /README.freebsd
parent09fb2873a50d505c755f87013745e06c34826dee (diff)
downloadsg3_utils-3457b26ece045d246779a9e8f4a1e7cb840d7573.tar.gz
bump to 1.30, some spc4r24 updates, sg_read_long --readonly option; spelling
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@338 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'README.freebsd')
-rw-r--r--README.freebsd53
1 files changed, 29 insertions, 24 deletions
diff --git a/README.freebsd b/README.freebsd
index 3a178615..d0da5709 100644
--- a/README.freebsd
+++ b/README.freebsd
@@ -61,41 +61,46 @@ http://sg.danny.cz/sg/sg3_utils.html .
A copy of the "sg3_utils.html" file is in the "doc" subdirectory.
-See the INSTALL file (at the end) for instructions on how to build
-sg3_utils on FreeBSD. If the "./configure ; make" sequence fails, try
-running "./autogen.sh" first. Some man pages have examples which use
-linux device names which hopefully will not confuse the FreeBSD users.
+The executables and library can be built from the source code in
+the tarball and installed with the familiar
+"./configure ; make ; make install" sequence. If this fails try
+running the "./autogen.sh" script prior to that sequence. There
+are generic instruction on configure and friend in the INSTALL file.
+
+Some man pages have examples which use linux device names which
+hopefully will not confuse the FreeBSD users.
+
+Device naming
+=============
+In FreeBSD disks have block names like '/dev/da0' with a corresponding
+pass-through device name like '/dev/pass0'. Use this command
+"camcontrol devlist" to see that SCSI devices available.
Details
=======
-The ported utilities listed above, all use SCSI command functions
-declared in sg_cmds_basic.h and sg_cmds_extra.h . Those SCSI command
-functions are implemented in the corresponding ".c" files. The ".c"
-files pass SCSI commands to the host operating system via
-an interface declared in sg_pt.h . There are currently four
-implementations of that interface depending on the host operating
-system:
+Most of the ported utilities listed above use SCSI command functions
+declared in sg_cmds_*.h headers . Those SCSI command functions are
+implemented in the corresponding ".c" files. The ".c" files pass SCSI
+commands to the host operating system via an interface declared in sg_pt.h .
+There are currently five implementations of that interface depending on
+the host operating system:
- sg_pt_linux.c
- sg_pt_freebsd.c
- sg_pt_osf1.c [Tru64]
- sg_pt_win32.c
+ - sg_pt_solaris.c
-The sg_pt_freebsd.c file uses the FreeBSD CAM SCSI pass through
-mechanism. Hence only FreeBSD device nodes that support CAM can
-be used. These can be viewed with the "camcontrol devlist"
-command. To access ATAPI devices (e.g. ATAPI DVD drives) the
-kernel may need to be configured with the "atapicam" device.
-
-Disks is FreeBSD have names like '/dev/da0' while the corresponding
-pass-through device may be '/dev/pass0'.
+The sg_pt_freebsd.c file uses the FreeBSD CAM SCSI pass through mechanism.
+Hence only FreeBSD device nodes that support CAM can be used. These can be
+viewed with the "camcontrol devlist" command. To access ATAPI devices (e.g.
+ATAPI DVD drives) the kernel may need to be configured with the "atapicam"
+device.
-At the present time these utilities have been lightly tested on a
-FreeBSD version 7.0 system with some SCSI disks, a SCSI tape
-drive and an ATAPI CD drive.
+FreeBSD 8.0 is the most recent version of FreeBSD tested with these
+utilities.
-See the FreeBSD section in the INSTALL file for install directions.
Doug Gilbert
-20th September 2009
+10th April 2010