Changeset 08de396 for general/sysutils/dbus.xml
- Timestamp:
- 04/28/2014 07:23:32 PM (10 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 56605b9
- Parents:
- 76c63b6
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/sysutils/dbus.xml
r76c63b6 r08de396 13 13 ]> 14 14 15 <sect1 id="dbus " xreflabel="D-Bus-&dbus-version;">15 <sect1 id="dbus-launch" xreflabel="D-Bus-&dbus-version;/dbus-launch"> 16 16 <?dbhtml filename="dbus.html"?> 17 17 … … 21 21 </sect1info> 22 22 23 <title>D-Bus-&dbus-version; </title>24 25 <indexterm zone="dbus ">26 <primary sortas="a- D-Bus">D-Bus</primary>23 <title>D-Bus-&dbus-version; (dbus-launch)</title> 24 25 <indexterm zone="dbus-launch"> 26 <primary sortas="a-dbus-launch">dbus-launch</primary> 27 27 </indexterm> 28 28 29 29 <sect2 role="package"> 30 <title>Introduction to D-Bus</title> 31 32 <para> 33 <application>D-Bus</application> is a message bus system, a simple 34 way for applications to talk to one another. 35 <application>D-Bus</application> supplies both a system daemon (for events 36 such as <quote>new hardware device added</quote> or <quote>printer queue 37 changed</quote>) and a per-user-login-session daemon (for general IPC needs 38 among user applications). Also, the message bus is built on top of a 39 general one-to-one message passing framework, which can be used by any two 40 applications to communicate directly (without going through the message bus 41 daemon). 42 </para> 43 44 &lfs75_checked; 30 <title>Introduction to D-Bus (with Xorg)</title> 31 32 <para> 33 <application>D-Bus</application> was installed in LFS, but one program 34 needs to be updated after Xorg is installed to properly support 35 window managers. 36 </para> 37 38 <!-- &lfs75_checked; --> 45 39 46 40 <bridgehead renderas="sect3">Package Information</bridgehead> … … 82 76 <bridgehead renderas="sect4">Required</bridgehead> 83 77 <para role="required"> 84 <xref linkend="expat"/>85 </para>86 87 <bridgehead renderas="sect4">Recommended</bridgehead>88 <para role="recommended">89 78 <xref linkend="xorg7-lib"/> 90 79 (for <command>dbus-launch</command> program) … … 112 101 113 102 <para> 114 As the <systemitem class="username">root</systemitem> user, create a 115 system user and group to handle the system message bus activity: 116 </para> 117 118 <screen role="root"><userinput>groupadd -g 18 messagebus && 119 useradd -c "D-Bus Message Daemon User" -d /var/run/dbus \ 120 -u 18 -g messagebus -s /bin/false messagebus</userinput></screen> 121 122 <para> 123 Install <application>D-Bus</application> by running the following 124 commands (you may wish to review the output from 125 <command>./configure --help</command> first and add any desired parameters 126 to the <command>configure</command> command shown below): 127 </para> 128 129 <screen><userinput>./configure --prefix=/usr \ 130 --sysconfdir=/etc \ 131 --localstatedir=/var \ 103 Build <application>D-Bus</application> by running the following commands: 104 </para> 105 106 <screen><userinput>./configure --prefix=/usr \ 107 --sysconfdir=/etc \ 108 --localstatedir=/var \ 132 109 --with-console-auth-dir=/run/console/ \ 133 --without-systemdsystemunitdir \134 --disable-systemd \135 110 --disable-static && 136 111 make</userinput></screen> … … 144 119 </para> 145 120 146 <screen role="root"><userinput>make install && 147 mv -v /usr/share/doc/dbus /usr/share/doc/dbus-&dbus-version;</userinput></screen> 148 149 <para> 150 If you are still building your system in chroot or you did not start the 151 daemon yet, but you want to compile some packages that require 152 <application>D-Bus</application>, generate 153 <application>D-Bus</application> UUID to avoid warnings when compiling 154 some packages with the following command as the 121 <screen role="root"><userinput>install -m 755 dbus-launch /usr/bin</userinput></screen> 122 123 <para> 124 If you built the optional documentation, install it as the 155 125 <systemitem class="username">root</systemitem> user: 156 126 </para> 157 127 158 <screen role="root"><userinput> dbus-uuidgen --ensure</userinput></screen>159 128 <screen role="root"><userinput>cp -a doc/api/{html,xml} /usr/share/doc/dbus-&dbus-version;</userinput></screen> 129 160 130 <para> 161 131 The dbus tests cannot be run until after <xref linkend="dbus-glib"/> … … 185 155 <screen><userinput>sed -i -e 's:run-test.sh:$(NULL):g' test/name-test/Makefile.in</userinput></screen> 186 156 187 < para>188 Note there has been a report that the tests may fail if running157 <note><para> 158 There has been a report that the tests may fail if running 189 159 inside a Midnight Commander shell. 190 160 You may get out-of-memory error messages when running the tests. 191 161 These are normal and can be safely ignored. 192 </para> 162 </para></note> 193 163 194 164 </sect2> … … 201 171 parameter specifies location of the 202 172 <application>ConsoleKit</application> auth dir. 203 </para>204 205 <para>206 <parameter>--without-systemdsystemunitdir</parameter>: This switch207 prevents installation of systemd unit files.208 </para>209 210 <para>211 <parameter>--disable-systemd</parameter>: This switch disables systemd212 support in <application>D-Bus</application>213 173 </para> 214 174 … … 250 210 </para> 251 211 252 <indexterm zone="dbus dbus-config">212 <indexterm zone="dbus-launch dbus-config"> 253 213 <primary sortas="e-etc-dbus-1-session.conf">/etc/dbus-1/session.conf</primary> 254 214 </indexterm> 255 215 256 <indexterm zone="dbus dbus-config">216 <indexterm zone="dbus-launch dbus-config"> 257 217 <primary sortas="e-etc-dbus-1/system.conf">/etc/dbus-1/system.conf</primary> 258 218 </indexterm> 259 219 260 <indexterm zone="dbus dbus-config">220 <indexterm zone="dbus-launch dbus-config"> 261 221 <primary sortas="e-etc-dbus-1-system.d-star">/etc/dbus-1/system.d/*</primary> 262 222 </indexterm> … … 302 262 303 263 <sect3 id="dbus-init"> 304 <title> Boot Script</title>264 <title>Starting D-Bus</title> 305 265 306 266 <para> 307 To automatically start <command>dbus-daemon</command> when the 308 system is rebooted, install the 309 <filename>/etc/rc.d/init.d/dbus</filename> bootscript from the 310 <xref linkend="bootscripts"/> package. 311 </para> 312 313 <indexterm zone="dbus dbus-init"> 314 <primary sortas="f-dbus">dbus</primary> 315 </indexterm> 316 317 <screen role="root"><userinput>make install-dbus</userinput></screen> 318 319 <para> 320 Note that this boot script only starts the system-wide 321 <application>D-Bus</application> daemon. Each user requiring access to 322 <application>D-Bus</application> services will also need to run a 323 session daemon as well. There are many methods you can use to start a 267 There are many methods you can use to start a 324 268 session daemon using the <command>dbus-launch</command> command. Review 325 269 the <command>dbus-launch</command> man page for details about the … … 392 336 <segmentedlist> 393 337 <segtitle>Installed Programs</segtitle> 394 <segtitle>Installed Librar y</segtitle>338 <segtitle>Installed Libraries</segtitle> 395 339 <segtitle>Installed Directories</segtitle> 396 340 397 341 <seglistitem> 398 342 <seg> 399 dbus-cleanup-sockets, dbus-daemon, dbus-launch, dbus-monitor, 400 dbus-run-session, dbus-send and dbus-uuidgen 343 dbus-launch 401 344 </seg> 402 345 <seg> 403 libdbus-1.so346 None 404 347 </seg> 405 348 <seg> 406 /etc/dbus-1, 407 /usr/include/dbus-1.0, 408 /usr/lib/dbus-1.0, 409 /usr/share/dbus-1, 410 /usr/share/doc/dbus-&dbus-version;, 411 /var/lib/dbus and 412 /var/run/dbus 349 None 413 350 </seg> 414 351 </seglistitem> … … 420 357 <?dbhtml list-presentation="table"?> 421 358 422 <varlistentry id="dbus-cleanup-sockets"> 423 <term><command>dbus-cleanup-sockets</command></term> 424 <listitem> 425 <para> 426 is used to clean up leftover sockets in a directory. 427 </para> 428 <indexterm zone="dbus dbus-cleanup-sockets"> 429 <primary sortas="b-dbus-cleanup-sockets">dbus-cleanup-sockets</primary> 430 </indexterm> 431 </listitem> 432 </varlistentry> 433 434 <varlistentry id="dbus-daemon"> 435 <term><command>dbus-daemon</command></term> 436 <listitem> 437 <para> 438 is the <application>D-Bus</application> message bus daemon. 439 </para> 440 <indexterm zone="dbus dbus-daemon"> 441 <primary sortas="b-dbus-daemon">dbus-daemon</primary> 442 </indexterm> 443 </listitem> 444 </varlistentry> 445 446 <varlistentry id="dbus-launch"> 359 <varlistentry id="dbus-launch-program"> 447 360 <term><command>dbus-launch</command></term> 448 361 <listitem> … … 452 365 scripts. 453 366 </para> 454 <indexterm zone="dbus dbus-launch">455 <primary sortas="b-dbus-launch ">dbus-launch</primary>367 <indexterm zone="dbus-launch dbus-launch-program"> 368 <primary sortas="b-dbus-launch-program">dbus-launch</primary> 456 369 </indexterm> 457 370 </listitem> 458 371 </varlistentry> 459 372 460 <varlistentry id="dbus-monitor">461 <term><command>dbus-monitor</command></term>462 <listitem>463 <para>464 is used to monitor messages going through a465 <application>D-Bus</application> message bus.466 </para>467 <indexterm zone="dbus dbus-monitor">468 <primary sortas="b-dbus-monitor">dbus-monitor</primary>469 </indexterm>470 </listitem>471 </varlistentry>472 473 <varlistentry id="dbus-run-session">474 <term><command>dbus-run-session</command></term>475 <listitem>476 <para>477 start a process as a new <application>D-Bus</application> session.478 </para>479 <indexterm zone="dbus dbus-run-session">480 <primary sortas="b-dbus-run-session">dbus-run-session</primary>481 </indexterm>482 </listitem>483 </varlistentry>484 485 <varlistentry id="dbus-send">486 <term><command>dbus-send</command></term>487 <listitem>488 <para>489 is used to send a message to a <application>D-Bus</application>490 message bus.491 </para>492 <indexterm zone="dbus dbus-send">493 <primary sortas="b-dbus-send">dbus-send</primary>494 </indexterm>495 </listitem>496 </varlistentry>497 498 <varlistentry id="dbus-uuidgen">499 <term><command>dbus-uuidgen</command></term>500 <listitem>501 <para>502 is used to generate a universally unique ID.503 </para>504 <indexterm zone="dbus dbus-uuidgen">505 <primary sortas="b-dbus-uuidgen">dbus-uuidgen</primary>506 </indexterm>507 </listitem>508 </varlistentry>509 510 <varlistentry id="libdbus-1">511 <term><filename class="libraryfile">libdbus-1.so</filename></term>512 <listitem>513 <para>514 contains the API functions used by the515 <application>D-Bus</application> message daemon.516 <application>D-Bus</application> is first a library that provides517 one-to-one communication between any two applications;518 <command>dbus-daemon</command> is an application that uses this519 library to implement a message bus daemon.520 </para>521 <indexterm zone="dbus libdbus-1">522 <primary sortas="c-libdbus-1">libdbus-1.so</primary>523 </indexterm>524 </listitem>525 </varlistentry>526 527 373 </variablelist> 528 374
Note:
See TracChangeset
for help on using the changeset viewer.