2003-03-05 Anders Carlsson <andersca@codefactory.se>

* dbus/dbus-transport.c: (_dbus_transport_open):
	Remove duplicate "tcp" entry.

	* doc/dbus-specification.sgml:
	Clarify some things.
This commit is contained in:
Anders Carlsson 2003-03-04 23:02:40 +00:00
parent 25d00e5bad
commit 942a69b1cd
3 changed files with 42 additions and 24 deletions

View file

@ -1,3 +1,11 @@
2003-03-05 Anders Carlsson <andersca@codefactory.se>
* dbus/dbus-transport.c: (_dbus_transport_open):
Remove duplicate "tcp" entry.
* doc/dbus-specification.sgml:
Clarify some things.
2003-03-05 Anders Carlsson <andersca@codefactory.se>
* dbus/dbus-auth.c: (send_rejected), (process_test_subdir):

View file

@ -219,15 +219,6 @@ _dbus_transport_open (const char *address,
transport = _dbus_transport_new_for_tcp_socket (host, lport, FALSE, result);
}
else if (strcmp (method, "tcp") == 0)
{
const char *path = dbus_address_entry_get_value (entries[i], "path");
if (path == NULL)
goto bad_address;
transport = _dbus_transport_new_for_domain_socket (path, FALSE, result);
}
#ifdef DBUS_BUILD_TESTS
else if (strcmp (method, "debug") == 0)
{

View file

@ -683,6 +683,9 @@
</figure>
</para>
</sect2>
</sect1>
<sect1>
</sect1>
<sect1 id="addresses">
<title>Server Addresses</title>
@ -1008,6 +1011,12 @@
ownership whenever another application requests ownership of the
service.
</para>
<para>
When a client disconnects from the bus, all the services that
the clients own are deleted, or in the case of a service that
prohibits replacement, ownership is transferred to the next
client in the queue, if any.
</para>
</sect2>
<sect2 id="message-bus-routing">
<title>Message Bus Message Routing</title>
@ -1039,16 +1048,18 @@
in different places, see <xref linkend="message-bus-types">.
</para>
<para>
[FIXME the file format should be much better specified than
"similar to .desktop entries" esp. since desktop entries
are already badly-specified. ;-)]
Service description files have the ".service" file
extension. The message bus will only load service description
files ending with .service; all other files will be ignored.
The file format is similar to that of <ulink
url="http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html">desktop
entries</ulink>. All service description files must be in
UTF-8 encoding.
[FIXME the file format should be much better specified than
"similar to .desktop entries" esp. since desktop entries are
already badly-specified. ;-)] Service description files have
the ".service" file extension. The message bus will only load
service description files ending with .service; all other
files will be ignored. The file format is similar to that of
<ulink
url="http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html">desktop
entries</ulink>. All service description files must be in
UTF-8 encoding. To ensure that there will be no name
collisions, service files must be namespaced using the same
mechanism as messages and service names.
<figure>
<title>Example service description file</title>
@ -1061,17 +1072,25 @@
</figure>
</para>
<para>
When an application requests a service to be activated, the bus
daemon tries to find it in the list of activation entries. It
then tries to spawn the executable associated with it. If this
fails, it will report an error. [FIXME what happens if two
.service files offer the same service; what kind of error is reported]
When an application requests a service to be activated, the
bus daemon tries to find it in the list of activation
entries. It then tries to spawn the executable associated with
it. If this fails, it will report an error. [FIXME what
happens if two .service files offer the same service; what
kind of error is reported, should we have a way for the client
to choose one?]
</para>
<para>
The executable launched will have the environment variable
<literal>DBUS_BUS_ADDRESS</literal> set to the address of the
message bus so it can connect and register the appropriate services.
</para>
<para>
[FIXME there should be a timeout somewhere, either specified
in the .service file, by the client, or just a global value
and if the client being activated fails to connect within that
timeout, an error should be sent back.]
</para>
</sect2>
<sect2 id="message-bus-types">