diff options
Diffstat (limited to 'sg_sync.8')
-rw-r--r-- | sg_sync.8 | 93 |
1 files changed, 48 insertions, 45 deletions
@@ -1,73 +1,76 @@ -.TH SG_SYNC "8" "October 2006" "sg3_utils-1.22" SG3_UTILS +.TH SG_SYNC "8" "December 2006" "sg3_utils\-1.22" SG3_UTILS .SH NAME sg_sync \- send the scsi command synchronize cache .SH SYNOPSIS .B sg_sync -[\fI--count=<n>\fR] [\fI--group=<n>\fR] [\fI--help\fR] [\fI--immed\fR] -[\fI--lba=<n>\fR] [\fI--sync-nv\fR] [\fI--verbose\fR] [\fI--version\fR] -\fI<scsi_device>\fR +[\fI\-\-count=COUNT\fR] [\fI\-\-group=GROUP\fR] [\fI\-\-help\fR] +[\fI\-\-immed\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-sync\-nv\fR] +[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here .PP -Send SYNCHRONIZE CACHE (10) command to a SCSI 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. +Send SYNCHRONIZE CACHE (10) command to \fIDEVICE\fR. 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 \fI\-\-sync\-nv\fR 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. .PP -If the arguments to '--lba' and '--count' 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 address -is from and including the '--lba' argument 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_argument to -lba_argument+count_argument-1 inclusive are synchronized with the medium. +If the \fILBA\fR and \fICOUNT\fR arguments are both zero (their defaults) +then all blocks in the cache are synchronized. If \fILBA\fR is greater than +zero while \fICOUNT\fR is zero then blocks in the cache whose addresses are +from and including \fILBA\fR to the highest lba on the device are +synchronized. If both \fILBA\fR and \fICOUNT\fR are non zero then blocks in +the cache whose addresses lie in the range \fILBA\fR to +\fILBA\fR+\fICOUNT\fR\-1 inclusive are synchronized with the medium. +.SH OPTIONS +Arguments to long options are mandatory for short options as well. .TP ---count=<n> | -c <n> -number of block to synchronize from and including the '--lba' argument. -Default value is 0. When 0 then all blocks in the (volatile) cache from -and including the '--lba' argument to the highest block address are +\fB\-c\fR, \fB\-\-count\fR=\fICOUNT\fR +where \fICOUNT\fR is the number of blocks to synchronize from and including +\fILBA\fR. Default value is 0. When 0 then all blocks in the (volatile) cache +from and including \fILBA\fR argument to the highest block address are synchronized. .TP ---group=<n> | -g <n> -the group number can be between 0 and 31 inclusive. The default value is 0 . -Group numbers are used to segregate data collected within the device. -This is a new feature in SBC-2 and can probably be ignored for the time -being. +\fB\-g\fR, \fB\-\-group\fR=\fIGROUP\fR +where \fIGROUP\fR is the group number which can be between 0 and 31 inclusive. +The default value is 0 . Group numbers are used to segregate data collected +within the device. This is a new feature in SBC\-2 and can probably be +ignored for the time being. .TP ---help | -h +\fB\-h\fR, \fB\-\-help\fR output the usage message then exit. .TP ---imm | -i -sets the "imm" bit in the SYNCHRONIZE CACHE command. This instructs the +\fB\-i\fR, \fB\-\-immed\fR +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). +non\-volatile cache). .TP ---lba=<n> | -l <n> -the lowest logical block address in the (volatile) cache to synchronize -to the medium (or the non-volatile cache). Default value is 0 . +\fB\-l\fR, \fB\-\-lba\fR=\fILBA\fR +where \fILBA\fR is the lowest logical block address in the (volatile) +cache to synchronize to the medium (or the non\-volatile cache). Default +value is 0 . .TP ---sync-nv | -s -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. +\fB\-s\fR, \fB\-\-sync-nv\fR +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. .TP ---verbose | -v +\fB\-v\fR, \fB\-\-verbose\fR increase the level of verbosity, (i.e. debug output). .TP ---version | -V +\fB\-V\fR, \fB\-\-version\fR print the version string and then exit. -.PP -The arguments to --count, --group and --lba may be followed by one of these -multiplicative suffixes: +.SH NOTES +The \fICOUNT\fR, \fIGROUP\fR and \fILBA\fR arguments may be followed by one +of these multiplicative suffixes: c C *1; w W *2; b B *512; k K KiB *1,024; KB *1,000; m M MiB *1,048,576; MB *1,000,000 . This pattern continues for "G", "T" and "P". Also a suffix of the form "x<n>" multiplies the leading number by <n>. The "T" and "P" -suffixes can only be used for --count and --lba. +suffixes can only be used for \fICOUNT\fR and \fILBA\fR. .PP Alternatively numerical values can be given in hexadecimal preceded by either "0x" or "0X" (or with a trailing "h" or "H"). When hex numbers are @@ -80,7 +83,7 @@ Written by Douglas Gilbert. .SH "REPORTING BUGS" Report bugs to <dgilbert at interlog dot com>. .SH COPYRIGHT -Copyright \(co 2004-2006 Douglas Gilbert +Copyright \(co 2004\-2006 Douglas Gilbert .br This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |