summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2020-09-25Merge 'dbus-1.12.20' into tizenAdrian Szyndela2-4/+10
dbus-1.12.20 Change-Id: I8b3a9e851dca1d42a5785fa94c97f5e9074cac35
2020-08-05Remove unused license file, COPYINGsubmit/tizen/20200805.013704accepted/tizen/unified/20200805.122533Hyotaek Shim1-1/+0
Change-Id: Ie3e28ff56652ee454ad1f7362a93fec0973af0f6 Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>
2020-04-20doc: replace dbus-send's --address with --peer and --busChristopher Morin1-3/+9
See merge request dbus/dbus!115 (cherry picked from commit fd41caa3664d480605628f08c217581bc42fa3e7)
2020-04-16Merge dbus-1.12.16 into tizenAdrian Szyndela12-822/+1670
dbus 1.12.16
2020-02-20doc: Fix environment variable name in dbus-daemon(1)Philip Withnall1-1/+1
Spotted by Mubin. This documentation relates to the code in add_bus_environment() in bus/activation.c. Signed-off-by: Philip Withnall <withnall@endlessm.com> Fixes: #275 (cherry picked from commit bf71a58e4ab496c1726209aaad94a1abe670a01f)
2018-12-04doc: Remove obsolete message about man2htmlSimon McVittie1-1/+0
We no longer run man2html. Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit f134e2d2c7ae53965dfba0c85bf76ad38fb7fa4c)
2018-12-04CONTRIBUTING: Reformat as MarkdownSimon McVittie1-1/+1
Signed-off-by: Simon McVittie <smcv@collabora.com>
2018-12-04Rename HACKING to CONTRIBUTINGSimon McVittie1-1/+1
Signed-off-by: Simon McVittie <smcv@collabora.com>
2018-04-27build: Uninstall JavaScript and CSS from htmldirSimon McVittie1-0/+2
Otherwise, distcheck fails when mallard-ducktype is available. Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit 9391d769ae335872e5b770f6741855fde45b8186)
2018-04-25dbus-daemon(1): Mention and deprecate shared session busesSimon McVittie1-0/+13
This might (?) have made sense behind a firewall in 2003; but now it's 2018, the typical threat model that we are defending against has changed from "vandals want to feel proud of their l33t skills" to "organised crime wants your money", and a "trusted" local LAN probably contains an obsolete phone, tablet, games console or Internet-of-Things-enabled toaster with remote root exploits. This make network topologies that used to be acceptable look increasingly irresponsible. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106004 Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> (cherry picked from commit d0a16b59a8572fbd1934e941e2e3004840306222)
2018-04-25dbus-daemon(1): Recommend requiring EXTERNAL on non-Windows OSsSimon McVittie1-0/+4
This is the default, and blocks TCP-based attacks by making the attacker fail to authenticate (while also preventing inadvisable TCP-based configurations from working). Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106004 Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Reviewed-by: Philip Withnall <withnall@endlessm.com> (cherry picked from commit aef4475939a773e1a205a71d641ea2bb6793ab92)
2018-04-25dbus-daemon(1): Put some scary warnings on <allow_anonymous/>Simon McVittie1-0/+7
I'm far from convinced that this option should even *exist*, but it should definitely be documented as a very bad thing. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106004 Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Reviewed-by: Philip Withnall <withnall@endlessm.com> (cherry picked from commit 5d3680486712891c13b85c07fab629bb70f623cc)
2018-04-25dbus-daemon(1): Recommend against remote TCP for debuggingSimon McVittie1-0/+10
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106004 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: Add a TODO comment as suggested] Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit cf47380641aac0e5b40694b0ae09ffb85ec4b5fc)
2018-04-25dbus-daemon(1): Say that non-local TCP is insecureSimon McVittie1-2/+22
With some fairly reasonable threat models (active or passive local attacker able to eavesdrop on the network link, confidential information being transferred via D-Bus), secure authentication is insufficient to make this transport secure: it does not protect confidentiality or integrity either. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106004 Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Reviewed-by: Philip Withnall <withnall@endlessm.com> (cherry picked from commit 2513f84db68a9edad8558806b777ed6c284016b9)
2018-04-23doxygen_to_devhelp: Produce Devhelp index format v2Simon McVittie3-3/+9
The old version-1 format is deprecated and now produces warnings. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106186 Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: Add the .devhelp2 file to .gitignore as suggested] Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit fa922639207de16d459983144ddad28b7abe60c2)
2018-04-23doxygen_to_devhelp: Make the API reference the front pageSimon McVittie1-1/+2
The tutorial is not necessarily a great entry point for the libdbus documentation: it's infrequently updated, and we should probably have the "If you use this low-level API directly, you're signing up for some pain" message from the API reference show up in devhelp more immediately. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106186 Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: Add longer commit message with rationale] Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit c84ac8b1ef3a9fa18127b2462ead369c4e8846bd)
2018-04-23doc: Install highlight.pack.js if presentSimon McVittie2-0/+2
Newer versions of yelp-build use this instead of a jQuery syntax highlighter. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106171 Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: Also add it to .gitignore as suggested] Signed-off-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit 49ad5b110fd5f5f4e41405d98007a11d8eb741f7)
2018-04-23doc: Only install ancillary files from yelp-build if they existSimon McVittie1-3/+14
Newer versions of yelp-build don't install jquery. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=106171 Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> (cherry picked from commit bab857fb6f75ffe0ac3771de4b8272ad97623a2c)
2018-02-08doc: Fix bracket escaping in Ducktype API design filePhilip Withnall1-22/+22
There’s no need to escape closing brackets if the paired opening bracket is escaped (or doesn’t need escaping). See https://github.com/projectmallard/mallard-ducktype/issues/16#issuecomment-362590519. Signed-off-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=104925 Reviewed-by: Simon McVittie <smcv@collabora.com> (cherry picked from commit ad72d6bc5f45e78d21f64099f670a89dcf32507d)
2017-10-09doc: Fix dbus-send.1 uint16 typoDavid King1-1/+1
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=103075 Bug-RedHat: https://bugzilla.redhat.com/show_bug.cgi?id=1467415 Reviewed-by: Philip Withnall <withnall@endlessm.com> Reviewed-by: Simon McVittie <smcv@collabora.com>
2017-07-28policy: Add max_fds, min_fds qualifiers for send, receive rulesSimon McVittie1-0/+20
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101848 Reviewed-by: Thiago Macieira <thiago@kde.org> [smcv: Revert an incorrect comment change] Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-07-28Add send_broadcast as an attribute of <allow> and <deny> elementsSimon McVittie1-0/+11
<allow send_broadcast="true" ...> only matches broadcasts, which are signals with a NULL destination. There was previously no way for the policy language to express "NULL destination", only "any destination". <allow send_broadcast="false" ...> only matches non-broadcasts, which are non-signals or signals with a non-NULL destination. There was previously no way for the policy language to express "any non-NULL destination", only "any destination". Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: improved documentation as per Philip's review] Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-28dbus-daemon(1): Document how send_* and receive_* work in generalSimon McVittie1-0/+26
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-28dbus-daemon(1): Be more truthful about the default policySimon McVittie1-3/+7
We don't allow sending unrequested replies, but the documentation implied that we did. Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-28dbus-daemon(1): Clarify how user, group rules workSimon McVittie1-8/+12
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-28dbus-daemon(1): Actually document "own" rulesSimon McVittie1-0/+11
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-28dbus-daemon(1): Document the wildcard attribute value "*" more clearlySimon McVittie1-19/+30
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Thiago Macieira <thiago@kde.org> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=92853
2017-07-07Remove legacy smack support, keep upstream smack supportsubmit/tizen/20170710.061501submit/tizen/20170707.072404accepted/tizen/unified/20170712.164836Adrian Szyndela1-6/+0
This commit reverts four commits. There was a need for additional minor changes to make it work. Revert "GetConnectionCredentials - add smack support" This reverts commit 13d888ca95c75c14a4919b36cc0a15979fb1d42b. Revert "packaging: enable Smack support" This reverts commit 54f95c99cf4d53f5566511fc0cdc21b230909b29. Revert "Enforce smack policy from conf file" This reverts commit 1d028039f5d34de8a1224d2ad0d8bc75b3da3ca4. Revert "Enable checking of smack context from DBus interface" This reverts commit 7af23db240c54e9923c76234b7e9c7a243d2d428. Change-Id: I4bf7ce8d43717e1deb5d980f87be39220922b422
2017-06-29spec: Update my email addressSimon McVittie1-1/+1
Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-06-29Start 1.11.16 developmentSimon McVittie1-4/+4
Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-06-291.11.14Simon McVittie1-3/+33
Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-06-29spec: Document versioning of eavesdrop='true'Simon McVittie1-0/+7
The wording and formatting used here is consistent with other semi-recently-added match keys. Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101567
2017-06-29spec: Formally deprecate eavesdroppingSimon McVittie1-22/+42
Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: Wrap BecomeMonitor in <literal> as per Philip's review] Signed-off-by: Simon McVittie <smcv@collabora.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101567
2017-06-29spec: Do not promise match rules with eavesdrop='true' can be addedSimon McVittie1-6/+1
This is no longer true, and it seems less misleading to raise an error than to obey the letter of the spec by quietly ignoring calls from an inappropriate caller. Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101567
2017-06-29Add unix:dir=/something addressesSimon McVittie1-6/+32
These are like unix:tmpdir=/something, except that the resulting socket is always path-based, never abstract. This is desirable for two reasons: * If a Linux container manager wants to expose a path-based socket into the container, it can do so by bind-mounting it in the container's filesystem namespace. That cannot work for abstract sockets because they are not files. * Conversely, if a Linux container manager does not want to expose a path-based socket in the container, it can avoid bind-mounting it, or bind-mount some harmless object like /dev/null over it. That cannot work for abstract sockets because access to abstract sockets is part of the network namespace, which is all-or-nothing. Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101567
2017-06-08spec: Document the Features and Interfaces properties on o.fd.DBusSimon McVittie1-0/+116
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101257
2017-06-08spec: Document the Peer and Properties interfaces for the message busSimon McVittie1-0/+8
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101257
2017-06-02spec: Document the canonical object path for the bus driverSimon McVittie1-1/+19
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=101256
2017-05-31spec: Fix indentationTom Gundersen1-1/+1
[smcv: separated out from a larger commit, added commit message] Reviewed-by: Simon McVittie <smcv@collabora.com>
2017-05-31spec: Re-word documentation of ListQueuedOwnersTom Gundersen1-3/+1
This was previously written in an unusual message-passing-oriented style, which obscured the meaning. Use a more method-call-oriented style instead. [smcv: separated out from a larger commit, added commit message] Reviewed-by: Simon McVittie <smcv@collabora.com>
2017-05-31spec: Re-word documentation of ReleaseNameTom Gundersen1-9/+7
This was previously written in an unusual message-passing-oriented style, which obscured the meaning. Use a more method-call-oriented style instead. [smcv: separated out from a larger commit, added commit message] Reviewed-by: Simon McVittie <smcv@collabora.com>
2017-05-31Spec: Re-word documentation of RequestNameTom Gundersen1-8/+6
This was previously written in an unusual message-passing-oriented style, which obscured the meaning. Use a more method-call-oriented style instead. [smcv: separated out from a larger commit, added commit message] Reviewed-by: Simon McVittie <smcv@collabora.com>
2017-05-31spec: Move ListQueuedOwners API description to list of methodsSimon McVittie1-56/+56
Tom Gundersen pointed out that RequestName, ReleaseName and ListQueuedOwners were documented in their own section instead of being put together with the other method calls, which makes it more difficult to apply changes consistently across all methods. I'm moving them one at a time to make the changes reviewable, since the diff resulting from moving all three as a unit is too large to review sensibly. Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-05-31spec: Move ReleaseName API description to list of methodsSimon McVittie1-95/+95
Tom Gundersen pointed out that RequestName, ReleaseName and ListQueuedOwners were documented in their own section instead of being put together with the other method calls, which makes it more difficult to apply changes consistently across all methods. I'm moving them one at a time to make the changes reviewable, since the diff resulting from moving all three as a unit is too large to review sensibly. Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-05-31spec: Move RequestName API description to list of methodsSimon McVittie1-240/+241
Tom Gundersen pointed out that RequestName, ReleaseName and ListQueuedOwners were documented in their own section instead of being put together with the other method calls, which makes it more difficult to apply changes consistently across all methods. I'm moving them one at a time to make the changes reviewable, since the diff resulting from moving all three as a unit is too large to review sensibly. Signed-off-by: Simon McVittie <smcv@collabora.com>
2017-04-18Ensure hyphen/minus is treated as literal in regexesSimon McVittie1-1/+1
Each U+002D HYPHEN-MINUS in [0-9A-Za-z_-/.\] is treated as a member of a range. The third one, which appears to have been intended to be a literal, is part of an empty range because the starting point U+005F LOW LINE is greater than the endpoint U+002F SOLIDUS, resulting in at least some grep implementations not considering U+002D, U+002F or U+005F to match the pattern. This resulted in one of the dbus-launch tests being unintentionally skipped when it used a regex based on the one in the spec. regex(7) suggests "To include a literal '-' [in a bracketed character set], make it the first or last character". Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=100686
2017-02-24doc: Clarify /etc/dbus-1/system.d and /usr/share/dbus-1/system.dPhilip Withnall2-2/+8
The documentation generally only mentioned the directory in /etc, even though we actually prefer security policies to be installed in /usr/share to allow for stateless and volatile systems (i.e. booting up with an empty /etc). Signed-off-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=99901 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2017-02-21dbus-daemon(1): Describe how session and system services are foundSimon McVittie1-17/+179
For Unix, this partially duplicates the D-Bus Specification, but provides more detail about the intention of each search path element. It also documents the non-standardized path elements searched by the reference implementation. For Windows, there are no standardized path elements in the D-Bus Specification (and it isn't clear how useful it would be to standardize them, since Windows software that uses D-Bus tends to be installed as an integrated "stack" with a bundled copy of a suitable dbus-daemon), so we just document what the reference implementation does. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=99825 Reviewed-by: Philip Withnall <withnall@endlessm.com> [smcv: fix formatting nitpicks] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2017-02-21spec: Don't say implementation-specific locations must be lowest prioritySimon McVittie1-7/+3
We're treating transient services as higher-priority than those in the XDG_DATA_HOME or XDG_DATA_DIRS, which is consistent with systemd. The specific list used by the standard session dbus-daemon will be added to dbus-daemon(1) in the next commit. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=99825 Reviewed-by: Philip Withnall <withnall@endlessm.com> Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2016-11-29Start towards 1.11.10Simon McVittie1-2/+10
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-24 21:10:23 +0000