yahns Ruby server user/dev discussion
 help / color / mirror / code / Atom feed
From: Eric Wong <e@80x24.org>
To: yahns-public@yhbt.net
Subject: [RFC] remove documentation for client_*_buffer_size knobs
Date: Mon, 16 Mar 2015 21:15:32 +0000	[thread overview]
Message-ID: <20150316211532.GA17889@dcvr.yhbt.net> (raw)

Memory management is tricky when dealing with thousands of connected
clients and various malloc implementations.  Any thoughts on this
greatly appreciated, thanks.

In the future, we may remove these options entirely.  For now,
having too much documentation and tuning options may confuse new
users and minimize the importance/visibility of other options,
so remove documentation for this.

I'm not convinced user-space buffer size tuning has a place in
an application server written in a high-level language.  Heck,
many servers written in C do not have this.
---
 Documentation/yahns_config.txt | 18 ------------------
 1 file changed, 18 deletions(-)

diff --git a/Documentation/yahns_config.txt b/Documentation/yahns_config.txt
index d18263d..7a507a4 100644
--- a/Documentation/yahns_config.txt
+++ b/Documentation/yahns_config.txt
@@ -201,24 +201,6 @@ Ruby it is running under.
 
     Default: false
 
-* client_body_buffer_size INTEGER
-
-    This controls the maximum size of a request body before it is
-    buffered to the filesystem (instead of memory).  This has no effect
-    if input_buffering is false.  This also governs the size of an
-    individual read(2) system call when reading a request body.
-
-    Default: 8192 bytes (8 kilobytes)
-
-* client_header_buffer_size INTEGER
-
-    This controls the size of a single read(2) syscall for reading
-    client request headers.  Increase this as needed if your application
-    uses large cookies or long URLs.  Lowering this may reduce GC and
-    memory allocator overhead.
-
-    Default 4000 bytes
-
 * client_max_body_size {INTEGER|nil}
 
     This controls the maximum request body size before a client is
-- 
EW

             reply	other threads:[~2015-03-16 21:15 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-03-16 21:15 Eric Wong [this message]
2015-03-16 22:40 ` [RFC] remove documentation for client_*_buffer_size knobs Lin Jen-Shin (godfat)
2015-03-18 20:00   ` Eric Wong

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://yhbt.net/yahns/README

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20150316211532.GA17889@dcvr.yhbt.net \
    --to=e@80x24.org \
    --cc=yahns-public@yhbt.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhbt.net/yahns.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).