~ubuntu-branches/ubuntu/intrepid/sg3-utils/intrepid

« back to all changes in this revision

Viewing changes to README.tru64

  • Committer: Bazaar Package Importer
  • Author(s): Luk Claes
  • Date: 2006-11-05 17:23:29 UTC
  • mfrom: (1.1.4 upstream) (3.1.2 edgy)
  • Revision ID: james.westby@ubuntu.com-20061105172329-l4loha00sk36qz6k
* Non-maintainer upload.
* Fix FTBFS due to old syscall usage (Closes: #395512).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Introduction
 
2
============
 
3
The Tru64 port of sg3_utils contains those utilities that are _not_
 
4
specific to Linux. In some cases a utility could be ported but
 
5
requires more work. An example is sg_dd which needs more work
 
6
beyond the SCSI command pass through mechanism.
 
7
 
 
8
Supported Utilities
 
9
===================
 
10
Here is a list of utilities that have been ported:
 
11
    sg_format
 
12
    sg_get_config
 
13
    sg_ident
 
14
    sg_inq          [dropped ATA IDENTIFY DEVICE capability]
 
15
    sg_logs
 
16
    sg_luns
 
17
    sg_modes
 
18
    sg_persist
 
19
    sg_prevent
 
20
    sg_rdac
 
21
    sg_read_long
 
22
    sg_readcap
 
23
    sg_reassign
 
24
    sg_requests
 
25
    sg_rmsn
 
26
    sg_rtpg
 
27
    sg_senddiag
 
28
    sg_ses
 
29
    sg_start
 
30
    sg_sync
 
31
    sg_turs
 
32
    sg_verify
 
33
    sg_vpd
 
34
    sg_wr_mode
 
35
    sg_write_long
 
36
 
 
37
Most utility names are indicative of the main SCSI command
 
38
that they execute.  Some utilities are slightly higher level, for
 
39
example sg_ses fetches SCSI Enclosure Services (SES) status pages and
 
40
can send control pages. Each utility has a man page (placed in
 
41
section 8). An overview of sg3_utils can be found at:
 
42
http://www.torque.net/sg/sg3_utils.html .
 
43
A copy of the "sg3_utils.html" file is in the "doc" subdirectory.
 
44
 
 
45
 
 
46
See the INSTALL file (at the end) for instructions on how to build
 
47
sg3_utils on Tru64. Files that are Tru64 specific use the "osf1"
 
48
suffix (apart from this one). Some man pages have examples which
 
49
use linux device names which hopefully will not confuse the Tru64 users.
 
50
 
 
51
 
 
52
Details
 
53
=======
 
54
The ported utilities listed above, all use SCSI command functions
 
55
declared in sg_cmds.h and implemented in sg_cmds.c . The sg_cmds.c
 
56
file passes SCSI commands to the host operating system via
 
57
an interface declared in sg_pt.h . There are currently three
 
58
implementations of that interface depending on the host operating
 
59
system:
 
60
  - sg_pt_linux.c
 
61
  - sg_pt_osf1.c  [Tru64]
 
62
  - sg_pt_freebsd.c
 
63
 
 
64
The sg_pt_osf1.c file uses the Tru64 CAM SCSI pass through
 
65
mechanism.
 
66
 
 
67
Tru64 does not have general library support for "long" options
 
68
(e.g. "--verbose") which are used extensively by most of the
 
69
utilities in this package. Rather than change all the utilities
 
70
and their man/web pages a local implementation of the missing
 
71
function "getopt_long()" has been placed in the "getopt_long"
 
72
subdirectory. Currently only the Tru64 port uses it.
 
73
 
 
74
 
 
75
Doug Gilbert
 
76
29th May 2006