source: general/sysutils/sg3_utils.xml@ a17f6a03

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since a17f6a03 was 15445ab, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Lots of tags

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