gnome-control-center/panels/thunderbolt/bolt-client.h
Christian Kellner 47f241b10c thunderbolt: new panel for device management
Thunderbolt devices need to be approved before they can be used.
This is done via the boltd system daemon and gnome-shell. The new
panel enables the user to manage thunderbolt devices, i.e.:

 - forget devices that have previously been authorized
 - authorize currently unauthorize devices

Additionally authorization of devices an be temporarily disabled
to ensure no evil device will gain access to the computers
resources.

File starting with "bolt-" are copied from bolt's source tree
and currently correspond to the bolt upstream commit with the id
f22b1cd6104bdc2b33a95d9896b50f29a141b8d8
They can be updated from bolt via the update-from-bolt.sh script.
2018-04-13 15:08:16 +02:00

107 lines
4.7 KiB
C

/*
* Copyright © 2017 Red Hat, Inc
*
* This program 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.1 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
* Lesser 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, see <http://www.gnu.org/licenses/>.
*
* Authors:
* Christian J. Kellner <christian@kellner.me>
*/
#pragma once
#include "bolt-enums.h"
#include "bolt-device.h"
#include "bolt-proxy.h"
G_BEGIN_DECLS
#define BOLT_TYPE_CLIENT bolt_client_get_type ()
G_DECLARE_FINAL_TYPE (BoltClient, bolt_client, BOLT, CLIENT, BoltProxy);
BoltClient * bolt_client_new (GError **error);
void bolt_client_new_async (GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
BoltClient * bolt_client_new_finish (GAsyncResult *res,
GError **error);
GPtrArray * bolt_client_list_devices (BoltClient *client,
GCancellable *cancellable,
GError **error);
BoltDevice * bolt_client_get_device (BoltClient *client,
const char *uid,
GCancellable *cancellable,
GError **error);
BoltDevice * bolt_client_enroll_device (BoltClient *client,
const char *uid,
BoltPolicy policy,
BoltAuthCtrl flags,
GError **error);
void bolt_client_enroll_device_async (BoltClient *client,
const char *uid,
BoltPolicy policy,
BoltAuthCtrl flags,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
gboolean bolt_client_enroll_device_finish (BoltClient *client,
GAsyncResult *res,
char **path,
GError **error);
gboolean bolt_client_forget_device (BoltClient *client,
const char *uid,
GError **error);
void bolt_client_forget_device_async (BoltClient *client,
const char *uid,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
gboolean bolt_client_forget_device_finish (BoltClient *client,
GAsyncResult *res,
GError **error);
/* getter */
guint bolt_client_get_version (BoltClient *client);
gboolean bolt_client_is_probing (BoltClient *client);
BoltSecurity bolt_client_get_security (BoltClient *client);
BoltAuthMode bolt_client_get_authmode (BoltClient *client);
/* setter */
void bolt_client_set_authmode_async (BoltClient *client,
BoltAuthMode mode,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
gboolean bolt_client_set_authmode_finish (BoltClient *client,
GAsyncResult *res,
GError **error);
/* utility functions */
void bolt_devices_sort_by_syspath (GPtrArray *devices,
gboolean reverse);
G_END_DECLS