Branch data     Line data    Source code

       1                 :            : /* GIO - GLib Input, Output and Streaming Library
       2                 :            :  *
       3                 :            :  * Copyright (C) 2010 Christian Kellner
       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: Christian Kellner <gicmo@gnome.org>
      21                 :            :  */
      22                 :            : 
      23                 :            : #include "config.h"
      24                 :            : #include "gfiledescriptorbased.h"
      25                 :            : #include "glibintl.h"
      26                 :            : 
      27                 :            : 
      28                 :            : /**
      29                 :            :  * GFileDescriptorBased:
      30                 :            :  *
      31                 :            :  * `GFileDescriptorBased` is an interface for file descriptor based IO.
      32                 :            :  *
      33                 :            :  * It is implemented by streams (implementations of [class@Gio.InputStream] or
      34                 :            :  * [class@Gio.OutputStream]) that are based on file descriptors.
      35                 :            :  *
      36                 :            :  * Note that `<gio/gfiledescriptorbased.h>` belongs to the UNIX-specific
      37                 :            :  * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
      38                 :            :  * file or the `GioUnix-2.0` GIR namespace when using it.
      39                 :            :  *
      40                 :            :  * Since: 2.24
      41                 :            :  **/
      42                 :            : 
      43                 :            : typedef GFileDescriptorBasedIface GFileDescriptorBasedInterface;
      44   [ +  +  +  -  :        708 : G_DEFINE_INTERFACE (GFileDescriptorBased, g_file_descriptor_based, G_TYPE_OBJECT)
                   +  + ]
      45                 :            : 
      46                 :            : static void
      47                 :        124 : g_file_descriptor_based_default_init (GFileDescriptorBasedInterface *iface)
      48                 :            : {
      49                 :        124 : }
      50                 :            : 
      51                 :            : /**
      52                 :            :  * g_file_descriptor_based_get_fd:
      53                 :            :  * @fd_based: a #GFileDescriptorBased.
      54                 :            :  *
      55                 :            :  * Gets the underlying file descriptor.
      56                 :            :  *
      57                 :            :  * Returns: The file descriptor
      58                 :            :  *
      59                 :            :  * Since: 2.24
      60                 :            :  **/
      61                 :            : int
      62                 :        114 : g_file_descriptor_based_get_fd (GFileDescriptorBased *fd_based)
      63                 :            : {
      64                 :            :   GFileDescriptorBasedIface *iface;
      65                 :            : 
      66                 :        114 :   g_return_val_if_fail (G_IS_FILE_DESCRIPTOR_BASED (fd_based), -1);
      67                 :            : 
      68                 :        114 :   iface = G_FILE_DESCRIPTOR_BASED_GET_IFACE (fd_based);
      69                 :            : 
      70                 :        114 :   return (* iface->get_fd) (fd_based);
      71                 :            : }