| 
									
										
										
										
											2007-11-26 16:13:05 +00:00
										 |  |  | /* GIO - GLib Input, Output and Streaming Library
 | 
					
						
							| 
									
										
										
										
											2008-09-02 19:05:58 +00:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2007-11-26 16:13:05 +00:00
										 |  |  |  * Copyright (C) 2006-2007 Red Hat, Inc. | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2022-05-18 09:12:45 +01:00
										 |  |  |  * SPDX-License-Identifier: LGPL-2.1-or-later | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2007-11-26 16:13:05 +00: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 16:13:05 +00: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 16:13:05 +00: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 16:01:59 +00:00
										 |  |  | #define G_TYPE_LOCAL_FILE_OUTPUT_STREAM         (_g_local_file_output_stream_get_type ())
 | 
					
						
							| 
									
										
										
										
											2007-11-26 16:13:05 +00: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 14:33:20 +00:00
										 |  |  |   GFileOutputStream parent_instance; | 
					
						
							| 
									
										
										
										
											2007-11-26 16:13:05 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  |   /*< private >*/ | 
					
						
							|  |  |  |   GLocalFileOutputStreamPrivate *priv; | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | struct _GLocalFileOutputStreamClass | 
					
						
							|  |  |  | { | 
					
						
							|  |  |  |   GFileOutputStreamClass parent_class; | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-09-02 19:05:58 +00: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 19:05:58 +00:00
										 |  |  | GFileOutputStream * _g_local_file_output_stream_create   (const char       *filename, | 
					
						
							| 
									
										
										
										
											2009-05-13 13:03:47 +02:00
										 |  |  | 							  gboolean          readable, | 
					
						
							| 
									
										
										
										
											2008-09-02 19:05:58 +00: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 07:28:01 +01:00
										 |  |  |                                                           GFileInfo        *reference_info, | 
					
						
							| 
									
										
										
										
											2008-09-02 19:05:58 +00: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 19:05:58 +00: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 07:28:01 +01:00
										 |  |  |                                                           GFileInfo        *reference_info, | 
					
						
							| 
									
										
										
										
											2008-09-02 19:05:58 +00:00
										 |  |  |                                                           GCancellable     *cancellable, | 
					
						
							|  |  |  |                                                           GError          **error); | 
					
						
							| 
									
										
										
										
											2007-11-26 16:13:05 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2010-05-20 10:51:00 -04: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 16:13:05 +00:00
										 |  |  | G_END_DECLS | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #endif /* __G_LOCAL_FILE_OUTPUT_STREAM_H__ */
 |