summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Add support for unix:runtime=yes as an address modeSimon McVittie2015-02-241-3/+14
| | | | | | | | | | | | | | | | | | | | | | | | | This is not used by default, but can be configured by OS builders (or regression-test environments) if desired. If used, this listens on $XDG_RUNTIME_DIR/bus, or fails if $XDG_RUNTIME_DIR is not set. Fallback behaviour is unnecessary, because it is already possible to use a string of semicolon-separated addresses like <listen>unix:runtime=yes;unix:tmpdir=/tmp</listen>, resulting in listening on either $XDG_RUNTIME_DIR/bus or /tmp/something. We use a non-abstract socket here, because that is desirable for use with Linux containers: abstract sockets are attached to the network namespace, whereas non-abstract sockets are part of the filesystem and can be bind-mounted between domains if necessary. The major advantage of abstract sockets is that they do not need cleanup, but the specification of XDG_RUNTIME_DIR guarantees to provide cleanup anyway. Based on prior work by Simon McVittie, Colin Walters and Alexander Larsson. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=61303 Reviewed-by: Philip Withnall <philip.withnall@collabora.co.uk>
* 1.9.12dbus-1.9.12Simon McVittie2015-02-191-5/+6
|
* Add apparmor element and attributes to the bus config dtdTyler Hicks2015-02-181-1/+6
| | | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=75113 Signed-off-by: Tyler Hicks <tyhicks@canonical.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* Document AppArmor enforcement in the dbus-daemon man pageTyler Hicks2015-02-181-0/+56
| | | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=75113 Signed-off-by: Tyler Hicks <tyhicks@canonical.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* Add LinuxSecurityLabel to specificationSimon McVittie2015-02-181-0/+51
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=89041 Reviewed-by: Philip Withnall <philip.withnall@collabora.co.uk>
* doc: Add a guide to designing D-Bus APIsPhilip Withnall2015-02-163-2/+930
| | | | | | | | | | | | | This guide gives some pointers on how to write D-Bus APIs which are nice to use. It adds an optional dependency on Ducktype and yelp-build from yelp-tools. These are used when available, but are not required unless --enable-ducktype-docs is passed to configure. They are required for uploading the docs, however. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=88994 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* Document dbus-test-toolSimon McVittie2015-02-122-0/+326
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=89086 Reviewed-by: Philip Withnall <philip.withnall@collabora.co.uk>
* Windows implementation of GetConnectionCredentials.Ralf Habacker2015-02-111-0/+8
| | | | | Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=54445
* dbus-monitor: add options to log binary data with or without pcap framingSimon McVittie2015-02-041-4/+15
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=46787 Reviewed-by: Philip Withnall <philip.withnall@collabora.co.uk>
* Capture all messages received or sent, and send them to monitorsSimon McVittie2015-02-041-0/+97
| | | | | | | | Unlike eavesdropping, the point of capture is when the message is received, except for messages originating inside the dbus-daemon. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=46787 Reviewed-by: Philip Withnall <philip.withnall@collabora.co.uk>
* Start spec 0.26Simon McVittie2014-11-241-1/+9
|
* Revert "Start spec 0.26"Simon McVittie2014-11-241-9/+1
| | | | This reverts commit cdd9e9a65c40ac4c21dcd36e9bd0fd6c746ad753.
* Start spec 0.26Simon McVittie2014-11-101-1/+9
|
* 1.9.2, spec 0.25dbus-1.9.2Simon McVittie2014-11-061-4/+4
|
* dbus-tutorial: replace the entire GLib section with "use GDBus"Simon McVittie2014-10-291-939/+13
| | | | | | Also provide links to relevant GLib and Qt documentation. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=25140
* dbus-spec, dbus-protocol: add ALLOW_INTERACTIVE_AUTHORIZATION flagSimon McVittie2014-10-281-0/+60
| | | | | | | | | | | | | | | Heavily based on a patch from Lennart Poettering. This is useful for authentication frameworks such as polkit, but this flag is supposed to be generic, and not be bound to any implementation of such a framework. The dbus specification already clarifies that unknown flags must be ignored, the reference implementation and the other implementations we checked indeed ignore any new flags, hence we should be fine with compatibility here. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=83449
* Do not claim that '*' resolves to INADDR_ANY on all OSsSimon McVittie2014-10-131-3/+5
| | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=72296
* spec: introduce new value "const" for EmitsChangedSignal annotationLennart Poettering2014-10-131-1/+18
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=72958 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* NEWS, bump spec version to (unreleased) 0.25Simon McVittie2014-10-061-2/+10
|
* spec: translate arbitrary limits into something more comprehensibleSimon McVittie2014-10-061-4/+4
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=84188 Reviewed-by: Lennart Poettering
* spec: in the table of types, classify themSimon McVittie2014-10-061-0/+23
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=84188 Reviewed-by: Lennart Poettering
* 1.9.0dbus-1.9.0Simon McVittie2014-10-011-4/+5
|
* dbus-launch: Fix typo in manpageSebastian Rasmussen2014-09-251-1/+1
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=84313 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* Describe quoting for match rulesSimon McVittie2014-09-251-0/+26
| | | | | | | | I wish I could say "I can't believe this was never documented", but it wouldn't be true. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=24307 Reviewed-by: Alban Crequy
* Expand documentation of NO_REPLY_EXPECTEDSimon McVittie2014-09-241-8/+26
| | | | | | | | | The message type is more important than whether NO_REPLY_EXPECTED is set, when deciding whether a reply is expected. This documents existing practice in at least libdbus, GDBus and dbus-daemon. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=75749 Reviewed-by: Thiago Macieira
* Merge branch 'dbus-1.8'Simon McVittie2014-09-161-0/+4
|\ | | | | | | | | | | Conflicts: NEWS configure.ac
| * config: add new limit: pending_fd_timeoutAlban Crequy2014-09-151-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is one of four commits needed to address CVE-2014-3637. When a file descriptor is passed to dbus-daemon, the associated D-Bus message might not be fully sent to dbus-daemon yet. Dbus-daemon keeps the file descriptor in the DBusMessageLoader of the connection, waiting for the rest of the message. If the client stops sending the remaining bytes, dbus-daemon will wait forever and keep that file descriptor. This patch adds pending_fd_timeout (milliseconds) in the configuration to disconnect a connection after a timeout when a file descriptor was sent but not the remaining message. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=80559 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* | doc/dbus-tutorial: fix tutorial to reference the proper GType for 'ay'Thomas Haller2014-09-041-1/+1
| | | | | | | | | | | | | | | | DBUS_TYPE_G_BYTE_ARRAY does not exist. It should be DBUS_TYPE_G_UCHAR_ARRAY Signed-off-by: Thomas Haller <thaller@redhat.com> Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=80795
* | Merge branch 'dbus-1.8'Simon McVittie2014-03-131-2/+1
|\ \ | |/
| * Update email-address for David Zeuthen.David Zeuthen2014-03-131-2/+1
| | | | | | | | | | | | | | I no longer have the email address davidz@redhat.com so update it to my current address. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=75288
* | start spec 0.24Simon McVittie2014-01-201-2/+10
|/
* Revert "start spec 0.24"Simon McVittie2014-01-201-10/+2
| | | | | | It hasn't otherwise changed since 1.7.10. This reverts commit fb16f80d457a66610f615b44158330bf7ba68697.
* Rename bus-test to test-bus to match common test application naming scheme.Ralf Habacker2014-01-171-4/+4
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=73495 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* Rename dbus-test to test-dbus to match common test application naming scheme.Ralf Habacker2014-01-171-3/+3
| | | | | | [reverted the dbus-specification part -smcv] Bug: https://bugs.freedesktop.org/show_bug.cgi?id=73495 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* start spec 0.24Simon McVittie2014-01-061-2/+10
|
* 1.7.10dbus-1.7.10Simon McVittie2014-01-061-4/+6
|
* dbus-daemon(1): align document about "bind" with DBus SpecChengwei Yang2014-01-061-6/+7
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=72301 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* DBus Spec: add document of bind for tcp/nonce-tcp transportChengwei Yang2014-01-061-2/+19
| | | | | | | | | | | tcp/nonce-tcp transport has a "bind" key, which can be specified a hostname and will override hostname specified in "host" key. "bind" has a special value "*" which means ip address 0.0.0.0 and will cause dbus-daemon listen on all interfaces. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=72301 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* DBus Spec: replace tab with 8 spacesChengwei Yang2014-01-061-213/+213
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=72301 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* specification: discuss "listenable" and "connectable" addressesSimon McVittie2013-12-021-5/+86
| | | | | | | | | | | | | | | The --with-dbus-session-bus-connect-address configure option and the DBUS_SESSION_BUS_CONNECT_ADDRESS CMake variable expect a connectable address, while the --with-dbus-session-bus-listen-address option and the DBUS_SESSION_BUS_LISTEN_ADDRESS variable expect a listenable address. DBUS_SYSTEM_BUS_DEFAULT_ADDRESS currently has to be an address that is simultaneously listenable and connectable. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=61303 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com> [fixed name of DBUS_SESSION_BUS_CONNECT_ADDRESS as per review -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* spec: explicitly mention filtering messages with no INTERFACESimon McVittie2013-11-271-0/+9
| | | | | | | | | This is an important security measure. Without it, the system bus would not deliver its intended security properties. The actual implementation has always behaved like this, I think. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=68597 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
* Do not require messages without INTERFACE to be dispatchedSimon McVittie2013-11-271-6/+10
| | | | | | | | | | | | | | | | | | | | | | | | Previously, if we have interfaces: interface com.example.foo: method Ambiguous() interface com.example.bar: method Ambiguous() method Unambiguous() implementations were required to deliver a message with no INTERFACE and METHOD=Unambiguous to "bar". A message with no INTERFACE and METHOD=Ambiguous could either be delivered to "foo", delivered to "bar" or treated as an error. Relax this to allow an error for the unambiguous case, too, and strongly recommend specifying the interface (which is best-practice). Bug: https://bugs.freedesktop.org/show_bug.cgi?id=68597 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com> Vaguely-acked-by: Thiago Macieira, David Zeuthen [and desrt objected that it didn't go far enough] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* start dbus-specification 0.23Simon McVittie2013-11-011-2/+10
|
* Revert "start dbus-specification 0.23"Simon McVittie2013-11-011-10/+2
| | | | | This reverts commit c8bc5f24b721bc03679c44669cf5e655c1e99b5f. Nothing changed since 0.22.
* Update configurable elements for dbus-daemon manualChengwei Yang2013-11-011-0/+31
| | | | | | | | Update three configurable elements for dbus-daemon manual, <syslog>, <pidfile> and <allow_anonymous>, all of them are undocumented so far. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=69125 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
* start dbus-specification 0.23Simon McVittie2013-10-101-2/+10
|
* D-Bus 1.7.6, spec 0.22dbus-1.7.6Simon McVittie2013-10-091-3/+6
|
* Spec: document multiple .service files own the same well known nameChengwei Yang2013-10-081-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>
* spec: briefly describe Name, Exec and User keysSimon McVittie2013-10-081-0/+13
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
* spec: system services' service description files have constrained namesSimon McVittie2013-10-081-0/+13
| | | | | Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608 Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
View Lorry Controller Status