mirror of
https://github.com/flatpak/flatpak.git
synced 2026-03-27 19:33:06 -04:00
2aed100945
This makes the flatpak project more self-contained, and would have avoided the problems we encountered with unintended changes in the 1.14.7 release. See <https://diziet.dreamwidth.org/14666.html> for an opinionated description of some of the problems with submodules. If we can eliminate submodules altogether, then it will become possible to build Flatpak from a simple `git clone` or `git archive`, or from the source tarballs auto-generated by Github (which are equivalent to a `git archive`), without needing an extra step to populate the submodules. As well as reducing the support burden from users periodically complaining that our source releases are incomplete, this is a useful "nothing up my sleeve" mechanism to make it easy to verify that our source releases do not contain malicious changes hidden in vendored or generated files, like the one that made CVE-2024-3094 possible. Added with: git remote add --no-tags libglnx https://gitlab.gnome.org/GNOME/libglnx.git git fetch libglnx git subtree add -P subprojects/libglnx202b294e60git commit --amend -s To compare with upstream: git remote add --no-tags libglnx https://gitlab.gnome.org/GNOME/libglnx.git git fetch libglnx git diff HEAD:subprojects/libglnx libglnx/master After checking the diff, updates can be merged into this project with: git subtree merge -P subprojects/libglnx libglnx/master git commit --amend -s The commit merged here is the same one that was previously a submodule. A subsequent commit will update it to the latest version of libglnx, demonstrating how to review such updates. git-subtree-dir: subprojects/libglnx git-subtree-mainline: 7df25d63dfde9b4755479950f5b87bafe85cd277 git-subtree-split:202b294e60Signed-off-by: Simon McVittie <smcv@collabora.com>
74 lines
2.6 KiB
C
74 lines
2.6 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.
|
|
*/
|
|
|
|
#include "libglnx-config.h"
|
|
|
|
#include "glnx-local-alloc.h"
|
|
|
|
/**
|
|
* SECTION:glnxlocalalloc
|
|
* @title: GLnx local allocation
|
|
* @short_description: Release local variables automatically when they go out of scope
|
|
*
|
|
* These macros leverage the GCC extension __attribute__ ((cleanup))
|
|
* to allow calling a cleanup function such as g_free() when a
|
|
* variable goes out of scope. See <ulink
|
|
* url="http://gcc.gnu.org/onlinedocs/gcc/Variable-Attributes.html">
|
|
* for more information on the attribute.
|
|
*
|
|
* The provided macros make it easy to use the cleanup attribute for
|
|
* types that come with GLib. The primary two are #glnx_free and
|
|
* #glnx_unref_object, which correspond to g_free() and
|
|
* g_object_unref(), respectively.
|
|
*
|
|
* The rationale behind this is that particularly when handling error
|
|
* paths, it can be very tricky to ensure the right variables are
|
|
* freed. With this, one simply applies glnx_unref_object to a
|
|
* locally-allocated #GFile for example, and it will be automatically
|
|
* unreferenced when it goes out of scope.
|
|
*
|
|
* Note - you should only use these macros for <emphasis>stack
|
|
* allocated</emphasis> variables. They don't provide garbage
|
|
* collection or let you avoid freeing things. They're simply a
|
|
* compiler assisted deterministic mechanism for calling a cleanup
|
|
* function when a stack frame ends.
|
|
*
|
|
* <example id="gs-lfree"><title>Calling g_free automatically</title>
|
|
* <programlisting>
|
|
*
|
|
* GFile *
|
|
* create_file (GError **error)
|
|
* {
|
|
* glnx_free char *random_id = NULL;
|
|
*
|
|
* if (!prepare_file (error))
|
|
* return NULL;
|
|
*
|
|
* random_id = alloc_random_id ();
|
|
*
|
|
* return create_file_real (error);
|
|
* // Note that random_id is freed here automatically
|
|
* }
|
|
* </programlisting>
|
|
* </example>
|
|
*
|
|
*/
|