aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-04-25 14:18:44 +0200
committerMattias Andrée <maandree@operamail.com>2015-04-25 14:18:44 +0200
commitbe448e668988a19a9c257b69f469eb82395fff7a (patch)
tree21472f2a3f6beb4d50ee267008d772c211d09f24 /README
parenta more descriptive readme (diff)
downloadbus-be448e668988a19a9c257b69f469eb82395fff7a.tar.gz
bus-be448e668988a19a9c257b69f469eb82395fff7a.tar.bz2
bus-be448e668988a19a9c257b69f469eb82395fff7a.tar.xz
add message length restriction and message format to readme
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to 'README')
-rw-r--r--README8
1 files changed, 8 insertions, 0 deletions
diff --git a/README b/README
index bd71e2e..3069d86 100644
--- a/README
+++ b/README
@@ -4,6 +4,14 @@ bus uses a System V semaphore array and System V shared memory.
Buses are named; the key of the semaphore array and the
shared memory is stored in a regular file.
+The shared memory used by bus is always 2048 bytes. Additionally
+all messages should be encoded in UTF-8 and not contain any NULL
+characters, except they MUST always end with a zero byte.
+Furthermore messages should be prefixed with the process
+identifer of the process whence the message originated, followed
+by a space. If the process is ephemeral, 0 should be used instead
+of the process identifier.
+
Communication over bus is synchronous. The broadcast call does
not return until all listeners have received (and copyied)
the message.