summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2013-10-09Imported Upstream version 1.7.6upstream/1.7.6Simon McVittie6-86/+352
2013-10-09D-Bus 1.7.6, spec 0.22Simon McVittie1-3/+6
2013-10-08Spec: document multiple .service files own the same well known nameChengwei Yang1-3/+22
In current dbus-daemon(1) implement, system .serivce must named after its owned name, but this is not the case for session .service. For session service, the result of multiple .service files own the same well known name is undefined since readdir(3) doesn't return dirent in a defined sequence. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 [added some </para><para> -smcv] Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-10-08spec: briefly describe Name, Exec and User keysSimon McVittie1-0/+13
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
2013-10-08spec: system services' service description files have constrained namesSimon McVittie1-0/+13
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
2013-09-13Remove obscure "low-latency" parts in the introduction of specJustin Lee1-9/+4
According to Wikipedia http://en.wikipedia.org/wiki/Latency_%28engineering%29#Packet-switched_networks latency means "the time from the source sending a packet to the destination receiving it". Therefore, latency is unrelated to whether the operation is asynchronous or synchronous. And also unrelated to whether it's one-way or round-trip. Latency exists for asynchronous and one-way transfer, because for current DBus implementations we need at least one context switch to transfer each message from the sender process to the receiver process. Emphasizing D-Bus is low-latency could encourage user to abuse/misuse the system. Mail disscusion: http://lists.freedesktop.org/archives/dbus/2013-May/015665.html Bug: https://bugs.freedesktop.org/show_bug.cgi?id=65141 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-09-13Fix dbus-daemon document about servicedirChengwei Yang1-1/+1
In dbus-daemon implementation, the servicedir are searched in order in which they appear in the config file. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66994 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-09-05Use GNU make features to reduce repetitionSimon McVittie1-21/+9
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=48277 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
2013-09-03Allow dbus-daemon --nofork on WindowsSimon McVittie1-4/+10
On Windows, the dbus-daemon is not able to fork (daemonize). If someone explicitly requests forking, it should fail, but if someone explicitly requests *not* forking, there seems no harm in allowing it. A few of the regression tests specifically require a dbus-daemon that will not fork, so allowing this option on Windows means those tests don't need an extra OS condition. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=68852 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-08-23DBus Spec: fix examples namespace to com.exampleChengwei Yang1-12/+12
There are a lot of examples in DBus Spec, and some of them just use the namespace org.freedesktop, and so as object namespace org/freedesktop. However, this is quite confusing. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66481 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-08-23dbus-run-session: remove various extra variables from the environmentSimon McVittie1-0/+7
DBUS_SESSION_BUS_PID is not mandatory to set, but we should unset it if present, since it points to a different session's bus. Likewise for DBUS_SESSION_BUS_WINDOWID. Similarly, if DBUS_STARTER_BUS_TYPE and DBUS_STARTER_ADDRESS are set (as they would be under GNOME Terminal 3.8, see <https://bugs.freedesktop.org/show_bug.cgi?id=63119>) then they are likely to point to a different session's bus. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39196 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Colin Walters <walters@verbum.org>
2013-08-23Revert "Factor out DBusAuthorization from DBusTransport"Simon McVittie1-8/+0
This reverts commit 600621dbc8073527a958091316eddfbb490c1032.
2013-08-23Factor out DBusAuthorization from DBusTransportCosimo Alfarano1-0/+8
In order to authorize/reject a connection in a polite way, instead of cutting it off after authentication succeed and Hello() is sent, because authorization failed, we need to factor out some authorization bits from DBusTransport and pass them to DBusAuth. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39720 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-08-22DBus Spec: Fix sample service fileChengwei Yang1-1/+1
There are two errors in the sample service file. First, a typo, Names should be Name. Second, can not specify multiple names. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66481 Signed-off-by: Chengwei Yang <chengwei.yang@intel.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-08-22Document GetAdtAuditSessionData and GetConnectionSELinuxSecurityContextSimon McVittie1-0/+117
These are only part of the DBus interface because dbus-daemon didn't previously support multiple interfaces. I don't know enough about either of these security frameworks to know what they return, but perhaps one day someone who knows about Solaris or SELinux will tell us... Bug: https://bugs.freedesktop.org/show_bug.cgi?id=54445 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-08-22GetConnectionCredentials: addSimon McVittie1-0/+102
The initial set of credentials is just UnixUserID and ProcessID. The rest can follow when someone is sufficiently interested to actually test them. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=54445 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> [rename a function that Ralf found unclear -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-06-26dbus-launch: align documentChengwei Yang1-3/+18
Signed-off-by: Chengwei Yang <chengwei.yang@intel.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66068
2013-06-24DBus Specification: remove incorrect table descriptionChengwei Yang1-2/+1
I doubt this line was copied by mistake from section "Summary of types". Signed-off-by: Chengwei Yang <chengwei.yang@intel.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66115
2013-06-13start spec 0.22 developmentSimon McVittie1-2/+8
2013-06-12Imported Upstream version 1.7.4upstream/1.7.4Simon McVittie5-62/+243
2013-06-12Revert "start spec 0.22 development"Simon McVittie1-8/+2
This reverts commit 82b3d94ab10f16e6c6c18eb3bc76594cd63e3854.
2013-06-05Recomend dbus-run-session over dbus-launch for starting text-mode sessionsSimon McVittie1-2/+4
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39196 Reviewed-by: Colin Walters <walters@verbum.org> [reformatted from roff to Docbook -smcv]
2013-06-05Put dbus-run-session through doclifter and adjust to match other man pagesSimon McVittie3-100/+145
2013-06-05Add dbus-run-sessionSimon McVittie2-0/+102
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39196 Reviewed-by: Colin Walters <walters@verbum.org>
2013-06-05doc: fix a little bit for dbus-sendChengwei Yang1-2/+8
Signed-off-by: Chengwei Yang <chengwei.yang@intel.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-05-02start spec 0.22 developmentSimon McVittie1-2/+8
2013-04-25Imported Upstream version 1.7.2upstream/1.7.2Simon McVittie5-13/+28
2013-04-25prepare version 1.7.2 and spec 0.21Simon McVittie1-4/+5
2013-04-22Specification: explicitly allow the Unicode noncharactersSimon McVittie1-2/+9
This follows Unicode Corrigendum #9. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=63072 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-04-19Unify docbook dtd version to 4.4.Ralf Habacker4-8/+8
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-22bump version to 1.7.1Simon McVittie1-3/+9
2013-02-22Imported Upstream version 1.7.0upstream/1.7.0Simon McVittie19-6063/+2189
2013-02-22Prepare release 1.7.0 (and specification 0.20)Simon McVittie1-3/+3
2013-02-18Eliminate unwanted whitespace from the man pages' XML sourceSimon McVittie6-28/+22
As demanded by the git commit hook set up by autogen.sh, this eliminates trailing whitespace on each line, and blank lines at EOF. We might as well do this now, since every line in these files has changed anyway. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-02-18Remove doclifter "signature" from Docbook man pages' sourceSimon McVittie6-7/+1
This no longer serves any purpose, and might mislead contributors into thinking that this XML is not the source for the man pages. (The man(7)-formatted man pages used to be the canonical source for the XML, but now it's the other way round.) Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-02-14Add @DBUS_VERSION@ to the generated man pagesSimon McVittie5-0/+5
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> [split out of previous patch -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Turn all man pages' source into configure-generated filesSimon McVittie7-6/+1
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> [dropped whitespace changes per Ralf's review -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Use Docbook XML as the source for all man pagesSimon McVittie8-1333/+38
This means we no longer need man2html, which is nice. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Fill in a manual and source for all man pagesSimon McVittie6-0/+13
I only filled in a version for dbus-daemon, whose XML is already generated by configure. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Updated man docbook xml sources from man page source using doclifter.Ralf Habacker6-282/+651
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Moved docbook sources used by cmake into doc subdir and adapted cmake build ↵Ralf Habacker4-0/+1256
system. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2012-11-13Don't include generated documentation in the tarballSimon McVittie1-4/+2
Building it unconditionally causes problems for minimal installations (OSTree), and building it opportunistically means the tarball isn't guaranteed to contain it, depending who releases libdbus and which packages they happen to have installed at the time. If this documentation is important enough that we need to ship it precompiled in tarballs, we should guarantee it; or if it isn't important enough to justify that, we should just drop it. I don't think we really need it in the tarballs at all: most users will get their libdbus from a binary distribution (in which case I expect the distribution's dbus maintainers to set appropriate build-dependencies), and those who build from source can either install xmlto, read the documentation on our website, or at worst, read the source XML. (We don't put the Doxygen-generated API reference HTML in the tarball either, and I haven't heard any complaints.) Bug: https://bugs.freedesktop.org/show_bug.cgi?id=55426 Reviewed-by: Colin Walters <walters@verbum.org>
2012-11-02spec: fix command name REJECT -> REJECTEDPavel Strashkin1-5/+5
Signed-off-by: Pavel Strashkin <pavel.strashkin@nexenta.com> Signed-off-by: Colin Walters <walters@verbum.org>
2012-10-02build: Make --disable-xml-docs build work againColin Walters1-3/+4
We can't build the .html files without xmlto, so don't add them to a dist_ variable. https://bugs.freedesktop.org/show_bug.cgi?id=55426
2012-09-29Imported Upstream version 1.6.8upstream/1.6.8Simon McVittie3-44/+44
2012-09-29Imported Upstream version 1.6.6upstream/1.6.6Simon McVittie3-44/+44
2012-08-09NEWSSimon McVittie1-4/+5
2012-07-18Imported Upstream version 1.6.4upstream/1.6.4Simon McVittie1-1/+1
2012-07-18spec: Mention object path and interface nameColin Walters1-4/+7
We didn't actually have /org/freedesktop/DBus in the spec, nor did we explicitly mention the existence of "org.freedesktop.DBus" as an interface, although it is implicit in the method names. https://bugs.freedesktop.org/show_bug.cgi?id=51865
2012-06-28Merge branch 'dbus-1.6'Simon McVittie1-24/+10
Conflicts: NEWS configure.ac