From 622e66944c420ba0beae1d99a8a526d55557e54d Mon Sep 17 00:00:00 2001 From: Ralf Habacker Date: Wed, 23 Dec 2009 23:28:48 +0100 Subject: [PATCH] added tranport address format to dbus specification --- doc/dbus-specification.xml | 137 ++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 128 insertions(+), 9 deletions(-) diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 901e665..cad1e71 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -1,4 +1,4 @@ - + D-Bus Specification - Version 0.12 - 7 November 2006 + Version 0.13 + 23 Dezember 2009 Havoc @@ -2425,22 +2425,98 @@ length path name. Names which were shorter than the fixed length would be padded by Nul bytes. + + Unix domain sockets are not available on windows. + + + Server Address Format + + Unix domain socket addresses are identified by the "unix:" prefix + and support the following key/value pairs: + + + + + + Name + Values + Description + + + + + path + (path) + path of the unix domain socket. If set, the "tmpdir" and "abstract" key must not be set. + + + tmpdir + (path) + temporary directory in which a socket file with a random file name starting with 'dbus-' will be created by the server. This key can only be used in server addresses, not in client addresses. If set, the "path" and "abstract" key must not be set. + + + abstract + (string) + unique string (path) in the abstract namespace. If set, the "path" or "tempdir" key must not be set. + + + + + TCP Sockets - The tcp transport provides TCP/IP based connections between clients + The tcp transport provides TCP/IP based connections between clients located on the same or different hosts. - - Windows notes: Because the tcp stack on windows do not provide sending - credentials over a tcp connection, the EXTERNAL authentification - mechanismus do not work. - Using tcp transport without any additional secure authentification mechanismus over a network is unsecure. + + Windows notes: Because of the tcp stack on windows does not provide sending + credentials over a tcp connection, the EXTERNAL authentification + mechanismus does not work. + + + Server Address Format + + TCP/IP socket addresses are identified by the "tcp:" prefix + and support the following key/value pairs: + + + + + + Name + Values + Description + + + + + host + (string) + dns name or ip address + + + port + (number) + The tcp port the server will open. A zero value let the server + choose a free port provided from the underlaying operating system. + libdbus is able to retrieve the real used port from the server. + + + + family + (string) + If set, provide the type of socket family either "ipv4" or "ipv6". If unset, the family is unspecified. + + + + + Nonce-secured TCP Sockets @@ -2473,6 +2549,49 @@ key-value pair and send it over the socket. After that, the transport behaves like an unsecured tcp transport. + + Server Address Format + + Nonce TCP/IP socket addresses uses the "nonce-tcp:" prefix + and support the following key/value pairs: + + + + + + Name + Values + Description + + + + + host + (string) + dns name or ip address + + + port + (number) + The tcp port the server will open. A zero value let the server + choose a free port provided from the underlaying operating system. + libdbus is able to retrieve the real used port from the server. + + + + family + (string) + If set, provide the type of socket family either "ipv4" or "ipv6". If unset, the family is unspecified. + + + noncefile + (path) + file location containing the secret + + + + + -- 2.7.4