Lines Matching +full:power +full:- +full:management +full:- +full:ic +full:- +full:for +full:- +full:system

18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
145 .Bk -words
392 can cause a loss of data and/or system crashes if used improperly.
402 .Bl -tag -width 14n
412 Specify the bus, target and lun for a device.
419 function-specific arguments.
437 .Bl -tag -width 14n
440 In order for this to work, error recovery
444 Instruct the kernel to perform generic SCSI error recovery for the given
446 This is needed in order for the retry count
457 task attribute for the command, if it is a
468 This overrides the default timeout for
473 Be verbose, print out sense information for failed SCSI commands.
477 .Bl -tag -width periphlist
478 .It Ic devlist
489 .It Ic periphlist
492 .It Ic tur
497 .It Ic sense
500 .Bl -tag -width 4n
506 .It Ic inquiry
514 .Bl -tag -width 4n
526 .It Ic identify
528 .It Ic reportluns
534 .Bl -tag -width 14n
541 .Bl -tag -width 012345678
559 .It Ic readcap
569 .Bl -tag -width 5n
610 .It Ic start
613 .It Ic stop
616 .It Ic load
619 .It Ic eject
622 .It Ic rescan
623 Tell the kernel to scan all buses in the system (with the
626 (XPT_SCAN_LUN) for new devices or devices that have gone away.
632 If a device is specified by peripheral name and unit number, for instance
639 .It Ic reprobe
644 the disk size visible to the rest of the system.
645 .It Ic reset
646 Tell the kernel to reset all buses in the system (with the
649 reset for that bus, or to reset the given bus:target:lun or device
653 on the system.
654 .It Ic defects
662 .Bl -tag -width 11n
677 If the drive uses a non-standard sense code to report that it does not
683 .Bl -tag -width 9n
686 This is limited to 32-bit block sizes, and isn't supported by many modern
690 This option uses a 64-bit block size.
695 The extended format allows for ranges of blocks to be printed.
701 The extended format allows for ranges of blocks to be printed.
738 .It Ic modepage
749 .Bl -tag -width 12n
758 Disable block descriptors for mode sense.
790 .Bl -tag -width xxx -compact
801 .It Ic cmd
820 .Bl -tag -width 17n
829 Specifies DMA protocol to be used for ATA command.
831 Specifies FPDMA (NCQ) protocol to be used for ATA command.
835 .Sq - ,
842 .Sq - ,
850 .Sq - ,
853 .It Ic smpcmd
855 Management Protocol (SMP) command to a device.
863 The syntax for the SMP request and response arguments is documented in
871 .Bl -tag -width 17n
876 .Sq - ,
881 This specifies the size of the buffer allocated for the SMP response, and
884 .Sq - ,
886 bytes of data will be allocated for the response and the response will be
889 .It Ic smprg
890 Allows the user to send the Serial Management Protocol (SMP) Report General
896 .Bl -tag -width 8n
905 .It Ic smppc
906 Allows the user to issue the Serial Management Protocol (SMP) PHY Control
913 .Bl -tag -width 17n
929 .Bl -tag -width 16n
939 Note that the LINK RESET or HARD RESET commands should re-enable the phy.
942 This clears the error log counters for the specified phy.
964 The name is a 64-bit number, and can be specified in decimal, hexadecimal
967 Set the minimum physical link rate for the phy.
970 .Bl -tag -width 5n
981 Other values may be specified for newer physical link rates.
983 Set the maximum physical link rate for the phy.
987 argument description for known link rate arguments.
994 specification for more information on this field.
996 Enable or disable SATA slumber phy power conditions.
998 Enable or disable SATA partial power conditions.
1000 Enable or disable SAS slumber phy power conditions.
1002 Enable or disable SAS partial phy power conditions.
1004 .It Ic smpphylist
1006 attached to the phy, and the inquiry data for that device and peripheral
1009 .Bl -tag -width 5n
1011 Turn on the long response format for the underlying SMP commands used for
1017 .It Ic smpmaninfo
1020 .Bl -tag -width 5n
1022 Turn on the long response format for the underlying SMP commands used for
1025 .It Ic debug
1037 .Bl -tag -width 18n
1055 Enable debugging for all devices.
1057 Turn off debugging for all devices
1059 Turn on debugging for the given bus, target or lun.
1063 bus turns on debugging printfs for all devices on that bus.)
1065 .It Ic tags
1070 command, with no command-specific arguments (i.e., only generic arguments)
1076 .Bl -tag -width 7n
1078 Set the number of tags for the given device.
1081 The default for
1084 The minimum and maximum values for a given device may be
1090 switch for this
1098 The verbose flag has special functionality for the
1104 .Bl -tag -width 13n
1106 This is the amount of capacity for transactions queued to a given device.
1110 This is the number of CCBs allocated for the device.
1114 layer for service by a device.
1123 The default value for
1125 is 2, although it may be set higher or lower for various devices.
1132 The default value for
1134 is 255, although it may be set higher or lower for various devices.
1137 .It Ic negotiate
1155 flag for the
1162 controllers, support enabling and disabling synchronous negotiation for
1164 .Bl -tag -width 17n
1182 Change the synchronization rate for a device.
1185 So, for instance,
1190 Enable or disable tagged queueing for a device.
1196 The verbose switch has special meaning for the
1209 The controller must support the bus width in question in order for
1213 In general, sync rate and offset settings will not take effect for a
1219 .It Ic format
1229 Many users low-level format
1230 disks that do not really need to be low-level formatted.
1232 relatively few scenarios that call for low-level formatting a disk.
1233 One reason for
1234 low-level formatting a disk is to initialize the disk after changing
1236 Another reason for low-level formatting a disk
1244 timeout is 3 hours, which should be long enough for most disks.
1249 does not really support the FORMAT UNIT command -- it just accepts the
1259 arguments can be useful for scripts.
1260 .Bl -tag -width 6n
1274 Issue a non-immediate format command.
1291 will issue a non-immediate format command, and will be unable to print any
1304 .It Ic sanitize
1320 arguments can be useful for scripts.
1321 .Bl -tag -width 6n
1324 .Bl -tag -width 16n
1383 Issue a non-immediate sanitize command.
1400 will issue a non-immediate sanitize command, and will be unable to print any
1413 .It Ic idle
1419 .It Ic standby
1425 .It Ic sleep
1429 .It Ic powermode
1430 Report ATA device power mode.
1431 .It Ic apm
1434 specified, enables and sets advanced power management level, where
1435 1 -- minimum power, 127 -- maximum performance with standby,
1436 128 -- minimum power without standby, 254 -- maximum performance.
1437 If not specified -- APM is disabled.
1438 .It Ic aam
1441 specified, enables and sets automatic acoustic management level, where
1442 1 -- minimum noise, 254 -- maximum performance.
1443 If not specified -- AAM is disabled.
1444 .It Ic security
1452 .Bl -tag -width 0n
1455 Disable device security using the given password for the selected user according
1459 Erase the device using the given password for the selected user.
1477 Frozen mode is disabled by power-off or hardware reset.
1480 Enhanced erase the device using the given password for the selected user.
1493 Unlock the device using the given password for the selected user according to
1520 Password the device (enable security) using the given password for the selected
1537 Overrides the default timeout, specified in seconds, used for both
1541 this is useful if your system has problems processing long timeouts correctly.
1547 Specifies which user to set / use for the running action command, valid values
1558 without prompting for confirmation.
1561 If the password specified for any action commands does not match the configured
1562 password for the specified user the command will fail.
1566 .It Ic hpa
1574 .Bl -tag -width 0n
1581 Frozen mode is disabled by power-off or hardware reset.
1585 the next power-on reset occurs.
1588 Make the HPA max sectors persist across power-on reset or a hardware reset.
1594 Set the HPA configuration password required for unlock calls.
1614 call can be made without a power-on reset or a hardware reset of the device.
1622 After 5 failed unlock calls, due to password miss-match, the device will refuse
1623 additional unlock calls until after a power-on reset.
1628 without prompting for confirmation
1631 The password for all HPA commands is limited to 32 characters, longer passwords
1633 .It Ic ama
1642 .Bl -tag -width 0n
1649 Frozen mode is disabled by power-off.
1665 call can be made without a power-on reset of the device.
1667 .It Ic fwdownload
1674 device and it provides a recommended timeout for the WRITE BUFFER command
1677 opcodes subcommand), that timeout will be used for the firmware download.
1678 The drive-recommended timeout value may be overridden on the command line
1683 Current list of supported vendors for SCSI/SAS drives:
1684 .Bl -tag -width 10n
1690 Tested with LTO-5 (ULTRIUM-HH5) and LTO-6 (ULTRIUM-HH6) tape drives.
1691 There is a separate table entry for hard drives, because the update method
1692 for hard drives is different than the method for tape drives.
1736 devices are supported for devices connected
1752 PASS-THROUGH command to send the
1766 .Bl -tag -width 11n
1790 register values that would be used for the firmware download command.
1792 Do not ask for confirmation.
1794 .It Ic persist
1798 LUN for use by one or more
1823 and download the latest SPC spec for a full explanation of persistent
1825 .Bl -tag -width 8n
1827 Specify the service action for the PERSISTENT RESERVE IN command.
1829 .Bl -tag -width 19n
1841 Specify the service action for the PERSISTENT RESERVE OUT command.
1847 .Bl -tag -width 15n
1860 registered for the initiator.
1886 LUN for that initiator.
1898 This only applies to the Register and Register and Move service actions for
1908 .Bl -tag -width 5n
1912 followed by a 64-bit SAS address.
1919 followed by a 64-bit Fibre Channel World Wide Name.
1933 followed by a 64-bit EUI-64 IEEE 1394 node unique identifier.
1940 followed by a 128-bit RDMA initiator port identifier.
1952 .Dl iqn.2012-06.com.example:target0
1956 .Dl iqn.2012-06.com.example:target0,i,0x123
1968 For example, if a bus, device and function are specified for the standard
1981 The value must be between 0 and 2^64 - 1, inclusive.
1986 The value must be between 0 and 2^64 - 1, inclusive.
1988 Enable the Activate Persist Through Power Loss bit.
1989 This is only used for the register and register_ignore actions.
1990 This requests that the reservation persist across power loss events.
1994 The scope is ignored for register, register_ignore and clear.
1996 .Bl -tag -width 7n
2016 It is an error to specify this option for any service action other than
2024 .Bl -tag -width 11n
2064 .It Ic attrib
2080 .Bl -tag -width 14n
2083 .Bl -tag -width 11n
2098 List attributes that are supported for reading or writing.
2111 If the device supports this flag, it allows displaying attributes for the
2115 This is used for specifying which element number in a medium changer to
2117 The element number could be for a picker, portal, slot or drive.
2119 Specify the output format for the attribute values (attr_val) display as a
2130 .Bl -tag -width 12n
2132 Print text fields with non-ASCII characters escaped.
2136 If any non-ASCII characters occur in fields that are supposed to be ASCII,
2137 escape the non-ASCII characters.
2139 If any non-ASCII characters occur in fields that are supposed to be ASCII,
2140 omit the non-ASCII characters.
2142 If any non-ASCII characters occur in fields that are supposed to be ASCII,
2165 numbers allows seeing the values for each individual partition.
2187 .It Ic opcodes
2198 CDB (Command Data Block) length for each command, and the description of
2200 .Bl -tag -width 18n
2204 If supported, the target will return a CDB-like structure that indicates
2211 If a service action is specified for a given opcode, and the device does
2216 By default, if a service action is specified for an opcode, and service
2217 actions are not supported for the opcode in question, the device will
2231 The timeout descriptor also includes a command-specific
2233 .It Ic zone
2248 .Bl -tag -width 13n
2277 .Bl -tag -width 20n
2292 .Bl -tag -width 12n
2295 .Bl -tag -width 6n
2315 Reset the write pointer for the zone specified by the starting LBA.
2329 .Bl -tag -width 8n
2357 non-sequentially.
2362 Specify a printing option for Report Zones:
2363 .Bl -tag -width 7n
2377 different, or whether they are the same except for the last zone, etc.
2385 .It Ic epc
2388 Extended Power Conditions (EPC) feature set commands.
2401 It may be helpful to read the ATA Command Set - 4 (ACS-4) description of
2402 the Extended Power Conditions feature set, available at t13.org, to
2406 .Bl -tag -width 6n
2409 .Bl -tag -width 7n
2411 Restore drive power condition settings.
2412 .Bl -tag -width 6n
2414 Specify the source for the restored power settings, either
2424 Go to the specified power condition.
2425 .Bl -tag -width 7n
2427 Specify the power condition: Idle_a, Idle_b, Idle_c, Standby_y, Standby_z.
2430 Specify delayed entry to the power condition.
2431 The drive, if it supports this, can enter the power condition after the
2434 Hold the power condition.
2435 If the drive supports this option, it will hold the power condition and
2436 reject all commands that would normally cause it to exit that power
2440 Set the timer value for a power condition and enable or disable the
2444 display described below to see what the current timer settings are for each
2446 .Bl -tag -width 8n
2448 Enable the power condition.
2455 Disable the power condition.
2465 Drives may or may not support sub-second timer values.
2467 Specify the power condition: Idle_a, Idle_b, Idle_c, Standby_y, Standby_z.
2470 Save the timer and power condition enable/disable state.
2471 By default, if this option is not specified, only the current values for
2472 this power condition will be affected.
2475 Enable or disable a particular power condition.
2476 .Bl -tag -width 7n
2478 Enable the power condition.
2485 Disable the power condition.
2492 Specify the power condition: Idle_a, Idle_b, Idle_c, Standby_y, Standby_z.
2495 Save the power condition enable/disable state.
2496 By default, if this option is not specified, only the current values for
2497 this power condition will be affected.
2500 Enable the Extended Power Condition (EPC) feature set.
2502 Disable the Extended Power Condition (EPC) feature set.
2504 Specify the EPC power source.
2505 .Bl -tag -width 6n
2507 Specify the power source, either
2513 Get the current status of several parameters related to the Extended Power
2515 and enabled, whether Low Power Standby is supported, whether setting the
2516 EPC power source is supported, whether Low Power Standby is supported and
2517 the current power condition.
2518 .Bl -tag -width 3n
2520 Only report the current power condition.
2521 Some drives will exit their current power condition if a command other than
2524 CHECK POWER MODE command is received.
2529 CHECK POWER MODE command to the drive.
2534 Power Conditions log (Log Address 0x08).
2535 This shows the list of Idle and Standby power conditions the drive
2540 .It Ic timestamp
2549 .Bl -tag -width 6n
2555 .Bl -tag -width 9n
2563 time, but override the system time zone and use UTC instead.
2566 .Bl -tag -width 6n
2576 .Bl -tag -width 9n
2587 Set the timestamp to the host system's time in UTC.
2590 .It Ic devtype
2591 Print out the device type for specified device.
2592 .Bl -tag -width 10n
2596 An SATA device attached behind a SAS controller via SCSI-ATA Translation Layer (SATL)
2610 .It Ic depop
2612 (typically heads for hard drives) or setting capacity point (typically used on
2636 If the drive power cycles, it will remain format corrupt and the operation
2640 can monitor an in-progress depop operation.
2641 .Bl -tag -width 6n
2643 Specify the desired capacity point for the drive.
2644 Valid only for the
2656 Valid only for the
2664 .It Ic help
2678 .Bl -tag -width /usr/share/misc/scsi_modes -compact
2687 .Dl camcontrol eject -n cd -u 1 -v
2701 .Bd -literal -offset indent
2702 camcontrol tur da1 -E -C 4 -t 50 -Q head -v
2716 task attribute for the command will be set to Head of Queue.
2720 .Bd -literal -offset indent
2721 camcontrol cmd -n cd -u 1 -v -c "3C 00 00 00 00 00 00 00 0e 00" \e
2722 	-i 0xe "s1 i3 i1 i1 i1 i1 i1 i1 i1 i1 i1 i1"
2730 .Bd -literal -offset indent
2731 camcontrol cmd -n cd -u 1 -v -c "3B 00 00 00 00 00 00 00 0e 00" \e
2732 	-o 14 "00 00 00 00 1 2 3 4 5 6 v v v v" 7 8 9 8
2742 .Bd -literal -offset indent
2743 camcontrol modepage da3 -m 1 -e -P 3
2746 Edit mode page 1 (the Read-Write Error Recover page) for da3, and save the
2753 Rescan all SCSI buses in the system for devices that have been added,
2758 Rescan SCSI bus 0 for devices that have been added, removed or changed.
2765 .Dl camcontrol tags da5 -N 24
2767 Set the number of concurrent transactions for da5 to 24.
2768 .Bd -literal -offset indent
2769 camcontrol negotiate -n da -u 4 -T disable
2772 Disable tagged queueing for da4.
2773 .Bd -literal -offset indent
2774 camcontrol negotiate -n da -u 3 -R 20.000 -O 15 -a
2780 .Bd -literal -offset indent
2781 camcontrol smpcmd ses0 -v -r 4 "40 0 00 0" -R 1020 "s9 i1"
2787 .Bd -literal -offset indent
2791 Report security support and settings for ada0
2792 .Bd -literal -offset indent
2793 camcontrol security ada0 -U user -s MyPass
2797 .Bd -literal -offset indent
2798 camcontrol security ada0 -U user -e MyPass
2811 .Bd -literal -offset indent
2815 Report HPA support and settings for ada0 (also reported via
2817 .Bd -literal -offset indent
2818 camcontrol hpa ada0 -s 10240
2829 power-on or hardware reset!
2833 .Bd -literal -offset indent
2834 camcontrol persist da0 -v -i read_keys
2841 .Bd -literal -offset indent
2842 camcontrol persist da0 -v -o register -a -K 0x12345678
2848 .Bd -literal -offset indent
2849 camcontrol persist da0 -v -o reserve -s lun -k 0x12345678 -T ex_ac
2852 This will reserve da0 for the exlusive use of the initiator issuing the
2856 .Bd -literal -offset indent
2857 camcontrol persist da0 -v -i read_full
2862 .Bd -literal -offset indent
2863 camcontrol persist da0 -v -o release -k 0x12345678 -T ex_ac
2868 The Reservation Key for this registration is 0x12345678.
2870 .Bd -literal -offset indent
2871 camcontrol persist da0 -v -o register -K 0x12345678 -S \e
2872 	-I sas,0x1234567812345678 -I sas,0x8765432187654321
2878 .Bd -literal -offset indent
2879 camcontrol persist da0 -v -o register_move -k 0x87654321 \e
2880 	-K 0x12345678 -U -p -R 2 -I fcp,0x1234567812345678
2886 A new registration key, 0x12345678, will be registered for the initiator
2891 The registration will persist across power losses.
2892 .Bd -literal -offset indent
2893 camcontrol attrib sa0 -v -i attr_values -p 1
2900 .Bd -literal -offset indent
2901 camcontrol zone da0 -v -c rz -P summary
2910 .Bd -literal -offset indent
2911 camcontrol zone da0 -v -c rz -o reset
2920 .Bd -literal -offset indent
2921 camcontrol zone da0 -v -c rwp -l 0x2c80000
2924 This will issue the Reset Write Pointer command to disk da0 for the zone
2930 .Bd -literal -offset indent
2931 camcontrol epc ada0 -c timer -T 60.1 -p Idle_a -e -s
2934 Set the timer for the Idle_a power condition on drive
2936 to 60.1 seconds, enable that particular power condition, and save the timer
2937 value and the enabled state of the power condition.
2938 .Bd -literal -offset indent
2939 camcontrol epc da4 -c goto -p Standby_z -H
2944 to go to the Standby_z power state (which is
2945 the drive's lowest power state) and hold in that state until it is
2949 .Bd -literal -offset indent
2950 camcontrol epc da2 -c status -P
2953 Report only the power state of
2956 Some drives will power up in response to the commands sent by the
2964 CHECK POWER MODE command, which should not trigger a change in the drive's
2965 power state.
2966 .Bd -literal -offset indent
2967 camcontrol epc ada0 -c list
2970 Display the ATA Power Conditions log (Log Address 0x08) for
2973 .Bd -literal -offset indent
2974 camcontrol timestamp sa0 -s -f "%a, %d %b %Y %T %z" \e
2975 	-T "Wed, 26 Oct 2016 21:43:57 -0600"
3018 So if, for instance, you
3020 .Bd -literal -offset indent
3021 camcontrol cmd -n da -u 1 -c "00 00 00 00 00 v" 0x00 -v
3039 arguments before any command-specific arguments.