sg_referrals(8) [centos man page]

SG_REFERRALS(8) 						     SG3_UTILS							   SG_REFERRALS(8)

NAME

       sg_referrals - send SCSI REPORT REFERRALS command

SYNOPSIS

       sg_referrals [--help] [--hex] [--lba=LBA] [--maxlen=LEN] [--one-segment] [--raw] [--verbose] [--version] DEVICE

DESCRIPTION

       Send the SCSI REPORT REFERRALS command to the DEVICE and outputs the response. This command was introduced in (draft) SBC-3 revision 24 and
       devices that support referrals should support this command.

       The default action is to decode the response for all user data segment referral descriptors. The amount of output can  be  reduced  by  the
       --lba and --one-segment options.

OPTIONS

       Arguments to long options are mandatory for short options as well.

       -h, --help
	      output the usage message then exit.

       -H, --hex
	      output response to this command in ASCII hex.

       -l, --lba=LBA
	      where  LBA  is  the Logical Block Address (LBA) in the first user data segment the DEVICE should report the referrals parameter data
	      for.

       -m, --maxlen=LEN
	      where LEN is the (maximum) response length in bytes. It is placed in the cdb's "allocation length" field. If not given then  256	is
	      used. 256 is enough space for the response header and user data segment descriptors.

       -s, --one-segment
	      report the user data segment of the segment spefified by the LBA parameter only.

       -r, --raw
	      output response in binary (to stdout).

       -v, --verbose
	      increase the level of verbosity, (i.e. debug output). Additional output caused by this option is sent to stderr.

       -V, --version
	      print the version string and then exit.

NOTES

       For a discussion of referrals see section 4.25 of sbc3r25.pdf at http://www.t10.org (or the corresponding section of a later draft).

EXIT STATUS

       The exit status of sg_referrals is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

AUTHORS

       Written by Douglas Gilbert and Hannes Reinecke.

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

       Copyright (C) 2009-2012 Douglas Gilbert and Hannes Reinecke
       This  software  is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
       POSE.

SEE ALSO

       sg_vpd(8)

sg3_utils-1.35							   November 2012						   SG_REFERRALS(8)

SG_SYNC(8)							     SG3_UTILS								SG_SYNC(8)

NAME

       sg_sync - send the scsi command synchronize cache

SYNOPSIS

       sg_sync [--count=COUNT] [--group=GROUP] [--help] [--immed] [--lba=LBA] [--sync-nv] [--verbose] [--version] DEVICE

DESCRIPTION

       Send SYNCHRONIZE CACHE (10) command to DEVICE. This command is defined for SCSI block devices (see SBC-2). If successful this command makes
       sure that any blocks whose latest versions are held in (volatile) cache are written to (also termed as "synchronized with") the medium.	If
       the  --sync-nv option is given and the device has a non-volatile cache then any blocks whose latest versions are held in volatile cache are
       written to non-volatile cache.

       If the LBA and COUNT arguments are both zero (their defaults) then all blocks in the cache are synchronized. If LBA is  greater	than  zero
       while  COUNT is zero then blocks in the cache whose addresses are from and including LBA to the highest lba on the device are synchronized.
       If both LBA and COUNT are non zero then blocks in the cache whose addresses lie in the range LBA to LBA+COUNT-1 inclusive are  synchronized
       with the medium.

OPTIONS

       Arguments to long options are mandatory for short options as well.

       -c, --count=COUNT
	      where  COUNT  is	the  number  of  blocks  to  synchronize from and including LBA. Default value is 0. When 0 then all blocks in the
	      (volatile) cache from and including LBA argument to the highest block address are synchronized.

       -g, --group=GROUP
	      where GROUP is the group number which can be between 0 and 31 inclusive.	The default value is 0 . Group numbers are used to  segre-
	      gate data collected within the device. This is a new feature in SBC-2 and can probably be ignored for the time being.

       -h, --help
	      output the usage message then exit.

       -i, --immed
	      sets  the  IMMED	bit  in  the  SYNCHRONIZE CACHE command. This instructs the device, if the format of the command is acceptable, to
	      return a GOOD status immediately rather than wait for the blocks in the (volatile) cache to be synchronized with (i.e.  written  to)
	      the medium (or the non-volatile cache).

       -l, --lba=LBA
	      where  LBA  is  the  lowest  logical block address in the (volatile) cache to synchronize to the medium (or the non-volatile cache).
	      Default value is 0 .

       -s, --sync-nv
	      synchronize the (volatile) cache with the non-volatile cache. Without this option (or if there  is  no  non-volatile  cache  in  the
	      device) the synchronization is with the medium.

       -v, --verbose
	      increase the level of verbosity, (i.e. debug output).

       -V, --version
	      print the version string and then exit.

NOTES

       Various numeric arguments (e.g. LBA) may include multiplicative suffixes or be given in hexadecimal. See the "NUMERIC ARGUMENTS" section in
       the sg3_utils(8) man page.

EXIT STATUS

       The exit status of sg_sync is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

AUTHORS

       Written by Douglas Gilbert.

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

       Copyright (C) 2004-2009 Douglas Gilbert
       This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A  PARTICULAR  PUR-
       POSE.

SEE ALSO

       sg_start(sg3_utils)

sg3_utils-1.27							    March 2009								SG_SYNC(8)