Lines Matching +full:display +full:- +full:backend
3 .\" Copyright (c) 2015-2021 Alexander Motin <mav@FreeBSD.org>
36 .\" $Id: //depot/users/kenm/FreeBSD-test2/usr.sbin/ctladm/ctladm.8#3 $
72 .Aq Fl f Ar file|-
82 .Aq Fl f Ar file|-
138 .Aq Fl b Ar backend
148 .Aq Fl b Ar backend
153 .Aq Fl b Ar backend
159 .Op Fl b Ar backend
197 .Aq Fl a | Fl c Ar connection-id | Fl i Ar name | Fl p Ar portal
200 .Aq Fl a | Fl c Ar connection-id | Fl i Ar name | Fl p Ar portal
207 .Aq Fl a | Fl c Ar controller-id | Fl h Ar name
218 some meta-commands that utilize
232 .Bl -tag -width 14n
239 .Bl -tag -width 10n
255 .Bl -tag -width 11n
264 INQUIRY command to the device and display some of the returned inquiry
269 REQUEST SENSE command to the device and display the returned sense
274 REPORT LUNS command to the device and display supported LUNs.
280 .Bl -tag -width 12n
291 .Sq -
320 .Bl -tag -width 12n
331 .Sq -
359 READ CAPACITY command to the device and display the device size and device
377 MODE SENSE command to the device, and display the requested mode page(s) or
379 .Bl -tag -width 10n
381 Specify the mode page to display.
396 .Bl -tag -width 2n -compact
419 .Bl -tag -width 4n
435 .Bl -tag -width 4n
451 .Bl -tag -width 14n
454 This option is a no-op for CTL.
458 This option is a no-op for CTL.
490 .Bl -tag -width 12n
532 .Bl -tag -width 17n
535 .Bl -tag -width 10n
543 reads, or ASC/ASCQ 0x0c,0x02 ("Write error - auto reallocation failed")
558 .Bl -tag -width 10n
581 .Sq - ,
623 .Bl -tag -width 12n
644 The list of recognized options is driver-dependent.
709 .Bl -tag -width 12n
731 are specified -- LUN will be mapped.
736 is not -- LUN will be unmapped.
741 are specified -- LUN mapping will be disabled, exposing all CTL LUNs.
742 .Bl -tag -width 12n
756 The backend must be specified, and depending upon the backend requested,
761 .Bl -tag -width 14n
762 .It Fl b Ar backend
766 This specifies the name backend to use when creating the LUN.
772 Specify the blocksize of the backend in bytes.
774 Specify the LUN-associated string to use in the
781 Specify a backend-specific name/value pair.
785 Refer to the backend documentation for arguments that may be used.
788 Some backends may allow setting the size (e.g. the ramdisk backend) and for
789 others the size may be implicit (e.g. the block backend).
796 If this flag is not used, the type of LUN created is backend-specific.
800 The backend requested may or may not support all of the LUN types that CTL
805 The backend must be specified, and the LUN number must also be specified.
806 Backend-specific options may also be specified with the
809 .Bl -tag -width 14n
810 .It Fl b Ar backend
811 Specify the backend that owns the LUN to be removed.
819 Specify a backend-specific name/value pair.
823 Refer to the backend documentation for arguments that may be used.
827 The backend, the LUN number, and the size must be specified.
828 .Bl -tag -width 14n
829 .It Fl b Ar backend
830 Specify the backend that owns the LUN to be modified.
838 Specify a backend-specific name/value pair.
842 Refer to the backend documentation for arguments that may be used.
847 backend, an
855 .Bl -tag -width 11n
856 .It Fl b Ar backend
857 Specify the backend.
858 This restricts the LUN list to the named backend.
865 This will also display any backend-specific LUN attributes in addition to
866 the standard per-LUN information.
870 option allows the display of the raw XML data.
883 .Bl -tag -width 11n
889 option allows the display of the raw XML data.
893 .Bl -tag -width 11n
905 .Bl -tag -width 11n
918 .Bl -tag -width 11n
924 option allows the display of the raw XML data.
928 .Bl -tag -width 11n
937 Display
943 Some options are global, others are backend-specific.
946 .Bl -tag -width 12n
956 Specifies LUN EUI-64 identifier.
963 Non-unique LUN identifiers may lead to data corruption.
968 Specified LUN text identification information (UTF-8 string).
978 Set to "off", disables read caching for the LUN, if supported by the backend.
999 of backing stores without prefetch/write-back.
1007 Specifies medium rotation rate of the device: 0 -- not reported,
1008 1 -- non-rotating (SSD), >1024 -- value in revolutions per minute.
1010 Specifies nominal form factor of the device: 0 -- not reported, 1 -- 5.25",
1011 2 -- 3.5", 3 -- 2.5", 4 -- 1.8", 5 -- less then 1.8".
1022 Default value is "on" if supported by the backend.
1030 .It Va avail-threshold
1031 .It Va used-threshold
1032 .It Va pool-avail-threshold
1033 .It Va pool-used-threshold
1034 Set per-LUN/-pool thin provisioning soft thresholds.
1038 Pool thresholds are working only for ZVOL-backed LUNs.
1040 Set to "off", disables write caching for the LUN, if supported by the backend.
1043 Options specific for block backend:
1044 .Bl -tag -width 12n
1048 Specifies number of backend threads to use for this LUN.
1051 Options specific for ramdisk backend:
1052 .Bl -tag -width 12n
1066 Display the list of mode pages supported by LUN 1.
1068 .Dl ctladm modesense 1 -l
1070 Display the saved version of the Control mode page (page 10) on LUN 0.
1074 .Dl ctladm modesense 0 -m 10 -P 3 -d -c 10
1077 .Bd -literal
1078 .Dl ctladm read 2 -l 0 -d 1 -b 512 -f - > foo
1086 .Bd -literal
1087 .Dl ctladm write 3 -l 0xff432140 -d 20 -b 512 -f /tmp/bar
1096 .Dl ctladm create -b ramdisk -s 10485760000000000
1102 .Dl ctladm create -b ramdisk -s 10T -o capacity=10G
1104 Create a LUN using the block backend, specify the ZFS volume
1114 .Dl ctladm create -b block -o file=/dev/zvol/tank/example -S MYSERIAL321 -d MYDEVID123
1119 .Dl ctladm port -c -O pp=11 -O vp=12
1123 .Dl ctladm port -r -p 4
1126 Remove LUN 12, which is handled by the block backend, from the system.
1128 .Dl ctladm remove -b block -l 12
1130 List configured LUNs in the system, along with their backend and serial
1145 .Dl ctladm inject 6 -i mediumerr -p read -r 0,512 -c
1151 .Bd -literal -offset indent
1152 ctladm inject 6 -i custom -p tur -s 18 "f0 0 02 s12 04 02"