gdbusnamewatching.h 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. /* GDBus - GLib D-Bus Library
  2. *
  3. * Copyright (C) 2008-2010 Red Hat, Inc.
  4. *
  5. * SPDX-License-Identifier: LGPL-2.1-or-later
  6. *
  7. * This library is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU Lesser General Public
  9. * License as published by the Free Software Foundation; either
  10. * version 2.1 of the License, or (at your option) any later version.
  11. *
  12. * This library is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * Lesser General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU Lesser General
  18. * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
  19. *
  20. * Author: David Zeuthen <davidz@redhat.com>
  21. */
  22. #ifndef __G_DBUS_NAME_WATCHING_H__
  23. #define __G_DBUS_NAME_WATCHING_H__
  24. #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
  25. #error "Only <gio/gio.h> can be included directly."
  26. #endif
  27. #include <gio/giotypes.h>
  28. G_BEGIN_DECLS
  29. /**
  30. * GBusNameAppearedCallback:
  31. * @connection: The #GDBusConnection the name is being watched on.
  32. * @name: The name being watched.
  33. * @name_owner: Unique name of the owner of the name being watched.
  34. * @user_data: User data passed to g_bus_watch_name().
  35. *
  36. * Invoked when the name being watched is known to have to have an owner.
  37. *
  38. * Since: 2.26
  39. */
  40. typedef void (*GBusNameAppearedCallback) (GDBusConnection *connection,
  41. const gchar *name,
  42. const gchar *name_owner,
  43. gpointer user_data);
  44. /**
  45. * GBusNameVanishedCallback:
  46. * @connection: The #GDBusConnection the name is being watched on, or
  47. * %NULL.
  48. * @name: The name being watched.
  49. * @user_data: User data passed to g_bus_watch_name().
  50. *
  51. * Invoked when the name being watched is known not to have to have an owner.
  52. *
  53. * This is also invoked when the #GDBusConnection on which the watch was
  54. * established has been closed. In that case, @connection will be
  55. * %NULL.
  56. *
  57. * Since: 2.26
  58. */
  59. typedef void (*GBusNameVanishedCallback) (GDBusConnection *connection,
  60. const gchar *name,
  61. gpointer user_data);
  62. GIO_AVAILABLE_IN_ALL
  63. guint g_bus_watch_name (GBusType bus_type,
  64. const gchar *name,
  65. GBusNameWatcherFlags flags,
  66. GBusNameAppearedCallback name_appeared_handler,
  67. GBusNameVanishedCallback name_vanished_handler,
  68. gpointer user_data,
  69. GDestroyNotify user_data_free_func);
  70. GIO_AVAILABLE_IN_ALL
  71. guint g_bus_watch_name_on_connection (GDBusConnection *connection,
  72. const gchar *name,
  73. GBusNameWatcherFlags flags,
  74. GBusNameAppearedCallback name_appeared_handler,
  75. GBusNameVanishedCallback name_vanished_handler,
  76. gpointer user_data,
  77. GDestroyNotify user_data_free_func);
  78. GIO_AVAILABLE_IN_ALL
  79. guint g_bus_watch_name_with_closures (GBusType bus_type,
  80. const gchar *name,
  81. GBusNameWatcherFlags flags,
  82. GClosure *name_appeared_closure,
  83. GClosure *name_vanished_closure);
  84. GIO_AVAILABLE_IN_ALL
  85. guint g_bus_watch_name_on_connection_with_closures (
  86. GDBusConnection *connection,
  87. const gchar *name,
  88. GBusNameWatcherFlags flags,
  89. GClosure *name_appeared_closure,
  90. GClosure *name_vanished_closure);
  91. GIO_AVAILABLE_IN_ALL
  92. void g_bus_unwatch_name (guint watcher_id);
  93. G_END_DECLS
  94. #endif /* __G_DBUS_NAME_WATCHING_H__ */