| camcontrol.8 (276659) | camcontrol.8 (276835) |
|---|---|
| 1.\" 2.\" Copyright (c) 1998, 1999, 2000, 2002, 2005, 2006, 2007 Kenneth D. Merry. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" | 1.\" 2.\" Copyright (c) 1998, 1999, 2000, 2002, 2005, 2006, 2007 Kenneth D. Merry. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 11 unchanged lines hidden (view full) --- 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" |
| 28.\" $FreeBSD: head/sbin/camcontrol/camcontrol.8 276659 2015-01-04 12:49:24Z joel $ | 28.\" $FreeBSD: head/sbin/camcontrol/camcontrol.8 276835 2015-01-08 16:58:40Z ken $ |
| 29.\" 30.Dd August 31, 2014 31.Dt CAMCONTROL 8 32.Os 33.Sh NAME 34.Nm camcontrol 35.Nd CAM control program 36.Sh SYNOPSIS --- 68 unchanged lines hidden (view full) --- 105.Aq all | bus Ns Op :target:lun 106.Nm 107.Ic defects 108.Op device id 109.Op generic args 110.Aq Fl f Ar format 111.Op Fl P 112.Op Fl G | 29.\" 30.Dd August 31, 2014 31.Dt CAMCONTROL 8 32.Os 33.Sh NAME 34.Nm camcontrol 35.Nd CAM control program 36.Sh SYNOPSIS --- 68 unchanged lines hidden (view full) --- 105.Aq all | bus Ns Op :target:lun 106.Nm 107.Ic defects 108.Op device id 109.Op generic args 110.Aq Fl f Ar format 111.Op Fl P 112.Op Fl G |
| 113.Op Fl q 114.Op Fl s 115.Op Fl S Ar offset 116.Op Fl X |
|
| 113.Nm 114.Ic modepage 115.Op device id 116.Op generic args 117.Aq Fl m Ar page | Fl l 118.Op Fl P Ar pgctl 119.Op Fl b | Fl e 120.Op Fl d --- 387 unchanged lines hidden (view full) --- 508.Ar all 509argument) or the given bus (XPT_RESET_BUS) by issuing a SCSI bus 510reset for that bus, or to reset the given bus:target:lun 511(XPT_RESET_DEV), typically by issuing a BUS DEVICE RESET message after 512connecting to that device. 513Note that this can have a destructive impact 514on the system. 515.It Ic defects | 117.Nm 118.Ic modepage 119.Op device id 120.Op generic args 121.Aq Fl m Ar page | Fl l 122.Op Fl P Ar pgctl 123.Op Fl b | Fl e 124.Op Fl d --- 387 unchanged lines hidden (view full) --- 512.Ar all 513argument) or the given bus (XPT_RESET_BUS) by issuing a SCSI bus 514reset for that bus, or to reset the given bus:target:lun 515(XPT_RESET_DEV), typically by issuing a BUS DEVICE RESET message after 516connecting to that device. 517Note that this can have a destructive impact 518on the system. 519.It Ic defects |
| 516Send the SCSI READ DEFECT DATA (10) command (0x37) to the given device, and | 520Send the 521.Tn SCSI 522READ DEFECT DATA (10) command (0x37) or the 523.Tn SCSI 524READ DEFECT DATA (12) command (0xB7) to the given device, and |
| 517print out any combination of: the total number of defects, the primary 518defect list (PLIST), and the grown defect list (GLIST). 519.Bl -tag -width 11n 520.It Fl f Ar format | 525print out any combination of: the total number of defects, the primary 526defect list (PLIST), and the grown defect list (GLIST). 527.Bl -tag -width 11n 528.It Fl f Ar format |
| 521The three format options are: 522.Em block , 523to print out the list as logical blocks, 524.Em bfi , 525to print out the list in bytes from index format, and 526.Em phys , 527to print out the list in physical sector format. | 529Specify the requested format of the defect list. |
| 528The format argument is 529required. 530Most drives support the physical sector format. 531Some drives 532support the logical block format. 533Many drives, if they do not support the 534requested format, return the data in an alternate format, along with sense 535information indicating that the requested data format is not supported. 536The 537.Nm 538utility 539attempts to detect this, and print out whatever format the drive returns. 540If the drive uses a non-standard sense code to report that it does not 541support the requested format, 542.Nm 543will probably see the error as a failure to complete the request. | 530The format argument is 531required. 532Most drives support the physical sector format. 533Some drives 534support the logical block format. 535Many drives, if they do not support the 536requested format, return the data in an alternate format, along with sense 537information indicating that the requested data format is not supported. 538The 539.Nm 540utility 541attempts to detect this, and print out whatever format the drive returns. 542If the drive uses a non-standard sense code to report that it does not 543support the requested format, 544.Nm 545will probably see the error as a failure to complete the request. |
| 546.Pp 547The format options are: 548.Bl -tag -width 9n 549.It block 550Print out the list as logical blocks. 551This is limited to 32-bit block sizes, and isn't supported by many modern 552drives. 553.It longblock 554Print out the list as logical blocks. 555This option uses a 64-bit block size. 556.It bfi 557Print out the list in bytes from index format. 558.It extbfi 559Print out the list in extended bytes from index format. 560The extended format allows for ranges of blocks to be printed. 561.It phys 562Print out the list in physical sector format. 563Most drives support this format. 564.It extphys 565Print out the list in extended physical sector format. 566The extended format allows for ranges of blocks to be printed. 567.El 568.Pp |
|
| 544.It Fl G 545Print out the grown defect list. 546This is a list of bad blocks that have 547been remapped since the disk left the factory. 548.It Fl P 549Print out the primary defect list. | 569.It Fl G 570Print out the grown defect list. 571This is a list of bad blocks that have 572been remapped since the disk left the factory. 573.It Fl P 574Print out the primary defect list. |
| 575This is the list of defects that were present in the factory. 576.It Fl q 577When printing status information with 578.Fl s , 579only print the number of defects. 580.It Fl s 581Just print the number of defects, not the list of defects. 582.It Fl S Ar offset 583Specify the starting offset into the defect list. 584This implies using the 585.Tn SCSI 586READ DEFECT DATA (12) command, as the 10 byte version of the command 587doesn't support the address descriptor index field. 588Not all drives support the 12 byte command, and some drives that support 589the 12 byte command don't support the address descriptor index field. 590.It Fl X 591Print out defects in hexadecimal (base 16) form instead of base 10 form. |
|
| 550.El 551.Pp 552If neither 553.Fl P 554nor 555.Fl G 556is specified, 557.Nm --- 1481 unchanged lines hidden --- | 592.El 593.Pp 594If neither 595.Fl P 596nor 597.Fl G 598is specified, 599.Nm --- 1481 unchanged lines hidden --- |