This file is indexed.

/usr/share/ada/adainclude/dbus-ada/d_bus-messages.ads is in libdbusada0.2-dev 0.2-2.

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
--
--  D_Bus/Ada - An Ada binding to D-Bus
--
--  Copyright (C) 2011  Reto Buerki <reet@codelabs.ch>
--
--  This program is free software; you can redistribute it and/or
--  modify it under the terms of the GNU General Public License
--  as published by the Free Software Foundation; either version 2
--  of the License, or (at your option) any later version.
--
--  This program is distributed in the hope that it will be useful,
--  but WITHOUT ANY WARRANTY; without even the implied warranty of
--  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
--  GNU General Public License for more details.
--
--  You should have received a copy of the GNU General Public License
--  along with this program; if not, write to the Free Software
--  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
--  USA.
--
--  As a special exception, if other files instantiate generics from this
--  unit,  or  you  link  this  unit  with  other  files  to  produce  an
--  executable   this  unit  does  not  by  itself  cause  the  resulting
--  executable to  be  covered by the  GNU General  Public License.  This
--  exception does  not  however  invalidate  any  other reasons why  the
--  executable file might be covered by the GNU Public License.
--

with System;

with D_Bus.Arguments;

package D_Bus.Messages is

   type Message_Variant is
     (Invalid,
      Method_Call,
      Method_Return,
      Error,
      Signal);
   --  D-Bus message types.

   type Message_Type is private;
   --  A D-Bus message, see the section 'Message Format' in the D-Bus
   --  specification.

   function New_Method_Return (Method_Call : Message_Type) return Message_Type;
   --  Constructs a message that is a reply to a method call.

   function New_Error
     (Reply_To      : Message_Type;
      Error_Name    : String;
      Error_Message : String)
      return Message_Type;
   --  Creates a new message that is an error reply to another message.

   function Create (D_Msg : System.Address) return Message_Type;
   --  Create message object from low-level D-Bus message.

   function Get_Type (Msg : Message_Type) return Message_Variant;
   --  Return the message's type.

   function Get_Serial (Msg : Message_Type) return Positive;
   --  Return the message's serial number.

   function Get_Sender (Msg : Message_Type) return String;
   --  Return the message's sender.

   function Get_Destination (Msg : Message_Type) return String;
   --  Return the message's destination.

   function Get_Path (Msg : Message_Type) return String;
   --  Return the path.

   function Get_Interface (Msg : Message_Type) return String;
   --  Return the called interface.

   function Get_Member (Msg : Message_Type) return String;
   --  Return the member; either the method name or signal name.

   function Get_Arguments
     (Msg : Message_Type)
      return Arguments.Argument_List_Type;
   --  Return the message's arguments (if any).

   procedure Add_Arguments
     (Msg  : in out Message_Type;
      Args :        Arguments.Argument_List_Type);
   --  Add given arguments to message.

   function Is_Method_Call
     (Msg    : Message_Type;
      Iface  : String;
      Method : String)
      return Boolean;
   --  Checks whether the given message is a method call with the given
   --  interface and member fields.

   function To_Thin (Msg : Message_Type) return System.Address;
   --  Helper function to convert the Ada D-Bus message to a thin binding
   --  memory address. TODO: remove me.

   Invalid_Message : exception;

private

   type Message_Type is record
      Thin_Msg : System.Address := System.Null_Address;
   end record;

end D_Bus.Messages;