~gandelman-a/ubuntu/oneiric/scsitools/mergeproposal

« back to all changes in this revision

Viewing changes to debian/scsi-spin.8

  • Committer: Adam Gandelman
  • Date: 2011-05-20 17:58:41 UTC
  • mfrom: (6.2.4 debian)
  • Revision ID: adam.gandelman@canonical.com-20110520175841-74orsktetfakacqd
merged

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH scsi-spin 8 "03 September 2001"
 
2
.SH NAME
 
3
scsi-spin \- spin up and down a SCSI device
 
4
.SH SYNOPSIS
 
5
.BI "scsi-spin [-" "options..." "] [" device ]
 
6
.SH DESCRIPTION
 
7
.B scsi-spin
 
8
let the user to manually spin up and down a SCSI device.
 
9
 
 
10
This command is particularly useful if you've got noisy (or hot)
 
11
drives in a machine that you rarely need to access.  This is
 
12
.B not
 
13
the same as the kernel patch that's floating around that will
 
14
automatically spin down the drive after some time.
 
15
.B scsi-spin
 
16
is completely manual, and spinning down a drive that's in use, especially
 
17
the one containing the scsi-spin binary, is probably a
 
18
.B really
 
19
bad idea.
 
20
 
 
21
To avoid running in trouble with such cases,
 
22
.B scsi-spin
 
23
verifies that the device to work on is not currently in use by scanning the
 
24
mounted file system description file for a partition living on it and issue an
 
25
error if this the case.
 
26
 
 
27
.SH OPTIONS
 
28
.TP
 
29
.B -u, --up
 
30
spin up device.
 
31
.TP
 
32
.B -d, --down
 
33
spin down device.
 
34
.TP
 
35
.B -e, --loej
 
36
load or eject medium from drive (use along with
 
37
.B -u
 
38
or
 
39
.B -d
 
40
)
 
41
.TP
 
42
.B -w, --wait=[n]
 
43
wait up to
 
44
.B n
 
45
seconds for the spin up/down command to complete. Default is to return
 
46
immediately after the command was sent to the device.
 
47
Either repeat
 
48
.B -w
 
49
n times or set
 
50
.B n
 
51
to define the time to wait before to report a timeout.
 
52
.TP
 
53
.B -l, --lock
 
54
prevent removal of medium from device.
 
55
.TP
 
56
.B -L, --unlock
 
57
allow removal of medium from device.
 
58
.TP
 
59
.B -I, --oldioctl
 
60
use legacy ioctl interface instead of SG_IO to dialog with device
 
61
(could not be supported on all platforms).
 
62
.B -e
 
63
and
 
64
.B -w
 
65
are not allowed with this option.
 
66
.TP
 
67
.B -v, --verbose=[n]
 
68
verbose mode. Either repeat
 
69
.B -v
 
70
or set
 
71
.B n
 
72
accordingly to increase verbosity. 1 is verbose, 2 is debug (dump SCSI
 
73
commands and Sense buffer).
 
74
.TP
 
75
.B -f, --force
 
76
force spinning up/down the device even if it is in use.
 
77
.TP
 
78
.B -n, --noact
 
79
do nothing but check if the device is in use.
 
80
.TP
 
81
.TP
 
82
.B -p, --proc
 
83
use /proc/mounts instead of /etc/mtab to determine if the device is in use or
 
84
not.
 
85
.TP
 
86
.B device
 
87
the device is any name in the filesystem which points to a SCSI block device
 
88
(sd, scd) or generic SCSI device (sg). See section below.
 
89
 
 
90
.SH SCSI devices naming convention
 
91
.SS Old kernel naming convention
 
92
It is typically
 
93
.I /dev/sd[a-z]
 
94
,
 
95
.I /dev/scd[0-9]*
 
96
or
 
97
.I /dev/sg[0-9]*.
 
98
 
 
99
.SS scsidev naming convention
 
100
It is typically
 
101
.I /dev/scsi/s[rdg]h[0-9]*-e????c?i?l?
 
102
or
 
103
.I /dev/scsi/<aliasname>.
 
104
 
 
105
.SS devfs naming convention
 
106
It is typically
 
107
/dev/scsi/host[0-9]/bus[0-9]/target[0-9]/lun[0-9]/disc (same for cd and generic
 
108
devices) or short name /dev/sd/c[0-9]b[0-9]t[0-9]u[0-9] when
 
109
.B devfsd
 
110
"new compatibility entries" naming scheme is enabled.
 
111
 
 
112
.SH SEE ALSO
 
113
.BR scsiinfo (8),
 
114
.BR sg_start (8),
 
115
.BR sd (4),
 
116
.BR proc (5),
 
117
 
 
118
.SH AUTHORS
 
119
Eric Delaunay <delaunay@debian.org>, 2001
 
120
.br
 
121
Rob Browning <rlb@cs.utexas.edu>, 1998