# phpman > man > sg_stream_ctl(8) [SG_STREAM_CTL(8)](https://www.chedong.com/phpMan.php/man/SGSTREAMCTL/8/markdown) SG3_UTILS [SG_STREAM_CTL(8)](https://www.chedong.com/phpMan.php/man/SGSTREAMCTL/8/markdown) ## NAME sg_stream_ctl - send SCSI STREAM CONTROL or GET STREAM STATUS command ## SYNOPSIS **sg**___**stream**___**ctl** [_--brief_] [_--close_] [_--ctl=CTL_] [_--get_] [_--help_] [_--id=SID_] [_--maxlen=LEN_] [_--open_] [_--readonly_] [_--verbose_] [_--version_] _DEVICE_ ## DESCRIPTION Sends a SCSI STREAM CONTROL or GET STREAM STATUS command to the _DEVICE_. These commands, to‐ gether with WRITE STREAM(16 and 32) and several fields in the Block Limits Extension VPD page [0xb7] support the streams concept. The stream commands were added in SBC-4 draft 8 (Septem‐ ber 2015). Both STREAM CONTROL and GET STREAM STATUS commands expect data from the _DEVICE_ (referred to as 'data-in'). In the case of STREAM CONTROL only the 'open' (STR_CTL<--0x1) actually needs the data-in as it contains the "Assigned stream id" if the open was successful. The assigned stream id should be used by subsequent WRITE STREAM commands and ultimately by the STREAM CONTROL close (STR_CTL<--0x2). Valid stream ids are between 1 and 65535 inclusive. ## OPTIONS Arguments to long options are mandatory for short options as well. ### -b --brief this option reduces the output of the GET STREAM STATUS command to just one number (in decimal) per line sent to stdout. Those numbers are the currently open stream ids. If an error occurs then -1 is sent to stdout and error related messages are sent to stderr. The default is to print more words (and fields) from the GET STREAM STATUS re‐ sponse. ### -c --close selects the STREAM CONTROL command and sets STR_CTL<--0x2 (i.e. 'close'). The _--id=SID_ option should also be given because it defaults to 0 which is not a valid stream id. ### -C --ctl _CTL_ is the value placed in the STR_CTL field of the STREAM CONTROL command (cdb). It is a two bit field so has 4 variants: 0 and 3 are reserved; 1 opens are new stream and 2 closes the given stream id. '--ctl=1' is equivalent to '--open' while '--ctl=2' is equivalent to '--close'. ### -g --get selects the GET STREAM STATUS command. If the _--id=SID_ option is also given the the response starts lists open stream ids from and including _SID_. If the _--id=SID_ option is not given (or _SID_ is 0) then all open stream id will be returned in the response (data-in) as long as the allocation length (defaults to 248 bytes which can be over‐ ridden by the _--maxlen=LEN_ option) is long enough. This is the default action of this utility (i.e. GET STREAM STATUS command) if no "selecting" options are given. ### -h --help output the usage message then exit. ### -i --id _SID_ is a stream id, a value between 1 and 65535. It is used by STREAM CONTROL (close) to identify the stream to close. It is used by the GET STREAM STATUS command as the starting stream id (from and including); so stream ids that are less than _SID_ will not appear in the response. ### -m --maxlen _LEN_ is the maximum length the response can be. It becomes the ALLOCATION LENGTH field in both commands. The default (in the absence of this option) is 8 bytes for STREAM CONTROL and 248 bytes for GET STREAM STATUS. ### -o --open selects the STREAM CONTROL command and sets STR_CTL<--0x1 (i.e. 'open'). If the _--id=SID_ option is given then it is ignored. The user should observe the response as the "Assigned stream id" is printed on stdout if the open is successful, if not '-1' is sent to stdout and error messages are sent to stderr. If the _--brief_ option is also given then the only thing sent to stdout is a number of the assigned stream id (1 to 65535 inclusive) or '-1' if there is an error. ### -r --readonly this option sets a 'read-only' flag when the underlying operating system opens the given _DEVICE_. This may not work since operating systems can not easily determine whether a pass-through command is a logical read or write operation on the media (or its metadata) so they take a risk averse stance and require read-write type permis‐ sions on the _DEVICE_ open irrespective of what is performed by the pass-through. ### -v --verbose increase the level of verbosity, (i.e. debug output). ### -V --version print the version string and then exit. ## NOTES There are no special read commands for streams. This implies that "normal" READs (6, 10, 12, 16 or 32) can be used. Note that when a stream is closed, all resources associated with that stream id are removed, apart from the data in the written LBAs. To make sure the reading back data is not delayed too much by error recovery (in the presence of media errors) the user may set the RECOVERY TIME LIMIT field (RTL, units for non-zero values: milliseconds) in the 'Read-write error recovery' mode page. This can be done with the sdparm utility. The SCSI WRITE STREAM (16 and 32) commands can be found in the sg_write_x utility in this package. ## EXIT STATUS The exit status of sg_stream_ctl is 0 when it is successful. Otherwise see the [sg3_utils(8)](https://www.chedong.com/phpMan.php/man/sg3utils/8/markdown) man page. ## AUTHORS Written by Douglas Gilbert. ## REPORTING BUGS Report bugs to . ## COPYRIGHT Copyright © 2018 Douglas Gilbert This software is distributed under a FreeBSD license. There is NO warranty; not even for MER‐ CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. ## SEE ALSO **sg**___**vpd,sg**___**write**___**x(sg3**___**utils);** **sdparm(sdparm)** sg3_utils-1.43 March 2018 [SG_STREAM_CTL(8)](https://www.chedong.com/phpMan.php/man/SGSTREAMCTL/8/markdown)