camcontrol.8 (249373) | camcontrol.8 (249895) |
---|---|
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 249373 2013-04-11 18:46:41Z joel $ | 28.\" $FreeBSD: head/sbin/camcontrol/camcontrol.8 249895 2013-04-25 14:11:38Z smh $ |
29.\" | 29.\" |
30.Dd June 4, 2012 | 30.Dd April 24, 2013 |
31.Dt CAMCONTROL 8 32.Os 33.Sh NAME 34.Nm camcontrol 35.Nd CAM control program 36.Sh SYNOPSIS 37.Nm 38.Aq Ar command --- 199 unchanged lines hidden (view full) --- 238.Op Fl k Ar pwd 239.Op Fl l Ar high|maximum 240.Op Fl q 241.Op Fl s Ar pwd 242.Op Fl T Ar timeout 243.Op Fl U Ar user|master 244.Op Fl y 245.Nm | 31.Dt CAMCONTROL 8 32.Os 33.Sh NAME 34.Nm camcontrol 35.Nd CAM control program 36.Sh SYNOPSIS 37.Nm 38.Aq Ar command --- 199 unchanged lines hidden (view full) --- 238.Op Fl k Ar pwd 239.Op Fl l Ar high|maximum 240.Op Fl q 241.Op Fl s Ar pwd 242.Op Fl T Ar timeout 243.Op Fl U Ar user|master 244.Op Fl y 245.Nm |
246.Ic hpa 247.Op device id 248.Op generic args 249.Op Fl f 250.Op Fl l 251.Op Fl P 252.Op Fl p Ar pwd 253.Op Fl q 254.Op Fl s Ar max_sectors 255.Op Fl U Ar pwd 256.Op Fl y 257.Nm |
|
246.Ic help 247.Sh DESCRIPTION 248The 249.Nm 250utility is designed to provide a way for users to access and control the 251.Fx 252CAM subsystem. 253.Pp --- 946 unchanged lines hidden (view full) --- 1200without prompting for confirmation. 1201.Pp 1202.El 1203If the password specified for any action commands doesn't match the configured 1204password for the specified user the command will fail. 1205.Pp 1206The password in all cases is limited to 32 characters, longer passwords will 1207fail. | 258.Ic help 259.Sh DESCRIPTION 260The 261.Nm 262utility is designed to provide a way for users to access and control the 263.Fx 264CAM subsystem. 265.Pp --- 946 unchanged lines hidden (view full) --- 1212without prompting for confirmation. 1213.Pp 1214.El 1215If the password specified for any action commands doesn't match the configured 1216password for the specified user the command will fail. 1217.Pp 1218The password in all cases is limited to 32 characters, longer passwords will 1219fail. |
1220.It Ic hpa 1221Update or report Host Protected Area details. 1222By default 1223.Nm 1224will print out the HPA support and associated settings of the device. 1225The 1226.Ic hpa 1227command takes several optional arguments: 1228.Bl -tag -width 0n 1229.It Fl f 1230.Pp 1231Freeze the HPA configuration of the specified device. 1232.Pp 1233After command completion any other commands that update the HPA configuration 1234shall be command aborted. 1235Frozen mode is disabled by power-off or hardware reset. 1236.It Fl l 1237.Pp 1238Lock the HPA configuration of the device until a successful call to unlock or 1239the next power-on reset occurs. 1240.It Fl P 1241.Pp 1242Make the HPA max sectors persist across power-on reset or a hardware reset. 1243This must be used in combination with 1244.Fl s Ar max_sectors 1245. 1246.It Fl p Ar pwd 1247.Pp 1248Set the HPA configuration password required for unlock calls. 1249.It Fl q 1250.Pp 1251Be quiet, do not print any status messages. 1252This option will not disable the questions. 1253To disable questions, use the 1254.Fl y 1255argument, below. 1256.It Fl s Ar max_sectors 1257.Pp 1258Configures the maximum user accessible sectors of the device. 1259This will change the number of sectors the device reports. 1260.Pp 1261.Em WARNING! WARNING! WARNING! 1262.Pp 1263Changing the max sectors of a device using this option will make the data on 1264the device beyond the specified value inaccessible. 1265.Pp 1266Only one successful 1267.Fl s Ar max_sectors 1268call can be made without a power-on reset or a hardware reset of the device. 1269.It Fl U Ar pwd 1270.Pp 1271Unlock the HPA configuration of the specified device using the given password. 1272If the password specified doesn't match the password configured via 1273.Fl p Ar pwd 1274the command will fail. 1275.Pp 1276After 5 failed unlock calls, due to password miss-match, the device will refuse 1277additional unlock calls until after a power-on reset. 1278.It Fl y 1279.Pp 1280Confirm yes to dangerous options such as 1281.Fl e 1282without prompting for confirmation 1283.Pp 1284.El 1285The password for all HPA commands is limited to 32 characters, longer passwords 1286will fail. |
|
1208.It Ic fwdownload 1209Program firmware of the named SCSI device using the image file provided. 1210.Pp 1211Current list of supported vendors: 1212.Bl -bullet -offset indent -compact 1213.It 1214HITACHI 1215.It --- 176 unchanged lines hidden (view full) --- 1392.Em WARNING! WARNING! WARNING! 1393.Pp 1394This will 1395.Em ERASE ALL 1396data from the device, so backup your data before using! 1397.Pp 1398This command can be used used against an SSD drive to restoring it to 1399factory default write performance. | 1287.It Ic fwdownload 1288Program firmware of the named SCSI device using the image file provided. 1289.Pp 1290Current list of supported vendors: 1291.Bl -bullet -offset indent -compact 1292.It 1293HITACHI 1294.It --- 176 unchanged lines hidden (view full) --- 1471.Em WARNING! WARNING! WARNING! 1472.Pp 1473This will 1474.Em ERASE ALL 1475data from the device, so backup your data before using! 1476.Pp 1477This command can be used used against an SSD drive to restoring it to 1478factory default write performance. |
1479.Pp 1480.Bd -literal -offset indent 1481camcontrol hpa ada0 1482.Ed 1483.Pp 1484Report HPA support and settings for ada0 (also reported via 1485identify). 1486.Pp 1487.Bd -literal -offset indent 1488camcontrol hpa ada0 -s 10240 1489.Ed 1490.Pp 1491Enables HPA on ada0 setting the maximum reported sectors to 10240. 1492.Pp 1493.Em WARNING! WARNING! WARNING! 1494.Pp 1495This will 1496.Em PREVENT ACCESS 1497to all data on the device beyond this limit until HPA is disabled by setting 1498HPA to native max sectors of the device, which can only be done after a 1499power-on or hardware reset! 1500.Pp 1501.Em DO NOT 1502use this on a device which has an active filesystem! |
|
1400.Sh SEE ALSO 1401.Xr cam 3 , 1402.Xr cam_cdbparse 3 , 1403.Xr cam 4 , 1404.Xr pass 4 , 1405.Xr xpt 4 1406.Sh HISTORY 1407The --- 45 unchanged lines hidden --- | 1503.Sh SEE ALSO 1504.Xr cam 3 , 1505.Xr cam_cdbparse 3 , 1506.Xr cam 4 , 1507.Xr pass 4 , 1508.Xr xpt 4 1509.Sh HISTORY 1510The --- 45 unchanged lines hidden --- |