util-linux-raw-man.patch

   1 --- util-linux-2.11f/disk-utils/raw.8.sopwith   Tue Feb 26 13:15:34 2002
   2 +++ util-linux-2.11f/disk-utils/raw.8   Tue Feb 26 13:16:28 2002
   3 @@ -15,6 +15,12 @@
   4  .PP
   5  .B raw
   6  .B \-qa
   7 +.SH WARNING
   8 +Although Linux includes support for rawio, it is now a deprecated interface. If
   9 +your application performs device access using this interface, Red Hat
  10 +encourages you to modify your application to open the block device with the
  11 +O_DIRECT flag. The rawio interface is a candidate for removal from future releases.
  12 +
  13  .SH DESCRIPTION
  14  .B raw
  15  is used to bind a Linux raw character device to a block device.  Any
  16 @@ -58,6 +58,11 @@
  17  disk, they must be an exact number of sectors long, and the data buffer
  18  in virtual memory must also be aligned to a multiple of the sector
  19  size.  The sector size is 512 bytes for most devices.
  20 +.PP
  21 +Use the /etc/sysconfig/rawdevices file to define the set of raw device
  22 +mappings automatically created during the system startup sequence. The
  23 +format of the file is the same used in the command line with the exception
  24 +that the "raw" command itself is omitted.
  25  .SH OPTIONS
  26  .TP
  27  .B -q
  28 @@ -82,8 +88,10 @@
  29  .SH BUGS
  30  The Linux
  31  .B dd
  32 -(1) command does not currently align its buffers correctly, and so
  33 -cannot be used on raw devices.
  34 +(1) command should be used without bs= option or the blocksize needs to be a
  35 +multiple of the sector size of the device (512 bytes usually) otherwise it
  36 +will fail with "Invalid Argument" messages (EINVAL).
  37 +
  38  .PP
  39  Raw I/O devices do not maintain cache coherency with the Linux block
  40  device buffer cache.  If you use raw I/O to overwrite data already in