svn commit: r308532 - head/share/man/man4

Andriy Gapon avg at FreeBSD.org
Fri Nov 11 15:16:38 UTC 2016


Author: avg
Date: Fri Nov 11 15:16:37 2016
New Revision: 308532
URL: https://svnweb.freebsd.org/changeset/base/308532

Log:
  update SMB_BWRITE documentation, clarify SMB_BREAD
  
  After removal of SMB_TRANS some information in the description of
  SMB_BWRITE has become stale.  E.g., the maximum block size has been
  restored to 32.
  
  Also, the descriptions of SMB_BREAD and SMB_BWRITE had some
  incorrect information on the SMBus protocol details.
  
  MFC after:	1 week
  X-MFC with:	r308242
  Differential Revision: https://reviews.freebsd.org/D8431

Modified:
  head/share/man/man4/smb.4

Modified: head/share/man/man4/smb.4
==============================================================================
--- head/share/man/man4/smb.4	Fri Nov 11 15:13:30 2016	(r308531)
+++ head/share/man/man4/smb.4	Fri Nov 11 15:16:37 2016	(r308532)
@@ -141,26 +141,25 @@ in
 .Em BlockWrite
 first sends the byte from
 .Fa cmd
-to the device, followed by
+to the device, then the byte from
+.Fa wcount
+followed by
 .Fa wcount
 bytes of data that are taken from the buffer pointed to by
 .Fa wbuf .
 The SMBus specification mandates that no more than 32 bytes of
-data can be transferred in a single block read or write command,
-but since
-.Xr smbus 4
-is also used to access I2C devices, the limit has been increased
-to 1024.
+data can be transferred in a single block read or write command.
 This value can be read from the constant
 .Dv SMB_MAXBLOCKSIZE .
 .It Dv SMB_BREAD Ta
 .Em BlockRead
 first sends the byte from
 .Fa cmd
-to the device, then reads
-.Fa rcount
-bytes of data that from the device.
-This data is returned in the buffer pointed to by
+to the device, then reads a count of data bytes that the device
+is going to provide and then reads that many bytes.
+The count is returned in
+.Fa rcount.
+The data is returned in the buffer pointed to by
 .Fa rbuf .
 .El
 .Pp


More information about the svn-src-all mailing list