From: Eric Wong <e@80x24.org>
To: cmogstored-public@yhbt.net
Subject: [PATCH] doc: add "USAGE FILES" section to manpage
Date: Sat, 25 Jul 2020 01:46:18 +0000 [thread overview]
Message-ID: <20200725014618.24359-1-e@80x24.org> (raw)
And fix formatting of the SIGNALS section while we're at it.
---
cmogstored.x | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/cmogstored.x b/cmogstored.x
index 701fde9..b288e2d 100644
--- a/cmogstored.x
+++ b/cmogstored.x
@@ -1,5 +1,6 @@
[SIGNALS]
SIGQUIT - gracefully shutdown the server
+
SIGUSR2 - upgrade executable on the fly
[UPGRADING]
@@ -31,6 +32,20 @@ on inherited file descriptors being contiguous.
See MALLOC TUNING for environment variables which may affect memory
usage.
+[USAGE FILES]
+
+Like Perl mogstored(1), cmogstored writes "devNNN/usage" files for
+mogilefsd(1) instances to monitor disk space utilization.
+
+As of cmogstored 1.7, this information is stored in-memory in case the
+device becomes too full to write the usage file. Users may choose to
+make usage files unwritable (via "chmod 000") to reduce disk wear on
+otherwise read-mostly devices.
+
+As of cmogstored 1.8, the in-memory representation of these usage files
+is updated by PUT and DELETE HTTP requests in case write traffic is too
+high for periodic (10s) updates.
+
[MALLOC TUNING]
malloc(3) implementations tuned for multithreading speed (and not memory
reply other threads:[~2020-07-25 1:46 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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/cmogstored/README
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200725014618.24359-1-e@80x24.org \
--to=e@80x24.org \
--cc=cmogstored-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/cmogstored.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).