wipefs: add --lock and LOCK_BLOCK_DEVICE

[thirdparty/util-linux.git] / disk-utils / raw.8

diff --git a/disk-utils/raw.8 b/disk-utils/raw.8
index babdbd441a5d14faea06857af385ad7d24801d3e..ba9fd256a81b302fdbc141e49b925afde0f3dce7 100644 (file)
--- a/disk-utils/raw.8
+++ b/disk-utils/raw.8
@@ -1,5 +1,4 @@
-.\" -*- nroff -*-
-.TH RAW 8 "Aug 1999" "Version 0.1"
+.TH RAW 8 "August 1999" "util-linux" "System Administration"
 .SH NAME
 raw \- bind a Linux raw character device
 .SH SYNOPSIS
@@ -9,17 +8,10 @@ raw \- bind a Linux raw character device
 .B raw
 .I /dev/raw/raw<N> /dev/<blockdev>
 .PP
-.B raw
-.B \-q
+.B raw \-q
 .I /dev/raw/raw<N>
 .PP
-.B raw
-.B \-qa
-.SH WARNING
-The rawio is a deprecated interface since Linux kernel 2.6.3. Please,
-modify your application to open the block device with the
-O_DIRECT flag.
-
+.B raw \-qa
 .SH DESCRIPTION
 .B raw
 is used to bind a Linux raw character device to a block device.  Any
@@ -41,10 +33,10 @@ device numbers, or as a path name
 .I /dev/<blockdev>
 to an existing block device file.
 .PP
-The bindings already in existence can be queried with the 
+The bindings already in existence can be queried with the
 .I \-q
-option, with is used either with a raw device filename to query that one
-device, or with the 
+option, which is used either with a raw device filename to query that one
+device, or with the
 .I \-a
 option to query all bound raw devices.
 .PP
@@ -67,24 +59,32 @@ in virtual memory must also be aligned to a multiple of the sector
 size.  The sector size is 512 bytes for most devices.
 .SH OPTIONS
 .TP
-.B -q
+\fB\-q\fR, \fB\-\-query\fR
 Set query mode.
 .B raw
 will query an existing binding instead of setting a new one.
 .TP
-.B -a
+\fB\-a\fR, \fB\-\-all\fR
 With
-.B -q
-, specifies that all bound raw devices should be queried.
+.B \-q
+, specify that all bound raw devices should be queried.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display help text and exit.
 .TP
-.B -h
-provides a usage summary.
+\fB\-V\fR, \fB\-\-version\fR
+Display version information and exit.
+
+.SH NOTES
+Rather than using raw devices applications should prefer
+.BR open (2)
+devices, such as /dev/sda1, with the O_DIRECT flag.
 .SH BUGS
 The Linux
-.B dd
-(1) command should be used without bs= option or the blocksize needs to be a
-multiple of the sector size of the device (512 bytes usually) otherwise it
-will fail with "Invalid Argument" messages (EINVAL).
+.BR dd (1)
+command should be used without the \fBbs=\fR option, or the blocksize
+needs to be a multiple of the sector size of the device (512 bytes usually),
+otherwise it will fail with "Invalid Argument" messages (EINVAL).
 
 .PP
 Raw I/O devices do not maintain cache coherency with the Linux block
@@ -92,8 +92,8 @@ device buffer cache.  If you use raw I/O to overwrite data already in
 the buffer cache, the buffer cache will no longer correspond to the
 contents of the actual storage device underneath.  This is deliberate,
 but is regarded either a bug or a feature depending on who you ask!
-.SH AUTHOR
+.SH AUTHORS
 Stephen Tweedie (sct@redhat.com)
 .SH AVAILABILITY
-The raw command is part of the util-linux-ng package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
+The raw command is part of the util-linux package and is available from
+https://www.kernel.org/pub/linux/utils/util-linux/.