2007-11-26 17:13:05 +01:00
|
|
|
/* GIO - GLib Input, Output and Streaming Library
|
2008-09-02 21:05:58 +02:00
|
|
|
*
|
2007-11-26 17:13:05 +01:00
|
|
|
* Copyright (C) 2006-2007 Red Hat, Inc.
|
|
|
|
*
|
2022-05-18 10:12:45 +02:00
|
|
|
* SPDX-License-Identifier: LGPL-2.1-or-later
|
|
|
|
*
|
2007-11-26 17:13:05 +01:00
|
|
|
* 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
|
2017-05-27 18:21:30 +02:00
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
2007-11-26 17:13:05 +01:00
|
|
|
*
|
|
|
|
* 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
|
2014-01-23 12:58:29 +01:00
|
|
|
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
2007-11-26 17:13:05 +01:00
|
|
|
*
|
|
|
|
* Author: Alexander Larsson <alexl@redhat.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __G_LOCAL_FILE_OUTPUT_STREAM_H__
|
|
|
|
#define __G_LOCAL_FILE_OUTPUT_STREAM_H__
|
|
|
|
|
|
|
|
#include <gio/gfileoutputstream.h>
|
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2007-11-28 17:01:59 +01:00
|
|
|
#define G_TYPE_LOCAL_FILE_OUTPUT_STREAM (_g_local_file_output_stream_get_type ())
|
2007-11-26 17:13:05 +01:00
|
|
|
#define G_LOCAL_FILE_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_LOCAL_FILE_OUTPUT_STREAM, GLocalFileOutputStream))
|
|
|
|
#define G_LOCAL_FILE_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_LOCAL_FILE_OUTPUT_STREAM, GLocalFileOutputStreamClass))
|
|
|
|
#define G_IS_LOCAL_FILE_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_LOCAL_FILE_OUTPUT_STREAM))
|
|
|
|
#define G_IS_LOCAL_FILE_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_LOCAL_FILE_OUTPUT_STREAM))
|
|
|
|
#define G_LOCAL_FILE_OUTPUT_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_LOCAL_FILE_OUTPUT_STREAM, GLocalFileOutputStreamClass))
|
|
|
|
|
|
|
|
typedef struct _GLocalFileOutputStream GLocalFileOutputStream;
|
|
|
|
typedef struct _GLocalFileOutputStreamClass GLocalFileOutputStreamClass;
|
|
|
|
typedef struct _GLocalFileOutputStreamPrivate GLocalFileOutputStreamPrivate;
|
|
|
|
|
|
|
|
struct _GLocalFileOutputStream
|
|
|
|
{
|
2007-12-12 15:33:20 +01:00
|
|
|
GFileOutputStream parent_instance;
|
2007-11-26 17:13:05 +01:00
|
|
|
|
|
|
|
/*< private >*/
|
|
|
|
GLocalFileOutputStreamPrivate *priv;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _GLocalFileOutputStreamClass
|
|
|
|
{
|
|
|
|
GFileOutputStreamClass parent_class;
|
|
|
|
};
|
|
|
|
|
2008-09-02 21:05:58 +02:00
|
|
|
GType _g_local_file_output_stream_get_type (void) G_GNUC_CONST;
|
2009-05-13 13:03:47 +02:00
|
|
|
|
|
|
|
void _g_local_file_output_stream_set_do_close (GLocalFileOutputStream *out,
|
|
|
|
gboolean do_close);
|
|
|
|
gboolean _g_local_file_output_stream_really_close (GLocalFileOutputStream *out,
|
|
|
|
GCancellable *cancellable,
|
|
|
|
GError **error);
|
|
|
|
|
2011-12-08 23:17:07 +01:00
|
|
|
GFileOutputStream * _g_local_file_output_stream_new (int fd);
|
2009-05-13 13:03:47 +02:00
|
|
|
GFileOutputStream * _g_local_file_output_stream_open (const char *filename,
|
|
|
|
gboolean readable,
|
|
|
|
GCancellable *cancellable,
|
|
|
|
GError **error);
|
2008-09-02 21:05:58 +02:00
|
|
|
GFileOutputStream * _g_local_file_output_stream_create (const char *filename,
|
2009-05-13 13:03:47 +02:00
|
|
|
gboolean readable,
|
2008-09-02 21:05:58 +02:00
|
|
|
GFileCreateFlags flags,
|
Ensure g_file_copy() does not temporarily expose private files
Previously, g_file_copy() would (on Unix) create files with the
default mode of 644. For applications which might at user request
copy arbitrary private files such as ~/.ssh or /etc/shadow, a
world-readable copy would be temporarily exposed.
This patch is suboptimal in that it *only* fixes g_file_copy()
for the case where both source and destination are instances of
GLocalFile on Unix.
The reason for this is that the public GFile APIs for creating files
allow very limited control over the access permissions for the created
file; one can either say a file is "private" or not. Fixing
this by adding e.g. g_file_create_with_attributes() would make sense,
except this would entail 8 new API calls for all the variants of
_create(), _create_async(), _replace(), _replace_async(),
_create_readwrite(), _create_readwrite_async(), _replace_readwrite(),
_replace_readwrite_async(). That can be done as a separate patch
later.
https://bugzilla.gnome.org/show_bug.cgi?id=699959
2013-05-12 08:28:01 +02:00
|
|
|
GFileInfo *reference_info,
|
2008-09-02 21:05:58 +02:00
|
|
|
GCancellable *cancellable,
|
|
|
|
GError **error);
|
|
|
|
GFileOutputStream * _g_local_file_output_stream_append (const char *filename,
|
|
|
|
GFileCreateFlags flags,
|
|
|
|
GCancellable *cancellable,
|
|
|
|
GError **error);
|
|
|
|
GFileOutputStream * _g_local_file_output_stream_replace (const char *filename,
|
2009-05-13 13:03:47 +02:00
|
|
|
gboolean readable,
|
2008-09-02 21:05:58 +02:00
|
|
|
const char *etag,
|
|
|
|
gboolean create_backup,
|
|
|
|
GFileCreateFlags flags,
|
Ensure g_file_copy() does not temporarily expose private files
Previously, g_file_copy() would (on Unix) create files with the
default mode of 644. For applications which might at user request
copy arbitrary private files such as ~/.ssh or /etc/shadow, a
world-readable copy would be temporarily exposed.
This patch is suboptimal in that it *only* fixes g_file_copy()
for the case where both source and destination are instances of
GLocalFile on Unix.
The reason for this is that the public GFile APIs for creating files
allow very limited control over the access permissions for the created
file; one can either say a file is "private" or not. Fixing
this by adding e.g. g_file_create_with_attributes() would make sense,
except this would entail 8 new API calls for all the variants of
_create(), _create_async(), _replace(), _replace_async(),
_create_readwrite(), _create_readwrite_async(), _replace_readwrite(),
_replace_readwrite_async(). That can be done as a separate patch
later.
https://bugzilla.gnome.org/show_bug.cgi?id=699959
2013-05-12 08:28:01 +02:00
|
|
|
GFileInfo *reference_info,
|
2008-09-02 21:05:58 +02:00
|
|
|
GCancellable *cancellable,
|
|
|
|
GError **error);
|
2007-11-26 17:13:05 +01:00
|
|
|
|
2010-05-20 16:51:00 +02:00
|
|
|
/* Hack to get the fd since GFileDescriptorBased (which is how you
|
|
|
|
* _should_ get the fd) is only available on UNIX but things like
|
|
|
|
* win32 needs this as well
|
|
|
|
*/
|
|
|
|
gint _g_local_file_output_stream_get_fd (GLocalFileOutputStream *output_stream);
|
|
|
|
|
2007-11-26 17:13:05 +01:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
#endif /* __G_LOCAL_FILE_OUTPUT_STREAM_H__ */
|