source: general/sysutils/sg3_utils.xml@ 8558044

11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8558044 was 8558044, checked in by Pierre Labastie <pierre.labastie@…>, 3 years ago

Remove spaces at the end of lines

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