~ubuntu-branches/ubuntu/natty/glibmm2.4/natty

« back to all changes in this revision

Viewing changes to docs/reference/html/classGio_1_1DBus_1_1Server.html

  • Committer: Bazaar Package Importer
  • Author(s): Deng Xiyue, Emilio Pozuelo Monfort, Deng Xiyue
  • Date: 2011-04-13 10:05:51 UTC
  • mfrom: (1.2.60 upstream) (2.2.4 sid)
  • Revision ID: james.westby@ubuntu.com-20110413100551-xpgn8334oo6b901k
Tags: 2.28.0-1
[ Emilio Pozuelo Monfort ]
* debian/control.in,
  debian/rules:
  + Remove the chrpath hack, it's been fixed in libtool.

[ Deng Xiyue ]
* New upstream bugfix release.  (Closes: #621856)
  + debian/control.in:
    + Update GLib dependency to >= 2.28.0
  + debian/rules:
    + Update SHVER to 2.28.0 due to new API.
  + debian/libglibmm-2.4-dev.install:
    + Stop shipping /usr/share/glibmm-2.4, no longer exists.
* debian/control.in:
  + Update Standard-Version to 3.9.1.
* Convert to source format 3.0 (quilt):
  + debian/source/format: added.
  + debian/rules: drop simple-patchsys.mk

Show diffs side-by-side

added added

removed removed

Lines of Context:
123
123
<hr/><a name="_details"></a><h2>Detailed Description</h2>
124
124
<p>This is a helper for listening to and accepting D-Bus connections. </p>
125
125
<p>Since <a class="el" href="classGio_1_1DBus_1_1Server.html" title="This is a helper for listening to and accepting D-Bus connections.">Server</a> derives from Initiable, its constructors can throw an exception if construction fails.</p>
 
126
<p>This can be used to create a new D-Bus server, allowing two peers to use the D-Bus protocol for their own specialized communication. A server instance provided in this way will not perform message routing or implement the org.freedesktop.DBus interface.</p>
 
127
<p>To just export an object on a well-known name on a message bus, such as the session or system bus, you should instead use Gio::DBus::own_name().</p>
126
128
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000109">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
127
129
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
128
130
<a class="anchor" id="a107038d7edb1d4ce4c6132521e80baeb"></a><!-- doxytag: member="Gio::DBus::Server::~Server" ref="a107038d7edb1d4ce4c6132521e80baeb" args="()" -->
628
630
<p>Use <a class="el" href="classGio_1_1DBus_1_1Connection.html#ad841b9beb348c2e21dcb9e395ee4f28a" title="Gets the credentials of the authenticated peer.">Gio::DBus::Connection::get_peer_credentials()</a> to figure out what identity (if any), was authenticated.</p>
629
631
<p>If you want to accept the connection, keep a global reference to the connection (by keeping it in a global RefPtr&lt;&gt;) and return <code>true</code>. When you are done with the connection call <a class="el" href="classGio_1_1DBus_1_1Connection.html#a3e52adb1ec39322086ea46921086a6e5" title="Closes the connection.">Gio::DBus::Connection::close()</a>. Note that the other peer may disconnect at any time - a typical thing to do when accepting a connection is to listen to the <a class="el" href="classGio_1_1DBus_1_1Connection.html#a99d65f5ee4424eb0e48fd1725ff6ab37">Gio::DBus::Connection::signal_closed()</a> signal.</p>
630
632
<p>If <a class="el" href="classGio_1_1DBus_1_1Server.html#a461917cdc2a947da309a81759794b1d7" title="Flags for the server.">property_flags()</a> contains Gio::DBus::SERVER_FLAGS_RUN_IN_THREAD then the signal is emitted in a new thread dedicated to the connection. Otherwise the signal is emitted in the thread-default main loop of the thread that server was constructed in.</p>
631
 
<p>You are guaranteed that signal handlers for this signal runs before incoming messages on the connection are processed. This means that it's suitable to call <a class="el" href="classGio_1_1DBus_1_1Connection.html#a1d832792017aa4aa53205cc6082f50e1" title="Registers slots for exported objects at object_path with the D-Bus interface that is described in int...">Gio::DBus::Connection::register_object()</a> or similar from the signal handler.</p>
 
633
<p>You are guaranteed that signal handlers for this signal runs before incoming messages on the connection are processed. This means that it's suitable to call <a class="el" href="classGio_1_1DBus_1_1Connection.html#a0c2974543543686c386601b656577593" title="Registers slots for exported objects at object_path with the D-Bus interface that is described in int...">Gio::DBus::Connection::register_object()</a> or similar from the signal handler.</p>
632
634
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>bool on_my_new_connection(const Glib::RefPtr&lt;Connection&gt;&amp; connection)</code> </dd></dl>
633
635
 
634
636
</div>
710
712
</div>
711
713
</div>
712
714
</div>
713
 
<hr class="footer"/><address class="footer"><small>Generated on Thu Mar 24 2011 11:20:23 for glibmm by&#160;
 
715
<hr class="footer"/><address class="footer"><small>Generated on Tue Apr 5 2011 16:07:13 for glibmm by&#160;
714
716
<a href="http://www.doxygen.org/index.html">
715
717
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.2 </small></address>
716
718
</body>