Lines Matching +full:read +full:- +full:access +full:- +full:delay

3 .\" Copyright (c) 2015-2021 Alexander Motin <mav@FreeBSD.org>
36 .\" $Id: //depot/users/kenm/FreeBSD-test2/usr.sbin/ctladm/ctladm.8#3 $
67 .Ic read
72 .Aq Fl f Ar file|-
82 .Aq Fl f Ar file|-
123 .Ic delay
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
213 utility is designed to provide a way to access and control the CAM Target
218 some meta-commands that utilize
232 .Bl -tag -width 14n
239 .Bl -tag -width 10n
255 .Bl -tag -width 11n
275 .It Ic read
278 READ command to the device, and write the requested data to a file or
280 .Bl -tag -width 12n
282 Specify the starting Logical Block Address for the READ.
287 Specify the length, in 512 byte blocks, of the READ request.
289 Specify the destination for the data read by the READ command.
291 .Sq -
296 CDB (Command Data Block) size to be used for the READ request.
300 READ(16) must be used to satisfy the request.)
308 READ CAPACITY command.
312 from the kernel when doing a read, just execute the command without copying
317 Read data from a file or stdin, and write the data to the device using the
320 .Bl -tag -width 12n
331 .Sq -
336 CDB (Command Data Block) size to be used for the READ request.
339 may be used to satisfy the request.  (e.g., for LBAs above 0xffffffff, READ(16)
348 READ CAPACITY command.
359 READ CAPACITY command to the device and display the device size and device
361 By default, READ CAPACITY(10) is used.
364 will automatically issue a READ CAPACITY(16), which is implemented as a
379 .Bl -tag -width 10n
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.
478 .It Ic delay
479 Delay commands at the given location.
490 .Bl -tag -width 12n
492 Delay command(s) at the specified location.
496 Delay command(s) for the specified number of seconds.
498 If set to 0, it will clear out any previously set delay for this particular
501 Specify the delay type.
503 .Ic delay
504 option will delay the next command sent to the given LUN.
532 .Bl -tag -width 17n
535 .Bl -tag -width 10n
542 MEDIUM ERROR (0x03) and the ASC/ASCQ 0x11,0x00 ("Unrecovered read error") for
543 reads, or ASC/ASCQ 0x0c,0x02 ("Write error - auto reallocation failed")
558 .Bl -tag -width 10n
559 .It read
560 The error should apply to READ(6), READ(10), READ(12), READ(16), etc.
565 The error should apply to both read and write type commands.
567 The error should apply to READ CAPACITY(10) and READ CAPACITY(16) commands.
576 This option is only applies when read and/or write patterns are specified.
581 .Sq - ,
582 len bytes of sense data will be read from standard input and written to the
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
761 .Bl -tag -width 14n
774 Specify the LUN-associated string to use in the
781 Specify a backend-specific name/value pair.
796 If this flag is not used, the type of LUN created is backend-specific.
798 Currently CTL supports Direct Access (type 0), Processor (type 3)
806 Backend-specific options may also be specified with the
809 .Bl -tag -width 14n
819 Specify a backend-specific name/value pair.
828 .Bl -tag -width 14n
838 Specify a backend-specific name/value pair.
855 .Bl -tag -width 11n
865 This will also display any backend-specific LUN attributes in addition to
866 the standard per-LUN information.
883 .Bl -tag -width 11n
893 .Bl -tag -width 11n
905 .Bl -tag -width 11n
918 .Bl -tag -width 11n
928 .Bl -tag -width 11n
943 Some options are global, others are backend-specific.
946 .Bl -tag -width 12n
956 Specifies LUN EUI-64 identifier.
962 EXTENDED COPY command access the LUN.
963 Non-unique LUN identifiers may lead to data corruption.
968 Specified LUN text identification information (UTF-8 string).
973 Setting to "on" allows EXTENDED COPY command sent to this LUN access
978 Set to "off", disables read caching for the LUN, if supported by the backend.
994 Set to "read" to fully serialize consecutive reads.
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".
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.
1044 .Bl -tag -width 12n
1052 .Bl -tag -width 12n
1068 .Dl ctladm modesense 1 -l
1074 .Dl ctladm modesense 0 -m 10 -P 3 -d -c 10
1076 Read the first 512 byte block from LUN 2 and dump it to the file
1077 .Bd -literal
1078 .Dl ctladm read 2 -l 0 -d 1 -b 512 -f - > foo
1081 Read 10240 bytes from the file
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
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
1128 .Dl ctladm remove -b block -l 12
1142 Inject a medium error on LUN 6 for every read that covers the first 512
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"