docs/reference/gio/overview.xml

   1 <part>
   2   <title>GIO Overview</title>
   3
   4   <chapter>
   5     <title>Introduction</title>
   6
   7   <para>
   8     GIO is striving to provide a modern, easy-to-use VFS API that sits
   9     at the right level in the library stack, as well as other generally
  10     useful APIs for desktop applications (such as networking and
  11     D-Bus support). The goal is to overcome the shortcomings of GnomeVFS
  12     and provide an API that is so good that developers prefer it over raw
  13     POSIX calls. Among other things that means using GObject. It also means
  14     not cloning the POSIX API, but providing higher-level, document-centric
  15     interfaces.
  16   </para>
  17
  18   <para>
  19     The abstract file system model of GIO consists of a number of
  20     interfaces and base classes for I/O and files:
  21     <variablelist>
  22        <varlistentry>
  23          <term>GFile</term>
  24          <listitem><para>reference to a file</para></listitem>
  25        </varlistentry>
  26        <varlistentry>
  27          <term>GFileInfo</term>
  28          <listitem><para>information about a file or filesystem</para></listitem>
  29        </varlistentry>
  30        <varlistentry>
  31          <term>GFileEnumerator</term>
  32          <listitem><para>list files in directories</para></listitem>
  33        </varlistentry>
  34        <varlistentry>
  35          <term>GDrive</term>
  36          <listitem><para>represents a drive</para></listitem>
  37        </varlistentry>
  38        <varlistentry>
  39          <term>GVolume</term>
  40          <listitem><para>represents a file system in an abstract way</para></listitem>
  41        </varlistentry>
  42        <varlistentry>
  43          <term>GMount</term>
  44          <listitem><para>represents a mounted file system</para></listitem>
  45        </varlistentry>
  46     </variablelist>
  47     Then there is a number of stream classes, similar to the input and
  48     output stream hierarchies that can be found in frameworks like Java:
  49     <variablelist>
  50        <varlistentry>
  51          <term>GInputStream</term>
  52          <listitem><para>read data</para></listitem>
  53        </varlistentry>
  54        <varlistentry>
  55          <term>GOutputStream</term>
  56          <listitem><para>write data</para></listitem>
  57        </varlistentry>
  58        <varlistentry>
  59          <term>GIOStream</term>
  60          <listitem><para>read and write data</para></listitem>
  61        </varlistentry>
  62        <varlistentry>
  63          <term>GSeekable</term>
  64          <listitem><para>interface optionally implemented by streams to support seeking</para></listitem>
  65        </varlistentry>
  66     </variablelist>
  67     There are interfaces related to applications and the types
  68     of files they handle:
  69     <variablelist>
  70        <varlistentry>
  71           <term>GAppInfo</term>
  72           <listitem><para>information about an installed application</para></listitem>
  73        </varlistentry>
  74        <varlistentry>
  75           <term>GIcon</term>
  76           <listitem><para>abstract type for file and application icons</para></listitem>
  77        </varlistentry>
  78     </variablelist>
  79     There is a framework for storing and retrieving application settings:
  80     <variablelist>
  81        <varlistentry>
  82           <term>GSettings</term>
  83           <listitem><para>stores and retrieves application settings</para></listitem>
  84        </varlistentry>
  85     </variablelist>
  86     There is support for network programming, including connectivity monitoring,
  87     name resolution, lowlevel socket APIs and highlevel client and server
  88     helper classes:
  89     <variablelist>
  90        <varlistentry>
  91           <term>GSocket</term>
  92           <listitem><para>lowlevel platform independent socket object</para></listitem>
  93        </varlistentry>
  94        <varlistentry>
  95           <term>GResolver</term>
  96           <listitem><para>asynchronous and cancellable DNS resolver</para></listitem>
  97        </varlistentry>
  98        <varlistentry>
  99           <term>GSocketClient</term>
 100           <listitem><para>high-level network client helper</para></listitem>
 101        </varlistentry>
 102        <varlistentry>
 103           <term>GSocketService</term>
 104           <listitem><para>high-level network server helper</para></listitem>
 105        </varlistentry>
 106        <varlistentry>
 107           <term>GSocketConnection</term>
 108           <listitem><para>network connection stream</para></listitem>
 109        </varlistentry>
 110        <varlistentry>
 111           <term>GNetworkMonitor</term>
 112           <listitem><para>network connectivity monitoring</para></listitem>
 113        </varlistentry>
 114     </variablelist>
 115     There is support for connecting to <link linkend="http://www.freedesktop.org/wiki/Software/dbus">D-Bus</link>,
 116     sending and receiving messages, owning and watching bus names,
 117     and making objects available on the bus:
 118     <variablelist>
 119        <varlistentry>
 120           <term>GDBusConnection</term>
 121           <listitem><para>a D-Bus connection</para></listitem>
 122        </varlistentry>
 123
 124        <varlistentry>
 125           <term>GDBusMethodInvocation</term>
 126           <listitem><para>for handling remote calls</para></listitem>
 127        </varlistentry>
 128
 129        <varlistentry>
 130           <term>GDBusServer</term>
 131           <listitem><para>helper for accepting connections</para></listitem>
 132        </varlistentry>
 133
 134        <varlistentry>
 135           <term>GDBusProxy</term>
 136           <listitem><para>proxy to access D-Bus interfaces on a remote object</para></listitem>
 137        </varlistentry>
 138
 139     </variablelist>
 140     Beyond these, GIO provides facilities for file monitoring,
 141     asynchronous I/O and filename completion. In addition to the
 142     interfaces, GIO provides implementations for the local case.
 143     Implementations for various network file systems are provided
 144     by the GVFS package as loadable modules.
 145   </para>
 146
 147   <para>
 148     Other design choices which consciously break with the GnomeVFS
 149     design are to move backends out-of-process, which minimizes the
 150     dependency bloat and makes the whole system more robust. The backends
 151     are not included in GIO, but in the separate GVFS package. The GVFS
 152     package also contains the GVFS daemon, which spawn further mount
 153     daemons for each individual connection.
 154   </para>
 155
 156   <figure id="gvfs-overview">
 157     <title>GIO in the GTK+ library stack</title>
 158     <graphic fileref="gvfs-overview.png" format="PNG"></graphic>
 159   </figure>
 160
 161   <para>
 162     The GIO model of I/O is stateful: if an application establishes e.g.
 163     a SFTP connection to a server, it becomes available to all applications
 164     in the session; the user does not have to enter his password over
 165     and over again.
 166   </para>
 167   <para>
 168     One of the big advantages of putting the VFS in the GLib layer
 169     is that GTK+ can directly use it, e.g. in the filechooser.
 170   </para>
 171   </chapter>
 172
 173   <chapter>
 174     <title>Writing GIO applications</title>
 175
 176     <para>
 177       The information in the GLib <ulink url="http://developer.gnome.org/glib/stable/glib-programming.html">documentation</ulink> about writing GLib
 178       applications is generally applicable when writing GIO applications.
 179     </para>
 180
 181     <simplesect><title>Threads</title>
 182
 183     <para>
 184        GDBus has its own private worker thread, so applications using
 185        GDBus have at least 3 threads. GIO makes heavy use of the concept
 186        of a <link linkend="g-main-context-push-thread-default">thread-default
 187        main context</link> to execute callbacks of asynchronous
 188        methods in the same context in which the operation was started.
 189     </para>
 190
 191     </simplesect>
 192
 193     <simplesect><title>Security</title>
 194
 195 <para>
 196 When your program needs to carry out some privileged operation (say,
 197 create a new user account), there are various ways in which you can go
 198 about this:
 199 <itemizedlist>
 200 <listitem><para>
 201 Implement a daemon that offers the privileged operation. A convenient
 202 way to do this is as a D-Bus system-bus service. The daemon will probably
 203 need ways to check the identity and authorization of the caller before
 204 executing the operation. <ulink url="http://www.freedesktop.org/software/polkit/docs/latest/polkit.8.html">polkit</ulink> is a framework that allows this.
 205 </para></listitem>
 206 <listitem><para>
 207 Use a small helper that is executed with elevated privileges via
 208 pkexec. <ulink url="http://www.freedesktop.org/software/polkit/docs/latest/pkexec.1.html">pkexec</ulink> is a small program launcher that is part of polkit.
 209 </para></listitem>
 210 <listitem><para>
 211 Use a small helper that is executed with elevated privileges by
 212 being suid root.
 213 </para></listitem>
 214 </itemizedlist>
 215 None of these approaches is the clear winner, they all have their
 216 advantages and disadvantages.
 217 </para>
 218
 219 <para>
 220 When writing code that runs with elevated privileges, it is important
 221 to follow some basic rules of secure programming. David Wheeler has an
 222 excellent book on this topic,
 223 <ulink url="http://www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/index.html">Secure Programming for Linux and Unix HOWTO</ulink>.
 224 </para>
 225
 226 <para>
 227 When using GIO in code that runs with elevated privileges, you have to
 228 be careful. GIO has extension points whose implementations get loaded
 229 from modules (executable code in shared objects), which could allow
 230 an attacker to sneak his own code into your application by tricking it
 231 into loading the code as a module. However, GIO will never load modules
 232 from your home directory except when explictly asked to do so via an
 233 environment variable.
 234 </para>
 235
 236 <para>
 237 In most cases, your helper program should be so small that you don't
 238 need GIO, whose APIs are largely designed to support full-blown desktop
 239 applications. If you can't resist the convenience of these APIs, here
 240 are some steps you should take:
 241 <itemizedlist>
 242 <listitem><para>
 243 Clear the environment, e.g. using the <function>clearenv()</function>
 244 function.
 245 David Wheeler has a good <ulink url="http://www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/environment-variables.html">explanation</ulink> for why it is
 246 important to sanitize the environment.
 247 See <xref linkend="running-gio-apps"/>
 248 for a list of all environment variables affecting GIO. In particular,
 249 <envar>PATH</envar> (used to locate binaries), <envar>GIO_EXTRA_MODULES</envar> (used to locate loadable modules) and <envar>DBUS_{SYSTEM,SESSION}_BUS_ADDRESS</envar> (used to locate the D-Bus system and session bus) are important.
 250 </para></listitem>
 251 <listitem><para>
 252 Don't use GVfs, by setting <envar>GIO_USE_VFS=local</envar> in the environment.
 253 The reason to avoid GVfs in security-sensitive programs is that it uses
 254 many libraries which have not necessarily been audited for security problems.
 255 Gvfs is also heavily distributed and relies on a session bus to be present.
 256 </para></listitem>
 257 </itemizedlist>
 258 </para>
 259
 260     </simplesect>
 261
 262   </chapter>
 263
 264   <chapter>
 265     <title>Compiling GIO applications</title>
 266
 267     <para>
 268       GIO comes with a <filename>gio-2.0.pc</filename> file that you
 269       should use together with <literal>pkg-config</literal> to obtain
 270       the necessary information about header files and libraries. See
 271       the <literal>pkg-config</literal> man page or the GLib documentation
 272       for more information on how to use <literal>pkg-config</literal>
 273       to compile your application.
 274     </para>
 275
 276     <para>
 277       If you are using GIO on UNIX-like systems, you may want to use
 278       UNIX-specific GIO interfaces such as #GUnixInputStream,
 279       #GUnixOutputStream, #GUnixMount or #GDesktopAppInfo.
 280       To do so, use the <filename>gio-unix-2.0.pc</filename> file
 281       instead of <filename>gio-2.0.pc</filename>
 282     </para>
 283   </chapter>
 284
 285   <chapter id="running-gio-apps">
 286     <title>Running GIO applications</title>
 287
 288     <para>
 289       GIO inspects a few of environment variables in addition to the
 290       ones used by GLib.
 291     </para>
 292
 293     <formalpara>
 294       <title><envar>XDG_DATA_HOME</envar>, <envar>XDG_DATA_DIRS</envar></title>
 295
 296       <para>
 297         GIO uses these environment variables to locate MIME information.
 298         For more information, see the <ulink url="http://freedesktop.org/Standards/shared-mime-info-spec">Shared MIME-info Database</ulink>
 299         and the <ulink url="http://freedesktop.org/Standards/basedir-spec">Base Directory Specification</ulink>.
 300       </para>
 301     </formalpara>
 302
 303     <formalpara>
 304       <title><envar>GVFS_DISABLE_FUSE</envar></title>
 305
 306       <para>
 307         This variable can be set to keep #Gvfs from starting the fuse backend,
 308         which may be unwanted or unnecessary in certain situations.
 309       </para>
 310     </formalpara>
 311
 312     <para>
 313       The following environment variables are only useful for debugging
 314       GIO itself or modules that it loads. They should not be set in a
 315       production environment.
 316     </para>
 317     <formalpara>
 318       <title><envar>GIO_USE_VFS</envar></title>
 319
 320       <para>
 321         This environment variable can be set to the name of a #GVfs
 322         implementation to override the default for debugging purposes.
 323         The #GVfs implementation for local files that is included in GIO
 324         has the name "local", the implementation in the gvfs module has
 325         the name "gvfs".
 326       </para>
 327     </formalpara>
 328
 329     <formalpara>
 330       <title><envar>GIO_USE_FILE_MONITOR</envar></title>
 331
 332       <para>
 333         This variable can be set to the name of a #GFileMonitor
 334         implementation to override the default for debugging purposes.
 335         The #GFileMonitor implementation for local files that is included
 336         in GIO on Linux has the name "inotify", others that are built
 337         are built as modules (depending on the platform) are called
 338         "fam" and "fen".
 339       </para>
 340     </formalpara>
 341
 342     <formalpara>
 343       <title><envar>GIO_USE_VOLUME_MONITOR</envar></title>
 344
 345       <para>
 346         This variable can be set to the name of a #GVolumeMonitor
 347         implementation to override the default for debugging purposes.
 348         The #GVolumeMonitor implementation for local files that is included
 349         in GIO has the name "unix", the hal-based implementation in the
 350         gvfs module has the name "hal".
 351       </para>
 352     </formalpara>
 353
 354     <formalpara>
 355       <title><envar>GIO_USE_TLS</envar></title>
 356
 357       <para>
 358         This variable can be set to the name of a #GTlsBackend
 359         implementation to override the default for debugging purposes.
 360         GIO does not include a #GTlsBackend implementation, the gnutls-based
 361         implementation in the glib-networking module has the name "gnutls".
 362       </para>
 363     </formalpara>
 364
 365     <formalpara>
 366       <title><envar>GIO_MODULE_DIR</envar></title>
 367
 368       <para>
 369         When this environment variable is set to a path, GIO will load
 370         modules from this alternate directory instead of the directory
 371         built into GIO. This is useful when running tests, for example.
 372       </para>
 373     </formalpara>
 374
 375     <formalpara>
 376       <title><envar>GIO_EXTRA_MODULES</envar></title>
 377
 378       <para>
 379         When this environment variable is set to a path, or a set of
 380         paths separated by a colon, GIO will attempt to load
 381         additional modules from within the path.
 382       </para>
 383     </formalpara>
 384
 385     <formalpara>
 386       <title><envar>GSETTINGS_BACKEND</envar></title>
 387
 388       <para>
 389         This variable can be set to the name of a #GSettingsBackend
 390         implementation to override the default for debugging purposes.
 391         The memory-based implementation that is included in GIO has
 392         the name "memory", the one in dconf has the name "dconf-settings".
 393       </para>
 394     </formalpara>
 395
 396     <formalpara>
 397       <title><envar>GSETTINGS_SCHEMA_DIR</envar></title>
 398
 399       <para>
 400         This variable can be set to the name of a directory that is
 401         considered in addition to the <filename>glib-2.0/schemas</filename>
 402         subdirectories of the XDG system data dirs when looking
 403         for compiled schemas for #GSettings.
 404       </para>
 405     </formalpara>
 406
 407    <formalpara>
 408       <title><envar>DBUS_SYSTEM_BUS_ADDRESS</envar></title>
 409
 410       <para>
 411         This variable is consulted to find the address of the D-Bus system
 412         bus. For the format of D-Bus addresses, see the D-Bus
 413         <ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#addresses">specification</ulink>.
 414       </para>
 415       <para>
 416         Setting this variable overrides platform-specific ways of determining
 417         the system bus address.
 418       </para>
 419    </formalpara>
 420
 421    <formalpara>
 422       <title><envar>DBUS_SESSION_BUS_ADDRESS</envar></title>
 423
 424       <para>
 425         This variable is consulted to find the address of the D-Bus session bus.
 426       </para>
 427       <para>
 428         Setting this variable overrides platform-specific ways of determining
 429         the session bus address.
 430       </para>
 431    </formalpara>
 432
 433    <formalpara>
 434       <title><envar>DBUS_STARTER_BUS_TYPE</envar></title>
 435
 436       <para>
 437         This variable is consulted to find out the 'starter' bus for an
 438         application that has been started via D-Bus activation. The possible
 439         values are 'system' or 'session'.
 440       </para>
 441    </formalpara>
 442
 443    <formalpara>
 444       <title><envar>G_DBUS_DEBUG</envar></title>
 445
 446       <para>
 447          This variable can be set to a list of debug options, which
 448          cause GLib to print out different types of debugging
 449          information when using the D-Bus routines.
 450          <variablelist>
 451            <varlistentry>
 452              <term>transport</term>
 453              <listitem><para>Show IO activity (e.g. reads and writes)</para></listitem>
 454            </varlistentry>
 455            <varlistentry>
 456              <term>message</term>
 457              <listitem><para>Show all sent and received D-Bus messages</para></listitem>
 458            </varlistentry>
 459            <varlistentry>
 460              <term>payload</term>
 461              <listitem><para>Show payload for all sent and received D-Bus messages (implies message)</para></listitem>
 462            </varlistentry>
 463            <varlistentry>
 464              <term>call</term>
 465              <listitem><para>Trace g_dbus_connection_call() and g_dbus_connection_call_sync() API usage</para></listitem>
 466            </varlistentry>
 467            <varlistentry>
 468              <term>signal</term>
 469              <listitem><para>Show when a D-Bus signal is received</para></listitem>
 470            </varlistentry>
 471            <varlistentry>
 472              <term>incoming</term>
 473              <listitem><para>Show when an incoming D-Bus method call is received</para></listitem>
 474            </varlistentry>
 475            <varlistentry>
 476              <term>return</term>
 477              <listitem><para>Show when a reply is returned via the #GDBusMethodInvocation API</para></listitem>
 478            </varlistentry>
 479            <varlistentry>
 480              <term>emission</term>
 481              <listitem><para>Trace g_dbus_connection_emit_signal() API usage</para></listitem>
 482            </varlistentry>
 483            <varlistentry>
 484              <term>authentication</term>
 485              <listitem><para>Show information about connection authentication</para></listitem>
 486            </varlistentry>
 487            <varlistentry>
 488              <term>address</term>
 489              <listitem><para>Show information about D-Bus address lookups and autolaunching</para></listitem>
 490            </varlistentry>
 491          </variablelist>
 492          The special value <literal>all</literal> can be used to turn
 493          on all debug options. The special value
 494          <literal>help</literal> can be used to print a list of
 495          supported options to standard output.
 496       </para>
 497    </formalpara>
 498
 499    <formalpara>
 500       <title><envar>G_DBUS_COOKIE_SHA1_KEYRING_DIR</envar></title>
 501
 502       <para>
 503         Can be used to override the directory used to store the
 504         keyring used in the <literal>DBUS_COOKIE_SHA1</literal>
 505         authentication mechanism. Normally the directory used is
 506         <filename>.dbus-keyrings</filename> in the user's home
 507         directory.
 508       </para>
 509    </formalpara>
 510
 511    <formalpara>
 512       <title><envar>G_DBUS_COOKIE_SHA1_KEYRING_DIR_IGNORE_PERMISSION</envar></title>
 513
 514       <para>
 515         If set, the permissions of the directory used to store the
 516         keyring used in the <literal>DBUS_COOKIE_SHA1</literal>
 517         authentication mechanism won't be checked. Normally the
 518         directory must be readable only by the user.
 519       </para>
 520    </formalpara>
 521   </chapter>
 522
 523   <chapter id="extending-gio">
 524     <title>Extending GIO</title>
 525
 526     <para>
 527       A lot of the functionality that is accessible through GIO
 528       is implemented in loadable modules, and modules provide a convenient
 529       way to extend GIO. In addition to the #GIOModule API which supports
 530       writing such modules, GIO has a mechanism to define extension points,
 531       and register implementations thereof, see #GIOExtensionPoint.
 532     </para>
 533     <para>
 534       The following extension points are currently defined by GIO:
 535     </para>
 536
 537     <formalpara>
 538        <title>G_VFS_EXTENSION_POINT_NAME</title>
 539
 540        <para>
 541           Allows to override the functionality of the #GVfs class.
 542           Implementations of this extension point must be derived from #GVfs.
 543           GIO uses the implementation with the highest priority that is active,
 544           see g_vfs_is_active().
 545        </para>
 546        <para>
 547           GIO implements this extension point for local files, gvfs contains
 548           an implementation that supports all the backends in gvfs.
 549        </para>
 550    </formalpara>
 551
 552    <formalpara>
 553       <title>G_VOLUME_MONITOR_EXTENSION_POINT_NAME</title>
 554
 555       <para>
 556          Allows to add more volume monitors.
 557          Implementations of this extension point must be derived from
 558          #GVolumeMonitor. GIO uses all registered extensions.
 559       </para>
 560       <para>
 561         gvfs contains an implementation that works together with the #GVfs
 562         implementation in gvfs.
 563       </para>
 564    </formalpara>
 565
 566    <formalpara>
 567       <title>G_NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME</title>
 568
 569       <para>
 570          Allows to override the 'native' volume monitor.
 571          Implementations of this extension point must be derived from
 572          #GNativeVolumeMonitor. GIO uses the implementation with
 573          the highest priority that is supported, as determined by the
 574          is_supported() vfunc in #GVolumeMonitorClass.
 575       </para>
 576       <para>
 577          GIO implements this extension point for local mounts,
 578          gvfs contains a hal-based implementation.
 579       </para>
 580    </formalpara>
 581
 582    <formalpara>
 583       <title>G_LOCAL_FILE_MONITOR_EXTENSION_POINT_NAME</title>
 584
 585       <para>
 586         Allows to override the file monitor implementation for
 587         local files. Implementations of this extension point must
 588         be derived from #GLocalFileMonitor. GIO uses the implementation
 589         with the highest priority that is supported, as determined by the
 590         is_supported() vfunc in #GLocalFileMonitorClass.
 591       </para>
 592       <para>
 593         GIO uses this extension point internally, to switch between
 594         its fam-based and inotify-based file monitoring implementations.
 595       </para>
 596    </formalpara>
 597
 598    <formalpara>
 599       <title>G_LOCAL_DIRECTORY_MONITOR_EXTENSION_POINT_NAME</title>
 600
 601       <para>
 602         Allows to override the directory monitor implementation for
 603         local files. Implementations of this extension point must be
 604         derived from #GLocalDirectoryMonitor. GIO uses the implementation
 605         with the highest priority that is supported, as determined by the
 606         is_supported() vfunc in #GLocalDirectoryMonitorClass.
 607       </para>
 608       <para>
 609         GIO uses this extension point internally, to switch between
 610         its fam-based and inotify-based directory monitoring implementations.
 611       </para>
 612    </formalpara>
 613
 614    <formalpara>
 615       <title>G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME</title>
 616
 617       <para>
 618         Unix-only. Allows to provide a way to associate default handlers
 619         with URI schemes. Implementations of this extension point must
 620         implement the #GDesktopAppInfoLookup interface. GIO uses the
 621         implementation with the highest priority.
 622       </para>
 623       <para>
 624         This extension point has been discontinued in GLib 2.28. It is
 625         still available to keep API and ABI stability, but GIO is no
 626         longer using it for default handlers. Instead, the mime handler
 627         mechanism is used, together with x-scheme-handler pseudo-mimetypes.
 628       </para>
 629    </formalpara>
 630
 631    <formalpara>
 632       <title>G_SETTINGS_BACKEND_EXTENSION_POINT_NAME</title>
 633
 634       <para>
 635         Allows to provide an alternative storage for #GSettings.
 636         Implementations of this extension point must derive from the
 637         #GSettingsBackend type. GIO contains a keyfile-based
 638         implementation of this extension point, another one is provided
 639         by dconf.
 640       </para>
 641    </formalpara>
 642
 643    <formalpara>
 644      <title>G_PROXY_EXTENSION_POINT_NAME</title>
 645
 646      <para>
 647        Allows to provide implementations for network proxying.
 648        Implementations of this extension point must provide the
 649        #GProxy interface, and must be named after the network
 650        protocol they are proxying.
 651      </para>
 652      <para>
 653        glib-networking contains an implementation of this extension
 654        point based on libproxy.
 655      </para>
 656    </formalpara>
 657    <formalpara>
 658      <title>G_TLS_BACKEND_EXTENSION_POINT_NAME</title>
 659
 660      <para>
 661        Allows to provide implementations for TLS support.
 662        Implementations of this extension point must implement
 663        the #GTlsBackend interface.
 664      </para>
 665      <para>
 666        glib-networking contains an implementation of this extension
 667        point.
 668      </para>
 669    </formalpara>
 670
 671    <formalpara>
 672      <title>G_NETWORK_MONITOR_EXTENSION_POINT_NAME</title>
 673
 674      <para>
 675        Allows to provide implementations for network connectivity
 676        monitoring.
 677        Implementations of this extension point must implement
 678        the #GNetworkMonitorInterface interface.
 679      </para>
 680      <para>
 681        GIO contains an implementation of this extension point
 682        that is using the netlink interface of the Linux kernel.
 683      </para>
 684    </formalpara>
 685   </chapter>
 686 </part>
 687