[DRBD-cvs] svn commit by lars - r2022 - branches/drbd-0.7/scripts - missing commit: make units more clear

[drbd-cvs at lists.linbit.com]

Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Author: lars
Date: 2005-12-21 09:59:20 +0100 (Wed, 21 Dec 2005)
New Revision: 2022

Modified:
   branches/drbd-0.7/scripts/drbd.conf
Log:
missing commit: make units more clear

Modified: branches/drbd-0.7/scripts/drbd.conf
===================================================================
--- branches/drbd-0.7/scripts/drbd.conf	2005-12-19 16:26:10 UTC (rev 2021)
+++ branches/drbd-0.7/scripts/drbd.conf	2005-12-21 08:59:20 UTC (rev 2022)
@@ -7,7 +7,13 @@
 # you ought to know about the protocol, and the various timeouts.
 #
 # you probably want to set the rate in the syncer sections
+
 #
+# NOTE common pitfall:
+# rate is given in units of _byte_ not bit
+#
+
+#
 # increase timeout and maybe ping-int in net{}, if you see
 # problems with "connection lost/connection established"
 # (or change your setup to reduce network latency; make sure full
@@ -159,8 +165,8 @@
     # ping-int      10;    # 10 seconds  (unit = 1 second)
 
     # Maximal number of requests (4K) to be allocated by DRBD.
-    # The minimum is hardcoded to 32 (=128 kb).
-    # For hight performance installations it might help if you
+    # The minimum is hardcoded to 32 (=128 kByte).
+    # For high performance installations it might help if you
     # increase that number. These buffers are used to hold
     # datablocks while they are written to disk.
     #
@@ -185,8 +191,16 @@
 
   syncer {
     # Limit the bandwith used by the resynchronisation process.
-    # default unit is KB/sec; optional suffixes K,M,G are allowed
+    # default unit is kByte/sec; optional suffixes K,M,G are allowed.
     #
+    # Even though this is a network setting, the units are based
+    # on _byte_ (octet for our french friends) not bit.
+    # We are storage guys.
+    #
+    # Note that on 100Mbit ethernet, you cannot expect more than
+    # 12.5 MByte total transfer rate.
+    # Consider using GigaBit Ethernet.
+    #
     rate 10M;
 
     # All devices in one group are resynchronized parallel.