diff options
| author | Havoc Pennington <hp@redhat.com> | 2003-04-23 03:36:12 +0000 |
|---|---|---|
| committer | Havoc Pennington <hp@redhat.com> | 2003-04-23 03:36:12 +0000 |
| commit | da237031b3104ecdfe1f2df058179cda187fcbc8 (patch) | |
| tree | 5053b784185cee8e97c3962bdf418332a8e7e79a | |
| parent | b29d0c534a631b211f1f94168e7672c604c8f815 (diff) | |
2003-04-20 Havoc Pennington <hp@pobox.com>
* doc/dbus-specification.sgml: document the restrictions on
message and service names
| -rw-r--r-- | ChangeLog | 5 | ||||
| -rw-r--r-- | doc/TODO | 3 | ||||
| -rw-r--r-- | doc/dbus-specification.sgml | 19 |
3 files changed, 24 insertions, 3 deletions
@@ -1,3 +1,8 @@ +2003-04-20 Havoc Pennington <hp@pobox.com> + + * doc/dbus-specification.sgml: document the restrictions on + message and service names + 2003-04-22 Havoc Pennington <hp@redhat.com> * dbus/dbus-message.c, dbus/dbus-marshal.c: add 64-bit integer @@ -58,6 +58,3 @@ - if you send a message to a service then block for reply, and the service exits/crashes after the message bus has processed your message but before the service has replied, it would be nice if the message bus sent you an error reply. - - - We have a limit on the number of messages a connection can send, but - not on how many can be buffered for a given connection. diff --git a/doc/dbus-specification.sgml b/doc/dbus-specification.sgml index eda6c00e..d510ca6a 100644 --- a/doc/dbus-specification.sgml +++ b/doc/dbus-specification.sgml @@ -436,6 +436,25 @@ </informaltable> </para> </sect2> + + <sect2 id="message-protocol-names"> + <title>Valid names</title> + <para> + Messages and services have names with type STRING, meaning that + they must be valid UTF-8. However, there are also some + additional restrictions that apply to message and service names + specifically: + <itemizedlist> + <listitem><para>They must contain at least one '.' (period) character</para></listitem> + <listitem><para>They must not begin with a '.' (period) character</para></listitem> + <listitem><para>They must not exceed 256 bytes in length</para></listitem> + <listitem><para>They must be at least 1 byte in length</para></listitem> + </itemizedlist> + As a special exception, base service names (those beginning with a colon (':') character) + need not contain a period. + </para> + </sect2> + </sect1> <sect1 id="auth-protocol"> |