From e850b54772f4303d49b504507bfec1e1125712c4 Mon Sep 17 00:00:00 2001
From: Brian Warner <warner@lothar.com>
Date: Sun, 13 May 2012 14:07:39 -0700
Subject: [PATCH] performance.rst: small updates, mention (lack of) MDMF

refs #1398
---
 docs/performance.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/performance.rst b/docs/performance.rst
index 4657c151..1766d381 100644
--- a/docs/performance.rst
+++ b/docs/performance.rst
@@ -28,6 +28,11 @@ written
 
 ``G`` indicates the number of storage servers on your grid
 
+Most of these cost estimates may have a further constant multiplier: when a
+formula says ``N/K*S``, the cost may actually be ``2*N/K*S`` or ``3*N/K*S``.
+Also note that all references to mutable files are for SDMF-formatted files;
+this document has not yet been updated to describe the MDMF format.
+
 Publishing an ``A``-byte immutable file
 =======================================
 
@@ -210,10 +215,15 @@ cpu: variable, between ~A and ~N/K*A
 
 network: variable; between A and N/K*A
 
-memory footprint: (1+N/K)*S
+memory footprint (immutable): (1+N/K)*S
+              (SDMF mutable): (1+N/K)*A
 
 notes: To repair a file, Tahoe-LAFS downloads the file, and
 generates/uploads missing shares in the same way as when it initially
 uploads the file.  So, depending on how many shares are missing, this
 can cost as little as a download or as much as a download followed by
 a full upload.
+
+Since SDMF files have only one segment, which must be processed in its
+entirety, repair requires a full-file download followed by a full-file
+upload.
-- 
2.45.2