This file is indexed.

/usr/share/doc/libdbus-java/dbus-java/dbus-javase13.html is in libdbus-java-doc 2.8-6.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<?xml version="1.0" encoding="iso-8859-1" ?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->  
<html xmlns="http://www.w3.org/1999/xhtml"  
> 
<head><title>Low-level API</title> 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> 
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> 
<!-- xhtml,2,html --> 
<meta name="src" content="dbus-java.tex" /> 
<meta name="date" content="2015-02-14 05:16:00" /> 
<link rel="stylesheet" type="text/css" href="dbus-java.css" /> 
</head><body 
>
   <!--l. 992--><div class="crosslinks"><p class="noindent">[<a 
href="dbus-javase12.html" >prev</a>] [<a 
href="dbus-javase12.html#taildbus-javase12.html" >prev-tail</a>] [<a 
href="dbus-javase4.html#taildbus-javase13.html">tail</a>] [<a 
href="dbus-java.html# " >up</a>] </p></div>
   <h3 class="sectionHead"><span class="titlemark">13   </span> <a 
 id="x38-4100013"></a>Low-level API</h3>
<!--l. 994--><p class="noindent" >In very rare circumstances it may be neccessary to deal directly with messages on the bus,
rather than with objects and method calls. This implementation gives the programmer access
to this low-level API but its use is strongly recommended against.
</p><!--l. 999--><p class="indent" >   To use the low-level API you use a different set of classes than with the normal
API.
</p><!--l. 1002--><p class="noindent" >
</p>
   <h4 class="subsectionHead"><span class="titlemark">13.1   </span> <a 
 id="x38-4200013.1"></a>Transport</h4>
<!--l. 1004--><p class="noindent" >The <span 
class="cmtt-12">Transport</span><span class="footnote-mark"><a 
href="dbus-java39.html#fn22x0"><sup class="textsuperscript">22</sup></a></span><a 
 id="x38-42001f22"></a> 
class is used to connect to the underlying transport with a bus address and to send and receive
messages.
</p><!--l. 1008--><p class="indent" >   You connect by either creating a <span 
class="cmtt-12">Transport </span>object with the bus address as the parameter,
or by calling <span 
class="cmtt-12">connect </span>with the address later. Addresses are represented using the <span 
class="cmtt-12">BusAddress</span>
class.
</p><!--l. 1012--><p class="indent" >   Messages can be read by calling <span 
class="cmtt-12">transport.min.readMessage() </span>and written by using the
<span 
class="cmtt-12">transport.mout.writeMessage(m) </span>methods.
</p>
   <h4 class="subsectionHead"><span class="titlemark">13.2   </span> <a 
 id="x38-4300013.2"></a>Message</h4>
<!--l. 1017--><p class="noindent" ><span 
class="cmtt-12">Message</span><span class="footnote-mark"><a 
href="dbus-java40.html#fn23x0"><sup class="textsuperscript">23</sup></a></span><a 
 id="x38-43001f23"></a> 
is the superclass of all the classes representing a message. To send a message you need to create
a subclass of this object. Possible message types are: <span 
class="cmtt-12">MethodCall</span>, <span 
class="cmtt-12">MethodReturn</span>, <span 
class="cmtt-12">Error </span>and
<span 
class="cmtt-12">DBusSignal</span>. Constructors for these vary, but they are basically similar to the <span 
class="cmtt-12">MethodCall</span>
class.
</p><!--l. 1023--><p class="indent" >   All the constructors have variadic parameter lists with the last of the parameters being the
signature of the message body and the parameters which make up the body. If the message has
an empty body then the last parameter must be null. Reading and writing messages is not
thread safe.
                                                                                      
                                                                                      
</p><!--l. 1028--><p class="indent" >   Messages can be read either in blocking or non-blocking mode. When reading a message in
non-blocking mode, if a full message has not yet been read from the transport the method will
return null. Messages are instantiated as the correct message type, so <span 
class="cmtt-12">instanceof </span>will work on
the returned object. Blocking mode can be enabled with an extra parameter to the Transport
constructor.
</p><!--l. 1034--><p class="indent" >   Figure <a 
href="#x38-4300220">20<!--tex4ht:ref: fig:lowlevel --></a> shows how to connect to a bus, send the (required) initial &#8216;Hello&#8217; message and call
a method with two parameters.
</p>
   <hr class="figure" /><div class="figure" 
>
                                                                                      
                                                                                      
<a 
 id="x38-4300220"></a>
                                                                                      
                                                                                      
<div class="center" 
>
<!--l. 1039--><p class="noindent" >
                                                                                      
                                                                                      
</p>
<div class="verbatim" id="verbatim-31">
BusAddress&#x00A0;address&#x00A0;=&#x00A0;new&#x00A0;BusAddress(
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;System.getenv("DBUS_SESSION_BUS_ADDRESS"));
&#x00A0;<br />Transport&#x00A0;conn&#x00A0;=&#x00A0;new&#x00A0;Transport(address,&#x00A0;true);
&#x00A0;<br />
&#x00A0;<br />Message&#x00A0;m&#x00A0;=&#x00A0;new&#x00A0;MethodCall("org.freedesktop.DBus",&#x00A0;"/org/freedesktop/DBus",
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;"org.freedesktop.&#x00A0;DBus",&#x00A0;"Hello",&#x00A0;(byte)&#x00A0;0,&#x00A0;null);
&#x00A0;<br />conn.mout.writeMessage(m);
&#x00A0;<br />
&#x00A0;<br />m&#x00A0;=&#x00A0;conn.min.readMessage();
&#x00A0;<br />System.out.println("Response&#x00A0;to&#x00A0;Hello&#x00A0;is:&#x00A0;"+m);
&#x00A0;<br />
&#x00A0;<br />m&#x00A0;=&#x00A0;new&#x00A0;MethodCall("org.freedesktop.DBus",&#x00A0;"/org/freedesktop/DBus",
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;"org.freedesktop.DBus",&#x00A0;"RequestName",&#x00A0;(byte)&#x00A0;0,
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;"su",&#x00A0;"org.testname",&#x00A0;0);
&#x00A0;<br />conn.mout.writeMessage(m);
&#x00A0;<br />
&#x00A0;<br />conn.disconnect();
</div>
<!--l. 1058--><p class="nopar" ></p></div>
<br /> <div class="caption" 
><span class="id">Figure&#x00A0;20: </span><span  
class="content">Low-level usage</span></div><!--tex4ht:label?: x38-4300220 -->
                                                                                      
                                                                                      
   </div><hr class="endfigure" />
                                                                                      
                                                                                      
   <!--l. 1064--><div class="crosslinks"><p class="noindent">[<a 
href="dbus-javase12.html" >prev</a>] [<a 
href="dbus-javase12.html#taildbus-javase12.html" >prev-tail</a>] [<a 
href="dbus-javase13.html" >front</a>] [<a 
href="dbus-java.html# " >up</a>] </p></div>
<!--l. 1064--><p class="indent" >   <a 
 id="taildbus-javase13.html"></a>  </p> 
</body></html>