This file is indexed.

/usr/lib/GNUstep/Frameworks/DBusKit.framework/Versions/0/Headers/DKPort.h is in libdbuskit-dev 0.1.1-2+b1.

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
/** Interface for DKPort for NSConnection integration.
   Copyright (C) 2010 Free Software Foundation, Inc.

   Written by:  Niels Grewe <niels.grewe@halbordnung.de>
   Created: May 2010

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02111 USA.
   */

#import <Foundation/NSPort.h>

@class DKEndpoint;


enum
{
  DKDBusSessionBus,
  DKDBusSystemBus,
  DKDBusBusTypeOther,
  DKDBusBusTypeMax,
};

/**
 * Identifies the type of the well-known bus.
 */
typedef NSUInteger DKDBusBusType;

/**
 * DKPort is used by the Distributed Objects system to communicate with
 * D-Bus. Unless you have special needs, don't create DKPort instances
 * yourself, but use the interfaces provided by NSConnection instead.
 * The default +port message will return a port connected to the session bus.
 */
@interface DKPort: NSPort
{
  @private
  /** The endpoint doing the connection handling. */
  DKEndpoint *endpoint;

  /**
   * The remote side of the port. Will not be specified for peer-to-peer
   * connections bypassing the bus and for ports used in service connections.
   */
  NSString *remote;
}

/**
 * Returns a port to the specified message bus without any specified remote
 * side.
 */
+ (id)portForBusType: (DKDBusBusType)type;

/** Returns a port to the session message bus. */
+ (id)sessionBusPort;

/** Returns a port to the system message bus. */
+ (id)systemBusPort;

/**
 * This method should be called by an application that wants to make use of
 * the multithreaded features of DBusKit. After this method has been called, it
 * is no longer safe to call into DBusKit from +initialize methods, which might
 * result in deadlock from the Objective-C runtime.
 */
+ (void)enableWorkerThread;
/**
 * Return a DKPort instance connected to the specified D-Bus peer on the session
 * message bus.
 */
- (id)initWithRemote: (NSString*)remote;

/**
 * Return a DKPort instance connected to the specified D-Bus peer on the
 * specified message bus.
 */
- (id)initWithRemote: (NSString*)remote
               onBus: (DKDBusBusType)bus;
@end