source: general/sysutils/sg3_utils.xml@ 66d551c

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 66d551c was 66d551c, checked in by Bruce Dubbs <bdubbs@…>, 22 months ago

Tag a lot of utilities and libraries

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24245 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 35.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY sg3_utils-download-http "http://sg.danny.cz/sg/p/sg3_utils-&sg3_utils-version;.tar.xz">
8 <!ENTITY sg3_utils-download-ftp " ">
9 <!ENTITY sg3_utils-md5sum "3a1ba25fe7b43577de4a5c1edb018526">
10 <!ENTITY sg3_utils-size "968 KB">
11 <!ENTITY sg3_utils-buildsize "24 MB">
12 <!ENTITY sg3_utils-time "0.2 SBU">
13]>
14
15<sect1 id="sg3_utils" xreflabel="sg3_utils-&sg3_utils-version;">
16 <?dbhtml filename="sg3_utils.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>sg3_utils-&sg3_utils-version;</title>
24
25 <indexterm zone="sg3_utils">
26 <primary sortas="a-sg3_utils">sg3_utils</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to sg3_utils</title>
31
32 <para>
33 The <application>sg3_utils</application> package contains low level
34 utilities for devices that use a SCSI command set. Apart from SCSI parallel
35 interface (SPI) devices, the SCSI command set is used by ATAPI devices
36 (CD/DVDs and tapes), USB mass storage devices, Fibre Channel disks, IEEE
37 1394 storage devices (that use the "SBP" protocol), SAS, iSCSI and FCoE
38 devices (amongst others).
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&sg3_utils-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&sg3_utils-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &sg3_utils-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &sg3_utils-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &sg3_utils-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &sg3_utils-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77<!-- No longer needed as 1.44 fixes the sysmacros.h use
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch:
83 <ulink url="&patch-root;/sg3_utils-&sg3_utils-version;-glibc_2.28-fixes-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
87-->
88
89 <para condition="html" role="usernotes">User Notes:
90 <ulink url="&blfs-wiki;/sg3_utils"/>
91 </para>
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of sg3_utils</title>
96
97 <para>
98 Install <application>sg3_utils</application> by running the following
99 commands:
100 </para>
101
102<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
103make</userinput></screen>
104
105 <para>
106 This package does not come with a test suite.
107 </para>
108
109 <para>
110 Now, as the <systemitem class="username">root</systemitem> user:
111 </para>
112
113<screen role="root"><userinput>make install</userinput></screen>
114
115 </sect2>
116
117 <sect2 role="commands">
118 <title>Command Explanations</title>
119
120 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
121 href="../../xincludes/static-libraries.xml"/>
122
123 </sect2>
124
125 <sect2 role="content">
126 <title>Contents</title>
127
128 <segmentedlist>
129 <segtitle>Installed Programs</segtitle>
130 <segtitle>Installed Library</segtitle>
131 <segtitle>Installed Directories</segtitle>
132
133 <seglistitem>
134 <seg>
135 scsi_logging_level, scsi_mandat, scsi_readcap, scsi_ready, scsi_satl,
136 scsi_start, scsi_stop, scsi_temperature, sg_bg_ctl, sg_compare_and_write,
137 sg_copy_results, sg_dd, sg_decode_sense, sg_emc_trespass, sg_format,
138 sg_get_config, sg_get_lba_status, sg_ident, sg_inq, sg_logs, sg_luns,
139 sg_map, sg_map26, sg_modes, sg_opcodes, sg_persist, sg_prevent,
140 sg_raw, sg_rbuf, sg_rdac, sg_read, sg_read_attr, sg_read_block_limits,
141 sg_read_buffer, sg_read_long, sg_readcap, sg_reassign, sg_referrals,
142 sg_rep_zones, sg_requests, sg_reset, sg_reset_wp, sg_rmsn, sg_rtpg,
143 sg_safte, sg_sanitize, sg_sat_identify, sg_sat_phy_event,
144 sg_sat_read_gplog, sg_sat_set_features, sg_scan, sg_seek, sg_senddiag, sg_ses,
145 sg_ses_microcode, sg_start, sg_stpg, sg_stream_ctl, sg_sync, sg_test_rwbuf,
146 sg_turs, sg_unmap, sg_verify, sg_vpd, sg_wr_mode, sg_write_buffer,
147 sg_write_long, sg_write_same, sg_write_verify, sg_write_x, sg_xcopy, sg_zone,
148 sginfo, sgm_dd, and sgp_dd
149 </seg>
150 <seg>
151 libsgutils2.so
152 </seg>
153 <seg>
154 None
155 </seg>
156 </seglistitem>
157 </segmentedlist>
158
159 <variablelist>
160 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
161 <?dbfo list-presentation="list"?>
162 <?dbhtml list-presentation="table"?>
163
164 <varlistentry id="scsi_logging_level">
165 <term><command>scsi_logging_level</command></term>
166 <listitem>
167 <para>
168 accesses Linux SCSI logging level information
169 </para>
170 <indexterm zone="sg3_utils scsi_logging_level">
171 <primary sortas="b-scsi_logging_level">scsi_logging_level</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="scsi_mandat">
177 <term><command>scsi_mandat</command></term>
178 <listitem>
179 <para>
180 checks SCSI device support for mandatory commands
181 </para>
182 <indexterm zone="sg3_utils scsi_mandat">
183 <primary sortas="b-scsi_mandat">scsi_mandat</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="scsi_readcap">
189 <term><command>scsi_readcap</command></term>
190 <listitem>
191 <para>
192 does the SCSI READ CAPACITY command on disks
193 </para>
194 <indexterm zone="sg3_utils scsi_readcap">
195 <primary sortas="b-scsi_readcap">scsi_readcap</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="scsi_ready">
201 <term><command>scsi_ready</command></term>
202 <listitem>
203 <para>
204 does the SCSI TEST UNIT READY on devices
205 </para>
206 <indexterm zone="sg3_utils scsi_ready">
207 <primary sortas="b-scsi_ready">scsi_ready</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="scsi_satl">
213 <term><command>scsi_satl</command></term>
214 <listitem>
215 <para>
216 checks for SCSI to ATA Translation (SAT) device support
217 </para>
218 <indexterm zone="sg3_utils scsi_satl">
219 <primary sortas="b-scsi_satl">scsi_satl</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="scsi_start">
225 <term><command>scsi_start</command></term>
226 <listitem>
227 <para>
228 starts one or more SCSI disks
229 </para>
230 <indexterm zone="sg3_utils scsi_start">
231 <primary sortas="b-scsi_start">scsi_start</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="scsi_stop">
237 <term><command>scsi_stop</command></term>
238 <listitem>
239 <para>
240 stops one or more SCSI disks
241 </para>
242 <indexterm zone="sg3_utils scsi_stop">
243 <primary sortas="b-scsi_stop">scsi_stop</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="scsi_temperature">
249 <term><command>scsi_temperature</command></term>
250 <listitem>
251 <para>
252 fetches the temperature of a SCSI device
253 </para>
254 <indexterm zone="sg3_utils scsi_temperature">
255 <primary sortas="b-scsi_temperature">scsi_temperature</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="sg_bg_ctl">
261 <term><command>sg_bg_ctl</command></term>
262 <listitem>
263 <para>
264 performs a SCSI BACKGROUND CONTROL command on a device to perform
265 "advanced background operations"
266 </para>
267 <indexterm zone="sg3_utils sg_bg_ctl">
268 <primary sortas="b-sg_bg_ctl">sg_bg_ctl</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="sg_compare_and_write">
274 <term><command>sg_compare_and_write</command></term>
275 <listitem>
276 <para>
277 sends the SCSI COMPARE AND WRITE command to device
278 </para>
279 <indexterm zone="sg3_utils sg_compare_and_write">
280 <primary sortas="b-sg_compare_and_write">sg_compare_and_write</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="sg_copy_results">
286 <term><command>sg_copy_results</command></term>
287 <listitem>
288 <para>
289 sends the SCSI RECEIVE COPY RESULTS command (XCOPY related)
290 </para>
291 <indexterm zone="sg3_utils sg_copy_results">
292 <primary sortas="b-sg_copy_results">sg_copy_results</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="sg_dd">
298 <term><command>sg_dd</command></term>
299 <listitem>
300 <para>
301 copies data to and from files and devices. Specialised for
302 devices that understand the SCSI command set
303 </para>
304 <indexterm zone="sg3_utils sg_dd">
305 <primary sortas="b-sg_dd">sg_dd</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="sg_decode_sense">
311 <term><command>sg_decode_sense</command></term>
312 <listitem>
313 <para>
314 takes SCSI sense data in binary or as a sequence
315 of ASCII hexadecimal bytes and decodes it
316 </para>
317 <indexterm zone="sg3_utils sg_decode_sense">
318 <primary sortas="b-sg_decode_sense">sg_decode_sense</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="sg_emc_trespass">
324 <term><command>sg_emc_trespass</command></term>
325 <listitem>
326 <para>
327 changes ownership of a LUN from another Service-Processor to
328 this one
329 </para>
330 <indexterm zone="sg3_utils sg_emc_trespass">
331 <primary sortas="b-sg_emc_trespass">sg_emc_trespass</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="sg_format">
337 <term><command>sg_format</command></term>
338 <listitem>
339 <para>
340 formats or resizes a SCSI disk (perhaps changes its block size)
341 </para>
342 <indexterm zone="sg3_utils sg_format">
343 <primary sortas="b-sg_format">sg_format</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="sg_get_config">
349 <term><command>sg_get_config</command></term>
350 <listitem>
351 <para>
352 sends a SCSI GET CONFIGURATION command (MMC-4 +)
353 </para>
354 <indexterm zone="sg3_utils sg_get_config">
355 <primary sortas="b-sg_get_config">sg_get_config</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="sg_get_elem_status">
361 <term><command>sg_get_elem_status</command></term>
362 <listitem>
363 <para>
364 sends a SCSI GET PHYSICAL ELEMENT STATUS command to a device
365 </para>
366 <indexterm zone="sg3_utils sg_get_elem_status">
367 <primary sortas="b-sg_get_elem_status">sg_get_elem_status</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="sg_get_lba_status">
373 <term><command>sg_get_lba_status</command></term>
374 <listitem>
375 <para>
376 sends the SCSI GET LBA STATUS command
377 </para>
378 <indexterm zone="sg3_utils sg_get_lba_status">
379 <primary sortas="b-sg_get_lba_status">sg_get_lba_status</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="sg_ident">
385 <term><command>sg_ident</command></term>
386 <listitem>
387 <para>
388 sends a SCSI REPORT or SET IDENTIFYING INFORMATION command
389 </para>
390 <indexterm zone="sg3_utils sg_ident">
391 <primary sortas="b-sg_ident">sg_ident</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="sginfo">
397 <term><command>sginfo</command></term>
398 <listitem>
399 <para>
400 access mode page information for a SCSI (or ATAPI) device
401 </para>
402 <indexterm zone="sg3_utils sginfo">
403 <primary sortas="b-sginfo">sginfo</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="sg_inq">
409 <term><command>sg_inq</command></term>
410 <listitem>
411 <para>
412 sends a SCSI INQUIRY or ATA IDENTIFY (PACKET) DEVICE command and
413 outputs the response
414 </para>
415 <indexterm zone="sg3_utils sg_inq">
416 <primary sortas="b-sg_inq">sg_inq</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="sg_logs">
422 <term><command>sg_logs</command></term>
423 <listitem>
424 <para>
425 access log pages with SCSI LOG SENSE command
426 </para>
427 <indexterm zone="sg3_utils sg_logs">
428 <primary sortas="b-sg_logs">sg_logs</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="sg_luns">
434 <term><command>sg_luns</command></term>
435 <listitem>
436 <para>
437 sends the SCSI REPORT LUNS command
438 </para>
439 <indexterm zone="sg3_utils sg_luns">
440 <primary sortas="b-sg_luns">sg_luns</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="sg_map">
446 <term><command>sg_map</command></term>
447 <listitem>
448 <para>
449 displays mapping between linux sg and other SCSI devices
450 </para>
451 <indexterm zone="sg3_utils sg_map">
452 <primary sortas="b-sg_map">sg_map</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="sg_map26">
458 <term><command>sg_map26</command></term>
459 <listitem>
460 <para>
461 maps a special file to a SCSI generic (sg) device (or vice versa)
462 </para>
463 <indexterm zone="sg3_utils sg_map26">
464 <primary sortas="b-sg_map26">sg_map26</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="sgm_dd">
470 <term><command>sgm_dd</command></term>
471 <listitem>
472 <para>
473 copies data to and from files and devices. Specialized for
474 devices that understand the SCSI command set and does memory mapped
475 transfers from sg devices
476 </para>
477 <indexterm zone="sg3_utils sgm_dd">
478 <primary sortas="b-sgm_dd">sgm_dd</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="sg_modes">
484 <term><command>sg_modes</command></term>
485 <listitem>
486 <para>
487 reads mode pages with SCSI MODE SENSE command
488 </para>
489 <indexterm zone="sg3_utils sg_modes">
490 <primary sortas="b-sg_modes">sg_modes</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 <varlistentry id="sg_opcodes">
496 <term><command>sg_opcodes</command></term>
497 <listitem>
498 <para>
499 reports information on supported SCSI commands or task
500 management functions
501 </para>
502 <indexterm zone="sg3_utils sg_opcodes">
503 <primary sortas="b-sg_opcodes">sg_opcodes</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="sgp_dd">
509 <term><command>sgp_dd</command></term>
510 <listitem>
511 <para>
512 copies data to and from files and devices. Specialized for
513 devices that understand the SCSI command set
514 </para>
515 <indexterm zone="sg3_utils sgp_dd">
516 <primary sortas="b-sgp_dd">sgp_dd</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="sg_persist">
522 <term><command>sg_persist</command></term>
523 <listitem>
524 <para>
525 sends a SCSI PERSISTENT RESERVE (IN or OUT) command to
526 manipulate registrations and reservations
527 </para>
528 <indexterm zone="sg3_utils sg_persist">
529 <primary sortas="b-sg_persist">sg_persist</primary>
530 </indexterm>
531 </listitem>
532 </varlistentry>
533
534 <varlistentry id="sg_prevent">
535 <term><command>sg_prevent</command></term>
536 <listitem>
537 <para>
538 sends a SCSI PREVENT ALLOW MEDIUM REMOVAL command
539 </para>
540 <indexterm zone="sg3_utils sg_prevent">
541 <primary sortas="b-sg_prevent">sg_prevent</primary>
542 </indexterm>
543 </listitem>
544 </varlistentry>
545
546 <varlistentry id="sg_raw">
547 <term><command>sg_raw</command></term>
548 <listitem>
549 <para>
550 sends an arbitrary SCSI command to a device
551 </para>
552 <indexterm zone="sg3_utils sg_raw">
553 <primary sortas="b-sg_raw">sg_raw</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 <varlistentry id="sg_rbuf">
559 <term><command>sg_rbuf</command></term>
560 <listitem>
561 <para>
562 reads data using SCSI READ BUFFER command
563 </para>
564 <indexterm zone="sg3_utils sg_rbuf">
565 <primary sortas="b-sg_rbuf">sg_rbuf</primary>
566 </indexterm>
567 </listitem>
568 </varlistentry>
569
570 <varlistentry id="sg_rdac">
571 <term><command>sg_rdac</command></term>
572 <listitem>
573 <para>
574 displays or modifies RDAC Redundant Controller Page
575 </para>
576 <indexterm zone="sg3_utils sg_rdac">
577 <primary sortas="b-sg_rdac">sg_rdac</primary>
578 </indexterm>
579 </listitem>
580 </varlistentry>
581
582 <varlistentry id="sg_read">
583 <term><command>sg_read</command></term>
584 <listitem>
585 <para>
586 reads blocks of data continually from the same offset
587 </para>
588 <indexterm zone="sg3_utils sg_read">
589 <primary sortas="b-sg_read">sg_read</primary>
590 </indexterm>
591 </listitem>
592 </varlistentry>
593
594 <varlistentry id="sg_read_attr">
595 <term><command>sg_read_attr</command></term>
596 <listitem>
597 <para>
598 performs a SCSI READ ATTRIBUTE command on a device
599 </para>
600 <indexterm zone="sg3_utils sg_read_attr">
601 <primary sortas="b-sg_read_attr">sg_read_attr</primary>
602 </indexterm>
603 </listitem>
604 </varlistentry>
605
606 <varlistentry id="sg_read_block_limits">
607 <term><command>sg_read_block_limits</command></term>
608 <listitem>
609 <para>
610 sends a SCSI READ BLOCK LIMITS command
611 </para>
612 <indexterm zone="sg3_utils sg_read_block_limits">
613 <primary sortas="b-sg_read_block_limits">sg_read_block_limits</primary>
614 </indexterm>
615 </listitem>
616 </varlistentry>
617
618 <varlistentry id="sg_read_buffer">
619 <term><command>sg_read_buffer</command></term>
620 <listitem>
621 <para>
622 sends a SCSI READ BUFFER command
623 </para>
624 <indexterm zone="sg3_utils sg_read_buffer">
625 <primary sortas="b-sg_read_buffer">sg_read_buffer</primary>
626 </indexterm>
627 </listitem>
628 </varlistentry>
629
630 <varlistentry id="sg_readcap">
631 <term><command>sg_readcap</command></term>
632 <listitem>
633 <para>
634 sends a SCSI READ CAPACITY command
635 </para>
636 <indexterm zone="sg3_utils sg_readcap">
637 <primary sortas="b-sg_readcap">sg_readcap</primary>
638 </indexterm>
639 </listitem>
640 </varlistentry>
641
642 <varlistentry id="sg_read_long">
643 <term><command>sg_read_long</command></term>
644 <listitem>
645 <para>
646 sends a SCSI READ LONG command
647 </para>
648 <indexterm zone="sg3_utils sg_read_long">
649 <primary sortas="b-sg_read_long">sg_read_long</primary>
650 </indexterm>
651 </listitem>
652 </varlistentry>
653
654 <varlistentry id="sg_reassign">
655 <term><command>sg_reassign</command></term>
656 <listitem>
657 <para>
658 sends a SCSI REASSIGN BLOCKS command
659 </para>
660 <indexterm zone="sg3_utils sg_reassign">
661 <primary sortas="b-sg_reassign">sg_reassign</primary>
662 </indexterm>
663 </listitem>
664 </varlistentry>
665
666 <varlistentry id="sg_referrals">
667 <term><command>sg_referrals</command></term>
668 <listitem>
669 <para>
670 sends the SCSI REPORT REFERRALS command
671 </para>
672 <indexterm zone="sg3_utils sg_referrals">
673 <primary sortas="b-sg_referrals">sg_referrals</primary>
674 </indexterm>
675 </listitem>
676 </varlistentry>
677
678 <varlistentry id="sg_rep_zones">
679 <term><command>sg_rep_zones</command></term>
680 <listitem>
681 <para>
682 sends a SCSI REPORT ZONES command
683 </para>
684 <indexterm zone="sg3_utils sg_rep_zones">
685 <primary sortas="b-sg_rep_zones">sg_rep_zones</primary>
686 </indexterm>
687 </listitem>
688 </varlistentry>
689
690 <varlistentry id="sg_requests">
691 <term><command>sg_requests</command></term>
692 <listitem>
693 <para>
694 sends one or more SCSI REQUEST SENSE commands
695 </para>
696 <indexterm zone="sg3_utils sg_requests">
697 <primary sortas="b-sg_requests">sg_requests</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
702 <varlistentry id="sg_reset">
703 <term><command>sg_reset</command></term>
704 <listitem>
705 <para>
706 sends SCSI device, target, bus or host reset; or checks reset state
707 </para>
708 <indexterm zone="sg3_utils sg_reset">
709 <primary sortas="b-sg_reset">sg_reset</primary>
710 </indexterm>
711 </listitem>
712 </varlistentry>
713
714 <varlistentry id="sg_reset_wp">
715 <term><command>sg_reset_wp</command></term>
716 <listitem>
717 <para>
718 sends a SCSI RESET WRITE POINTER command
719 </para>
720 <indexterm zone="sg3_utils sg_reset_wp">
721 <primary sortas="b-sg_reset_wp">sg_reset_wp</primary>
722 </indexterm>
723 </listitem>
724 </varlistentry>
725
726 <varlistentry id="sg_rmsn">
727 <term><command>sg_rmsn</command></term>
728 <listitem>
729 <para>
730 sends a SCSI READ MEDIA SERIAL NUMBER command
731 </para>
732 <indexterm zone="sg3_utils sg_rmsn">
733 <primary sortas="b-sg_rmsn">sg_rmsn</primary>
734 </indexterm>
735 </listitem>
736 </varlistentry>
737
738 <varlistentry id="sg_rtpg">
739 <term><command>sg_rtpg</command></term>
740 <listitem>
741 <para>
742 sends a SCSI REPORT TARGET PORT GROUPS command
743 </para>
744 <indexterm zone="sg3_utils sg_rtpg">
745 <primary sortas="b-sg_rtpg">sg_rtpg</primary>
746 </indexterm>
747 </listitem>
748 </varlistentry>
749
750 <varlistentry id="sg_safte">
751 <term><command>sg_safte</command></term>
752 <listitem>
753 <para>
754 fetches status from a SCSI Accessed Fault-Tolerant Enclosure
755 (SAF-TE) device
756 </para>
757 <indexterm zone="sg3_utils sg_safte">
758 <primary sortas="b-sg_safte">sg_safte</primary>
759 </indexterm>
760 </listitem>
761 </varlistentry>
762
763 <varlistentry id="sg_sanitize">
764 <term><command>sg_sanitize</command></term>
765 <listitem>
766 <para>
767 sends a SCSI SANITIZE command
768 </para>
769 <indexterm zone="sg3_utils sg_sanitize">
770 <primary sortas="b-sg_sanitize">sg_sanitize</primary>
771 </indexterm>
772 </listitem>
773 </varlistentry>
774
775 <varlistentry id="sg_sat_identify">
776 <term><command>sg_sat_identify</command></term>
777 <listitem>
778 <para>
779 sends an ATA IDENTIFY (PACKET) DEVICE command via a SCSI to ATA
780 Translation (SAT) layer
781 </para>
782 <indexterm zone="sg3_utils sg_sat_identify">
783 <primary sortas="b-sg_sat_identify">sg_sat_identify</primary>
784 </indexterm>
785 </listitem>
786 </varlistentry>
787
788 <varlistentry id="sg_sat_phy_event">
789 <term><command>sg_sat_phy_event</command></term>
790 <listitem>
791 <para>
792 sends an ATA READ LOG EXT command via a SAT pass through to
793 fetch log page 11h which contains SATA phy event counters
794 </para>
795 <indexterm zone="sg3_utils sg_sat_phy_event">
796 <primary sortas="b-sg_sat_phy_event">sg_sat_phy_event</primary>
797 </indexterm>
798 </listitem>
799 </varlistentry>
800
801
802 <varlistentry id="sg_sat_read_gplog">
803 <term><command>sg_sat_read_gplog</command></term>
804 <listitem>
805 <para>
806 uses an ATA READ LOG EXT command via a SCSI to ATA Translation
807 (SAT) layer
808 </para>
809 <indexterm zone="sg3_utils sg_sat_read_gplog">
810 <primary sortas="b-sg_sat_read_gplog">sg_sat_read_gplog</primary>
811 </indexterm>
812 </listitem>
813 </varlistentry>
814 <varlistentry id="sg_sat_set_features">
815 <term><command>sg_sat_set_features</command></term>
816 <listitem>
817 <para>
818 sends an ATA SET FEATURES command via a SCSI to ATA Translation
819 (SAT) layer
820 </para>
821 <indexterm zone="sg3_utils sg_sat_set_features">
822 <primary sortas="b-sg_sat_set_features">sg_sat_set_features</primary>
823 </indexterm>
824 </listitem>
825 </varlistentry>
826
827 <varlistentry id="sg_scan">
828 <term><command>sg_scan</command></term>
829 <listitem>
830 <para>
831 does a scan of sg devices (or given SCSI/ATAPI/ATA devices) and
832 prints the results
833 </para>
834 <indexterm zone="sg3_utils sg_scan">
835 <primary sortas="b-sg_scan">sg_scan</primary>
836 </indexterm>
837 </listitem>
838 </varlistentry>
839
840 <varlistentry id="sg_seek">
841 <term><command>sg_seek</command></term>
842 <listitem>
843 <para>
844 performs a SCSI SEEK or PRE-FETCH command on a device and it's cache
845 </para>
846 <indexterm zone="sg3_utils sg_seek">
847 <primary sortas="b-sg_seek">sg_seek</primary>
848 </indexterm>
849 </listitem>
850 </varlistentry>
851
852 <varlistentry id="sg_senddiag">
853 <term><command>sg_senddiag</command></term>
854 <listitem>
855 <para>
856 performs a SCSI SEND DIAGNOSTIC command
857 </para>
858 <indexterm zone="sg3_utils sg_senddiag">
859 <primary sortas="b-sg_senddiag">sg_senddiag</primary>
860 </indexterm>
861 </listitem>
862 </varlistentry>
863
864 <varlistentry id="sg_ses">
865 <term><command>sg_ses</command></term>
866 <listitem>
867 <para>
868 sends controls and fetch status from a SCSI Enclosure Services
869 (SES) device
870 </para>
871 <indexterm zone="sg3_utils sg_ses">
872 <primary sortas="b-sg_ses">sg_ses</primary>
873 </indexterm>
874 </listitem>
875 </varlistentry>
876
877 <varlistentry id="sg_ses_microcode">
878 <term><command>sg_ses_microcode</command></term>
879 <listitem>
880 <para>
881 sends microcode to a SCSI enclosure
882 </para>
883 <indexterm zone="sg3_utils sg_ses_microcode">
884 <primary sortas="b-sg_ses_microcode">sg_ses_microcode</primary>
885 </indexterm>
886 </listitem>
887 </varlistentry>
888
889 <varlistentry id="sg_start">
890 <term><command>sg_start</command></term>
891 <listitem>
892 <para>
893 sends a SCSI START STOP UNIT command to start, stop, load or eject
894 medium
895 </para>
896 <indexterm zone="sg3_utils sg_start">
897 <primary sortas="b-sg_start">sg_start</primary>
898 </indexterm>
899 </listitem>
900 </varlistentry>
901
902 <varlistentry id="sg_stpg">
903 <term><command>sg_stpg</command></term>
904 <listitem>
905 <para>
906 sends a SCSI SET TARGET PORT GROUPS command
907 </para>
908 <indexterm zone="sg3_utils sg_stpg">
909 <primary sortas="b-sg_stpg">sg_stpg</primary>
910 </indexterm>
911 </listitem>
912 </varlistentry>
913
914 <varlistentry id="sg_stream_ctl">
915 <term><command>sg_stream_ctl</command></term>
916 <listitem>
917 <para>
918 performs a SCSI STREAM CONTROL or GET STREAM STATUS command on a device
919 to open or close an I/O stream
920 </para>
921 <indexterm zone="sg3_utils sg_stream_ctl">
922 <primary sortas="b-sg_stream_ctl">sg_stream_ctl</primary>
923 </indexterm>
924 </listitem>
925 </varlistentry>
926
927 <varlistentry id="sg_sync">
928 <term><command>sg_sync</command></term>
929 <listitem>
930 <para>
931 sends the scsi command synchronize cache
932 </para>
933 <indexterm zone="sg3_utils sg_sync">
934 <primary sortas="b-sg_sync">sg_sync</primary>
935 </indexterm>
936 </listitem>
937 </varlistentry>
938
939 <varlistentry id="sg_test_rwbuf">
940 <term><command>sg_test_rwbuf</command></term>
941 <listitem>
942 <para>
943 tests the SCSI host adapter by issuing write and read operations
944 on a device's buffer and calculating checksums
945 </para>
946 <indexterm zone="sg3_utils sg_test_rwbuf">
947 <primary sortas="b-sg_test_rwbuf">sg_test_rwbuf</primary>
948 </indexterm>
949 </listitem>
950 </varlistentry>
951
952 <varlistentry id="sg_turs">
953 <term><command>sg_turs</command></term>
954 <listitem>
955 <para>
956 sends one or more SCSI TEST UNIT READY commands
957 </para>
958 <indexterm zone="sg3_utils sg_turs">
959 <primary sortas="b-sg_turs">sg_turs</primary>
960 </indexterm>
961 </listitem>
962 </varlistentry>
963
964 <varlistentry id="sg_unmap">
965 <term><command>sg_unmap</command></term>
966 <listitem>
967 <para>
968 sends a SCSI UNMAP command
969 </para>
970 <indexterm zone="sg3_utils sg_unmap">
971 <primary sortas="b-sg_unmap">sg_unmap</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
976 <varlistentry id="sg_verify">
977 <term><command>sg_verify</command></term>
978 <listitem>
979 <para>
980 invokes SCSI VERIFY command(s) on a block device
981 </para>
982 <indexterm zone="sg3_utils sg_verify">
983 <primary sortas="b-sg_verify">sg_verify</primary>
984 </indexterm>
985 </listitem>
986 </varlistentry>
987
988 <varlistentry id="sg_vpd">
989 <term><command>sg_vpd</command></term>
990 <listitem>
991 <para>
992 fetches Vital Product Data (VPD) pages using a SCSI INQUIRY
993 command
994 </para>
995 <indexterm zone="sg3_utils sg_vpd">
996 <primary sortas="b-sg_vpd">sg_vpd</primary>
997 </indexterm>
998 </listitem>
999 </varlistentry>
1000
1001 <varlistentry id="sg_write_buffer">
1002 <term><command>sg_write_buffer</command></term>
1003 <listitem>
1004 <para>
1005 sends a SCSI WRITE BUFFER command
1006 </para>
1007 <indexterm zone="sg3_utils sg_write_buffer">
1008 <primary sortas="b-sg_write_buffer">sg_write_buffer</primary>
1009 </indexterm>
1010 </listitem>
1011 </varlistentry>
1012
1013 <varlistentry id="sg_write_long">
1014 <term><command>sg_write_long</command></term>
1015 <listitem>
1016 <para>
1017 sends the SCSI WRITE LONG command
1018 </para>
1019 <indexterm zone="sg3_utils sg_write_long">
1020 <primary sortas="b-sg_write_long">sg_write_long</primary>
1021 </indexterm>
1022 </listitem>
1023 </varlistentry>
1024
1025 <varlistentry id="sg_write_same">
1026 <term><command>sg_write_same</command></term>
1027 <listitem>
1028 <para>
1029 sends the SCSI WRITE SAME command
1030 </para>
1031 <indexterm zone="sg3_utils sg_write_same">
1032 <primary sortas="b-sg_write_same">sg_write_same</primary>
1033 </indexterm>
1034 </listitem>
1035 </varlistentry>
1036
1037 <varlistentry id="sg_write_verify">
1038 <term><command>sg_write_verify</command></term>
1039 <listitem>
1040 <para>
1041 sends the SCSI WRITE AND VERIFY command
1042 </para>
1043 <indexterm zone="sg3_utils sg_write_verify">
1044 <primary sortas="b-sg_write_verify">sg_write_verify</primary>
1045 </indexterm>
1046 </listitem>
1047 </varlistentry>
1048
1049 <varlistentry id="sg_write_x">
1050 <term><command>sg_write_x</command></term>
1051 <listitem>
1052 <para>
1053 performs SCSI WRITE commands on a device
1054 </para>
1055 <indexterm zone="sg3_utils sg_write_x">
1056 <primary sortas="b-sg_write_x">sg_write_x</primary>
1057 </indexterm>
1058 </listitem>
1059 </varlistentry>
1060
1061 <varlistentry id="sg_wr_mode">
1062 <term><command>sg_wr_mode</command></term>
1063 <listitem>
1064 <para>
1065 writes mode page
1066 </para>
1067 <indexterm zone="sg3_utils sg_wr_mode">
1068 <primary sortas="b-sg_wr_mode">sg_wr_mode</primary>
1069 </indexterm>
1070 </listitem>
1071 </varlistentry>
1072
1073 <varlistentry id="sg_xcopy">
1074 <term><command>sg_xcopy</command></term>
1075 <listitem>
1076 <para>
1077 copies data to and from files and devices
1078 using SCSI EXTENDED COPY (XCOPY)
1079 </para>
1080 <indexterm zone="sg3_utils sg_xcopy">
1081 <primary sortas="b-sg_xcopy">sg_xcopy</primary>
1082 </indexterm>
1083 </listitem>
1084 </varlistentry>
1085
1086 <varlistentry id="sg_zone">
1087 <term><command>sg_zone</command></term>
1088 <listitem>
1089 <para>
1090 performs SCSI ZONE commands on a device, such as OPEN, CLOSE, FINISH
1091 or SEQUENTIALIZE
1092 </para>
1093 <indexterm zone="sg3_utils sg_zone">
1094 <primary sortas="b-sg_zone">sg_zone</primary>
1095 </indexterm>
1096 </listitem>
1097 </varlistentry>
1098
1099 <varlistentry id="libsgutils2">
1100 <term><filename class="libraryfile">libsgutils2.so</filename></term>
1101 <listitem>
1102 <para>
1103 contains the <application>sg3_utils</application> API functions
1104 </para>
1105 <indexterm zone="sg3_utils libsgutils2">
1106 <primary sortas="c-libsgutils2">libsgutils2.so</primary>
1107 </indexterm>
1108 </listitem>
1109 </varlistentry>
1110
1111 </variablelist>
1112
1113 </sect2>
1114
1115</sect1>
Note: See TracBrowser for help on using the repository browser.