/usr/include/liburl-dispatcher-1/url-dispatcher.h is in liburl-dispatcher1-dev 0.1+17.04.20170328-0ubuntu4.
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 | /**
* Copyright (C) 2013 Canonical, Ltd.
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License version 3, as published by
* the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
* SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
#include <glib.h>
#ifndef URL_DISPATCH_H
#define URL_DISPATCH_H 1
#pragma GCC visibility push(default)
G_BEGIN_DECLS
typedef void (*URLDispatchCallback) (const gchar * url, gboolean success, gpointer user_data);
/**
* url_dispatch_send:
* @url: URL to send to the dispatcher
* @cb: Function to call with the result of the URL processing
* @user_data: data pointer for @cb
*
* Sends a URL to the dispatcher for processing. Most of the time,
* things will work out and that URL will result in an application
* being opened with the URL as requested. In some cases the URL
* may not have a valid handler and an error will be returned. In
* that case a bug will be filled on this package.
*/
void url_dispatch_send (const gchar * url,
URLDispatchCallback cb,
gpointer user_data);
/**
* url_dispatch_send_restricted:
* @url: URL to send to the dispatcher
* @cb: Function to call with the result of the URL processing
* @user_data: data pointer for @cb
*
* Very much like url_dispatch_send() except that it also says which
* package is allowed to have the URL. This should be checked with the
* url_dispatch_url_appid() function ahead of time, but is used to avoid
* races that can occur between the test and the processing.
*/
void url_dispatch_send_restricted (const gchar * url,
const gchar * package,
URLDispatchCallback cb,
gpointer user_data);
/**
* url_dispatch_url_appid:
* @urls: URLs to check the AppIDs for
*
* Takes a list of URLs and return which AppIDs will be launched to
* handle those URLs.
*
* NOTE: This function is *not* available for confined applications and
* only for trusted helpers. It could result in discovery of which
* applications are installed on the system if exposed.
*
* Return value: (transfer full): Returns the AppIDs that match the
* same order as @urls. Full transfer, free with g_strfreev().
*/
gchar ** url_dispatch_url_appid (const gchar ** urls);
G_END_DECLS
#pragma GCC visibility pop
#endif /* URL_DISPATCH_H */
|