mirror of
https://github.com/flatpak/flatpak.git
synced 2026-06-26 17:26:50 -04:00
1c391d734c
The functionality that was prototyped in libglnx as glnx_fd_close
and then glnx_autofd was later added to GLib as g_autofd.
glnx_close_fd() doesn't have a direct equivalent in GLib, so keep
it intact, but using the backported _glnx_clear_fd_ignore_error as
its implementation. g_clear_fd() is the closest thing in GLib, but
g_clear_fd() guarantees to set errno on failure (making it useful for
error-checking), whereas glnx_close_fd() guarantees to leave errno
untouched, making it more useful for cleanup code paths that recover
from a syscall or similar function that sets errno:
int fd = ...;
success = (fsync (fd) == 0);
glnx_close_fd (&fd);
return success; /* if false, errno indicates why fsync failed */
(Of course in many cases, including this simple example, it would have
been easier to use g_autofd.)
glnx_autofd and glnx_fd_close are now equivalent to the backport of
g_autofd, so document them as deprecated. There's essentially no cost to
retaining them, so don't apply deprecation attributes.
Signed-off-by: Simon McVittie <smcv@collabora.com>
74 lines
1.9 KiB
C
74 lines
1.9 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
|
*
|
|
* Copyright (C) 2012,2015 Colin Walters <walters@verbum.org>.
|
|
* SPDX-License-Identifier: LGPL-2.0-or-later
|
|
*
|
|
* This library 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 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, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <gio/gio.h>
|
|
#include <errno.h>
|
|
|
|
#include "glnx-backports.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* glnx_unref_object:
|
|
*
|
|
* Call g_object_unref() on a variable location when it goes out of
|
|
* scope. Note that unlike g_object_unref(), the variable may be
|
|
* %NULL.
|
|
*/
|
|
#define glnx_unref_object __attribute__ ((cleanup(glnx_local_obj_unref)))
|
|
static inline void
|
|
glnx_local_obj_unref (void *v)
|
|
{
|
|
GObject *o = *(GObject **)v;
|
|
if (o)
|
|
g_object_unref (o);
|
|
}
|
|
|
|
/* Backwards-compat with older libglnx */
|
|
#define glnx_steal_fd g_steal_fd
|
|
|
|
/**
|
|
* glnx_close_fd:
|
|
* @fdp: Pointer to fd
|
|
*
|
|
* Same as `g_clear_fd()`, but ignoring the error (if any) and making sure
|
|
* not to alter `errno`. As a result, this function can be used for cleanup
|
|
* in contexts where `errno` needs to be preserved.
|
|
*/
|
|
#define glnx_close_fd _glnx_clear_fd_ignore_error
|
|
|
|
/**
|
|
* glnx_fd_close:
|
|
*
|
|
* Deprecated in favor of `g_autofd`.
|
|
*/
|
|
#define glnx_fd_close g_autofd
|
|
/**
|
|
* glnx_autofd:
|
|
*
|
|
* Deprecated in favor of `g_autofd`.
|
|
*/
|
|
#define glnx_autofd g_autofd
|
|
|
|
G_END_DECLS
|