src/secure-save.h

   1 /*
   2  * Copyright (C) 2008 - 2016 The Geeqie Team
   3  *
   4  * Author: Laurent Monin
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License along
  17  * with this program; if not, write to the Free Software Foundation, Inc.,
  18  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19  */
  20
  21 #ifndef SECURE_SAVE_H
  22 #define SECURE_SAVE_H
  23
  24 #include <cstdio>
  25
  26 #include <glib.h>
  27
  28 /**
  29  * @enum SecureSaveErrno
  30  * see err field in #SecureSaveInfo
  31  */
  32 enum SecureSaveErrno {
  33         SS_ERR_NONE = 0,
  34         SS_ERR_DISABLED, /**< secsave is disabled. */
  35         SS_ERR_OUT_OF_MEM, /**< memory allocation failure */
  36
  37         SS_ERR_OPEN_READ,
  38         SS_ERR_OPEN_WRITE,
  39         SS_ERR_STAT,
  40         SS_ERR_ACCESS,
  41         SS_ERR_MKSTEMP,
  42         SS_ERR_RENAME,
  43         SS_ERR_OTHER,
  44 };
  45
  46 extern SecureSaveErrno secsave_errno; /**< internal secsave error number */
  47
  48 struct SecureSaveInfo {
  49         FILE *fp; /**< file stream pointer */
  50         gchar *file_name; /**< final file name */
  51         gchar *tmp_file_name; /**< temporary file name */
  52         gint err; /**< set to non-zero value in case of error */
  53         gboolean secure_save; /**< use secure save for this file, internal use only */
  54         gboolean preserve_perms; /**< whether to preserve perms, TRUE by default */
  55         gboolean preserve_mtime; /**< whether to preserve mtime, FALSE by default */
  56         gboolean unlink_on_error; /**< whether to remove temporary file on save failure, TRUE by default */
  57 };
  58
  59 SecureSaveInfo *secure_open(const gchar *);
  60
  61 gint secure_close(SecureSaveInfo *);
  62
  63 gint secure_fputs(SecureSaveInfo *, const gchar *);
  64 gint secure_fputc(SecureSaveInfo *, gint);
  65
  66 gint secure_fprintf(SecureSaveInfo *, const gchar *, ...);
  67 size_t secure_fwrite(gconstpointer ptr, size_t size, size_t nmemb, SecureSaveInfo *ssi);
  68
  69 gchar *secsave_strerror(SecureSaveErrno);
  70
  71 #endif /* SECURE_SAVE_H */
  72 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */