This file is indexed.

/usr/share/vala/vapi/gusb.vapi is in libgusb-dev 0.2.11-1.

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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
/* gusb.vapi generated by vapigen-0.36, do not modify. */

[CCode (cprefix = "GUsb", gir_namespace = "GUsb", gir_version = "1.0", lower_case_cprefix = "g_usb_")]
namespace GUsb {
	[CCode (cheader_filename = "gusb.h", type_id = "g_usb_context_get_type ()")]
	public class Context : GLib.Object, GLib.Initable {
		[CCode (has_construct_function = false)]
		[Version (since = "0.1.0")]
		public Context () throws GLib.Error;
		[Version (since = "0.2.2")]
		public void enumerate ();
		[Version (since = "0.1.0")]
		public static GLib.Quark error_quark ();
		[Version (since = "0.2.2")]
		public GUsb.Device find_by_bus_address (uint8 bus, uint8 address) throws GLib.Error;
		[Version (since = "0.2.4")]
		public GUsb.Device find_by_platform_id (string platform_id) throws GLib.Error;
		[Version (since = "0.2.2")]
		public GUsb.Device find_by_vid_pid (uint16 vid, uint16 pid) throws GLib.Error;
		[Version (since = "0.2.2")]
		public GLib.GenericArray<GUsb.Device> get_devices ();
		[Version (since = "0.2.11")]
		public GUsb.ContextFlags get_flags ();
		[Version (since = "0.2.5")]
		public unowned GLib.MainContext get_main_context ();
		[Version (since = "0.1.0")]
		public unowned GUsb.Source get_source (GLib.MainContext main_ctx);
		[Version (since = "0.1.0")]
		public void set_debug (GLib.LogLevelFlags flags);
		[Version (since = "0.2.11")]
		public void set_flags (GUsb.ContextFlags flags);
		[Version (since = "0.2.5")]
		public void set_main_context (GLib.MainContext main_ctx);
		[Version (since = "0.2.9")]
		public GUsb.Device wait_for_replug (GUsb.Device device, uint timeout_ms) throws GLib.Error;
		[NoAccessorMethod]
		public int debug_level { get; set; }
		[NoAccessorMethod]
		public void* libusb_context { get; }
		public virtual signal void device_added (GUsb.Device device);
		public virtual signal void device_removed (GUsb.Device device);
	}
	[CCode (cheader_filename = "gusb.h", type_id = "g_usb_device_get_type ()")]
	public class Device : GLib.Object, GLib.Initable {
		[CCode (has_construct_function = false)]
		protected Device ();
		[Version (since = "0.1.0")]
		public bool bulk_transfer (uint8 endpoint, [CCode (array_length_cname = "length", array_length_pos = 2.5, array_length_type = "gsize")] uint8[] data, size_t actual_length, uint timeout, GLib.Cancellable? cancellable = null) throws GLib.Error;
		[Version (since = "0.1.0")]
		public async ssize_t bulk_transfer_async (uint8 endpoint, [CCode (array_length_cname = "length", array_length_pos = 2.5, array_length_type = "gsize")] uint8[] data, uint timeout, GLib.Cancellable? cancellable) throws GLib.Error;
		[Version (since = "0.1.0")]
		public bool claim_interface (int @interface, GUsb.DeviceClaimInterfaceFlags flags) throws GLib.Error;
		public bool close () throws GLib.Error;
		[Version (since = "0.1.0")]
		public bool control_transfer (GUsb.DeviceDirection direction, GUsb.DeviceRequestType request_type, GUsb.DeviceRecipient recipient, uint8 request, uint16 value, uint16 idx, [CCode (array_length_cname = "length", array_length_pos = 7.5, array_length_type = "gsize")] uint8[] data, size_t actual_length, uint timeout, GLib.Cancellable? cancellable = null) throws GLib.Error;
		[Version (since = "0.1.0")]
		public async ssize_t control_transfer_async (GUsb.DeviceDirection direction, GUsb.DeviceRequestType request_type, GUsb.DeviceRecipient recipient, uint8 request, uint16 value, uint16 idx, [CCode (array_length_cname = "length", array_length_pos = 7.5, array_length_type = "gsize")] uint8[] data, uint timeout, GLib.Cancellable? cancellable) throws GLib.Error;
		[Version (since = "0.1.0")]
		public static GLib.Quark error_quark ();
		[Version (since = "0.1.0")]
		public uint8 get_address ();
		[Version (since = "0.1.0")]
		public uint8 get_bus ();
		[Version (since = "0.2.4")]
		public GLib.GenericArray<GUsb.Device> get_children ();
		[Version (since = "0.1.0")]
		public int get_configuration () throws GLib.Error;
		[Version (since = "0.2.5")]
		public uint8 get_custom_index (uint8 class_id, uint8 subclass_id, uint8 protocol_id) throws GLib.Error;
		[Version (since = "0.1.7")]
		public uint8 get_device_class ();
		[Version (since = "0.2.4")]
		public uint8 get_device_protocol ();
		[Version (since = "0.2.4")]
		public uint8 get_device_subclass ();
		[Version (since = "0.2.8")]
		public GUsb.Interface get_interface (uint8 class_id, uint8 subclass_id, uint8 protocol_id) throws GLib.Error;
		[Version (since = "0.2.8")]
		public GLib.GenericArray<weak GUsb.Interface> get_interfaces () throws GLib.Error;
		[Version (since = "0.1.0")]
		public uint8 get_manufacturer_index ();
		[Version (since = "0.2.4")]
		public GUsb.Device get_parent ();
		[Version (since = "0.1.0")]
		public uint16 get_pid ();
		[Version (since = "0.2.4")]
		public unowned string get_pid_as_str ();
		[Version (since = "0.1.1")]
		public unowned string get_platform_id ();
		[Version (since = "0.2.4")]
		public uint8 get_port_number ();
		[Version (since = "0.1.0")]
		public uint8 get_product_index ();
		[Version (since = "0.2.8")]
		public uint16 get_release ();
		[Version (since = "0.1.0")]
		public uint8 get_serial_number_index ();
		[Version (since = "0.1.0")]
		public string get_string_descriptor (uint8 desc_index) throws GLib.Error;
		[Version (since = "0.1.0")]
		public uint16 get_vid ();
		[Version (since = "0.2.4")]
		public unowned string get_vid_as_str ();
		[Version (since = "0.1.0")]
		public bool interrupt_transfer (uint8 endpoint, [CCode (array_length_cname = "length", array_length_pos = 2.5, array_length_type = "gsize")] uint8[] data, size_t actual_length, uint timeout, GLib.Cancellable? cancellable = null) throws GLib.Error;
		[Version (since = "0.1.0")]
		public async ssize_t interrupt_transfer_async (uint8 endpoint, [CCode (array_length_cname = "length", array_length_pos = 2.5, array_length_type = "gsize")] uint8[] data, uint timeout, GLib.Cancellable? cancellable) throws GLib.Error;
		[Version (since = "0.1.0")]
		public bool open () throws GLib.Error;
		[Version (since = "0.1.0")]
		public bool release_interface (int @interface, GUsb.DeviceClaimInterfaceFlags flags) throws GLib.Error;
		public bool reset () throws GLib.Error;
		[Version (since = "0.1.0")]
		public bool set_configuration (int configuration) throws GLib.Error;
		[Version (since = "0.2.8")]
		public bool set_interface_alt (int @interface, uint8 alt) throws GLib.Error;
		public GUsb.Context context { construct; }
		[NoAccessorMethod]
		public void* libusb_device { get; construct; }
		public string platform_id { construct; }
	}
	[CCode (cheader_filename = "gusb.h", type_id = "g_usb_device_list_get_type ()")]
	public class DeviceList : GLib.Object {
		[CCode (has_construct_function = false)]
		[Version (since = "0.1.0")]
		public DeviceList (GUsb.Context context);
		[Version (since = "0.1.0")]
		public void coldplug ();
		[Version (since = "0.1.0")]
		public GUsb.Device find_by_bus_address (uint8 bus, uint8 address) throws GLib.Error;
		[Version (since = "0.1.0")]
		public GUsb.Device find_by_vid_pid (uint16 vid, uint16 pid) throws GLib.Error;
		[Version (since = "0.1.0")]
		public GLib.GenericArray<GUsb.Device> get_devices ();
		[NoAccessorMethod]
		public GUsb.Context context { owned get; construct; }
		public virtual signal void device_added (GUsb.Device device);
		public virtual signal void device_removed (GUsb.Device device);
	}
	[CCode (cheader_filename = "gusb.h", type_id = "g_usb_interface_get_type ()")]
	public class Interface : GLib.Object {
		[CCode (has_construct_function = false)]
		protected Interface ();
		[Version (since = "0.2.8")]
		public uint8 get_alternate ();
		[Version (since = "0.2.8")]
		public uint8 get_class ();
		[Version (since = "0.2.8")]
		public unowned GLib.Bytes get_extra ();
		[Version (since = "0.2.8")]
		public uint8 get_index ();
		[Version (since = "0.2.8")]
		public uint8 get_kind ();
		[Version (since = "0.2.8")]
		public uint8 get_length ();
		[Version (since = "0.2.8")]
		public uint8 get_number ();
		[Version (since = "0.2.8")]
		public uint8 get_protocol ();
		[Version (since = "0.2.8")]
		public uint8 get_subclass ();
	}
	[CCode (cheader_filename = "gusb.h", has_type_id = false)]
	[Compact]
	public class Source {
		[Version (since = "0.1.0")]
		public void set_callback (owned GLib.SourceFunc func);
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_CONTEXT_ERROR_", has_type_id = false)]
	public enum ContextError {
		[CCode (cname = "G_USB_CONTEXT_ERROR_INTERNAL")]
		CONTEXT_ERROR_INTERNAL
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_CONTEXT_FLAGS_", has_type_id = false)]
	[Flags]
	public enum ContextFlags {
		NONE,
		AUTO_OPEN_DEVICES
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_CLAIM_INTERFACE_BIND_KERNEL_", has_type_id = false)]
	[Flags]
	public enum DeviceClaimInterfaceFlags {
		[CCode (cname = "G_USB_DEVICE_CLAIM_INTERFACE_BIND_KERNEL_DRIVER")]
		DEVICE_CLAIM_INTERFACE_BIND_KERNEL_DRIVER
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_CLASS_", has_type_id = false)]
	public enum DeviceClassCode {
		INTERFACE_DESC,
		AUDIO,
		COMMUNICATIONS,
		HID,
		PHYSICAL,
		IMAGE,
		PRINTER,
		MASS_STORAGE,
		HUB,
		CDC_DATA,
		SMART_CARD,
		CONTENT_SECURITY,
		VIDEO,
		PERSONAL_HEALTHCARE,
		AUDIO_VIDEO,
		BILLBOARD,
		DIAGNOSTIC,
		WIRELESS_CONTROLLER,
		MISCELLANEOUS,
		APPLICATION_SPECIFIC,
		VENDOR_SPECIFIC
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_DIRECTION_", has_type_id = false)]
	public enum DeviceDirection {
		DEVICE_TO_HOST,
		HOST_TO_DEVICE
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_ERROR_", has_type_id = false)]
	public enum DeviceError {
		INTERNAL,
		IO,
		TIMED_OUT,
		NOT_SUPPORTED,
		NO_DEVICE,
		NOT_OPEN,
		ALREADY_OPEN,
		CANCELLED,
		FAILED,
		PERMISSION_DENIED,
		LAST
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_RECIPIENT_", has_type_id = false)]
	public enum DeviceRecipient {
		DEVICE,
		INTERFACE,
		ENDPOINT,
		OTHER
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_DEVICE_REQUEST_TYPE_", has_type_id = false)]
	public enum DeviceRequestType {
		STANDARD,
		CLASS,
		VENDOR,
		RESERVED
	}
	[CCode (cheader_filename = "gusb.h", cprefix = "G_USB_SOURCE_ERROR_")]
	public errordomain SourceError {
		[CCode (cname = "G_USB_SOURCE_ERROR_INTERNAL")]
		SOURCE_ERROR_INTERNAL;
		[Version (since = "0.1.0")]
		public static GLib.Quark quark ();
	}
	[CCode (cheader_filename = "gusb.h", cname = "G_USB_MAJOR_VERSION")]
	public const int MAJOR_VERSION;
	[CCode (cheader_filename = "gusb.h", cname = "G_USB_MICRO_VERSION")]
	public const int MICRO_VERSION;
	[CCode (cheader_filename = "gusb.h", cname = "G_USB_MINOR_VERSION")]
	public const int MINOR_VERSION;
	[CCode (cheader_filename = "gusb.h")]
	public static unowned string strerror (int error_code);
}