hook gvariant vectors up to kdbus
[platform/upstream/glib.git] / glib / gstdio.h
index 8dbe4af..7601f5e 100644 (file)
@@ -14,8 +14,7 @@
  *
  * You should have received a copy of the GNU Lesser General Public
  * License along with GLib; see the file COPYING.LIB.  If not,
- * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * see <http://www.gnu.org/licenses/>.
  */
 
 #ifndef __G_STDIO_H__
 
 G_BEGIN_DECLS
 
+#if defined (_MSC_VER) && !defined(_WIN64)
+
+/* Make it clear that we mean the struct with 32-bit st_size and
+ * 32-bit st_*time fields as that is how the 32-bit GLib DLL normally
+ * has been compiled. If you get a compiler warning when calling
+ * g_stat(), do take it seriously and make sure that the type of
+ * struct stat the code in GLib fills in matches the struct the type
+ * of struct stat you pass to g_stat(). To avoid hassle, to get file
+ * attributes just use the GIO API instead which doesn't use struct
+ * stat.
+ *
+ * Sure, it would be nicer to use a struct with 64-bit st_size and
+ * 64-bit st_*time fields, but changing that now would break ABI. And
+ * in MinGW, a plain "struct stat" is the one with 32-bit st_size and
+ * st_*time fields.
+ */
+
+typedef struct _stat32 GStatBuf;
+
+#else
+
+typedef struct stat GStatBuf;
+
+#endif
+
 #if defined(G_OS_UNIX) && !defined(G_STDIO_NO_WRAP_ON_UNIX)
 
 /* Just pass on to the system functions, so there's no potential for data
  * format mismatches, especially with large file interfaces. 
- * rmdir() can't be handled in this way, since it is not defined in 
- * a portable system header that we could include here.
+ * A few functions can't be handled in this way, since they are not defined
+ * in a portable system header that we could include here.
  */
 
-#define g_access  access
+#ifndef __GTK_DOC_IGNORE__
 #define g_chmod   chmod
 #define g_open    open
 #define g_creat   creat
 #define g_rename  rename
 #define g_mkdir   mkdir
-#define g_chdir   chdir
 #define g_stat    stat
 #define g_lstat   lstat
-#define g_unlink  unlink
 #define g_remove  remove
 #define g_fopen   fopen
 #define g_freopen freopen
+#define g_utime   utime
+#endif
+
+GLIB_AVAILABLE_IN_ALL
+int g_access (const gchar *filename,
+             int          mode);
+
+GLIB_AVAILABLE_IN_ALL
+int g_chdir  (const gchar *path);
+
+GLIB_AVAILABLE_IN_ALL
+int g_unlink (const gchar *filename);
 
-int g_rmdir (const gchar *filename);
+GLIB_AVAILABLE_IN_ALL
+int g_rmdir  (const gchar *filename);
 
 #else /* ! G_OS_UNIX */
 
@@ -57,54 +92,80 @@ int g_rmdir (const gchar *filename);
  * Unix, the pathname is a file name as it literally is in the file
  * system. On well-maintained systems with consistent users who know
  * what they are doing and no exchange of files with others this would
- * be a well-defined encoding, preferrably UTF-8. On Windows, the
+ * be a well-defined encoding, preferably UTF-8. On Windows, the
  * pathname is always in UTF-8, even if that is not the on-disk
  * encoding, and not the encoding accepted by the C library or Win32
  * API.
  */
 
+GLIB_AVAILABLE_IN_ALL
 int g_access    (const gchar *filename,
                 int          mode);
 
+GLIB_AVAILABLE_IN_ALL
 int g_chmod     (const gchar *filename,
                 int          mode);
 
+GLIB_AVAILABLE_IN_ALL
 int g_open      (const gchar *filename,
                  int          flags,
                  int          mode);
 
+GLIB_AVAILABLE_IN_ALL
 int g_creat     (const gchar *filename,
                  int          mode);
 
+GLIB_AVAILABLE_IN_ALL
 int g_rename    (const gchar *oldfilename,
                  const gchar *newfilename);
 
+GLIB_AVAILABLE_IN_ALL
 int g_mkdir     (const gchar *filename,
                  int          mode);
 
+GLIB_AVAILABLE_IN_ALL
 int g_chdir     (const gchar *path);
 
+GLIB_AVAILABLE_IN_ALL
 int g_stat      (const gchar *filename,
-                 struct stat *buf);
+                 GStatBuf    *buf);
 
+GLIB_AVAILABLE_IN_ALL
 int g_lstat     (const gchar *filename,
-                 struct stat *buf);
+                 GStatBuf    *buf);
 
+GLIB_AVAILABLE_IN_ALL
 int g_unlink    (const gchar *filename);
 
+GLIB_AVAILABLE_IN_ALL
 int g_remove    (const gchar *filename);
 
+GLIB_AVAILABLE_IN_ALL
 int g_rmdir     (const gchar *filename);
 
+GLIB_AVAILABLE_IN_ALL
 FILE *g_fopen   (const gchar *filename,
                  const gchar *mode);
 
+GLIB_AVAILABLE_IN_ALL
 FILE *g_freopen (const gchar *filename,
                  const gchar *mode,
                  FILE        *stream);
 
+struct utimbuf;                        /* Don't need the real definition of struct utimbuf when just
+                                * including this header.
+                                */
+
+GLIB_AVAILABLE_IN_ALL
+int g_utime     (const gchar    *filename,
+                struct utimbuf *utb);
+
 #endif /* G_OS_UNIX */
 
+GLIB_AVAILABLE_IN_2_36
+gboolean g_close (gint       fd,
+                  GError   **error);
+
 G_END_DECLS
 
 #endif /* __G_STDIO_H__ */