gnome-control-center/archiver/location.h
Bradford Hovinen a18fd85bba Return NULL if the location id is NULL (archive_get_current_location_id):
2001-06-22  Bradford Hovinen  <hovinen@ximian.com>

	* archive.c (archive_get_current_location): Return NULL if the
	location id is NULL
	(archive_get_current_location_id): Return NULL if storing the
	snapshot results in an error

	* location.c (location_store): Add return values for error
	conditions; remove g_warning's and g_critical's
	(location_store_full_snapshot): Folded in store_snapshot_cb; don't
	call location_foreach_backend
	(location_store_full_snapshot): Return error condition; 0 on
	success, -1 if any backend failed

	* location-manager-dialog.c (location_manager_dialog_set_arg): Add
	a check to inform the user if the location manager was unable to
	form an initial configuration snapshot
2001-06-22 16:34:57 +00:00

150 lines
4.4 KiB
C

/* -*- mode: c; style: linux -*- */
/* location.h
* Copyright (C) 2000-2001 Ximian, Inc.
*
* Written by Bradford Hovinen (hovinen@ximian.com)
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2, or (at your option)
* any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
* 02111-1307, USA.
*/
#ifndef __LOCATION_H
#define __LOCATION_H
#include <gnome.h>
#include <tree.h>
#include "config-log.h"
#define LOCATION(obj) GTK_CHECK_CAST (obj, location_get_type (), Location)
#define LOCATION_CLASS(klass) GTK_CHECK_CLASS_CAST (klass, location_get_type (), LocationClass)
#define IS_LOCATION(obj) GTK_CHECK_TYPE (obj, location_get_type ())
typedef struct _LocationClass LocationClass;
typedef struct _LocationPrivate LocationPrivate;
typedef struct _Archive Archive;
typedef enum _ContainmentType ContainmentType;
typedef enum _StoreType StoreType;
typedef int (*LocationBackendCB) (Location *, gchar *, gpointer);
struct _Location
{
GtkObject object;
LocationPrivate *p;
};
struct _LocationClass
{
GtkObjectClass parent;
gboolean (*do_rollback) (Location *location,
gchar *backend_id,
xmlDocPtr xml_doc);
};
enum _ContainmentType
{
CONTAIN_NONE, CONTAIN_PARTIAL, CONTAIN_FULL
};
enum _StoreType
{
STORE_DEFAULT, STORE_FULL, STORE_COMPARE_PARENT, STORE_MASK_PREVIOUS
};
guint location_get_type (void);
GtkObject *location_new (Archive *archive,
const gchar *locid,
Location *inherits);
GtkObject *location_open (Archive *archive,
const gchar *locid);
void location_close (Location *location);
void location_delete (Location *location);
gint location_store (Location *location,
gchar *backend_id,
FILE *input,
StoreType store_type);
void location_store_xml (Location *location,
gchar *backend_id,
xmlDocPtr xml_doc,
StoreType store_type);
void location_rollback_backend_to (Location *location,
struct tm *date,
gchar *backend_id,
gboolean parent_chain);
void location_rollback_backends_to (Location *location,
struct tm *date,
GList *backends,
gboolean parent_chain);
void location_rollback_all_to (Location *location,
struct tm *date,
gboolean parent_chain);
void location_rollback_backend_by (Location *location,
guint steps,
gchar *backend_id,
gboolean parent_chain);
void location_rollback_id (Location *location,
gint id);
void location_dump_rollback_data (Location *location,
struct tm *date,
guint steps,
gchar *backend_id,
gboolean parent_chain,
FILE *output);
xmlDocPtr location_load_rollback_data (Location *location,
struct tm *date,
guint steps,
gchar *backend_id,
gboolean parent_chain);
ContainmentType location_contains (Location *location, gchar *backend_id);
gint location_add_backend (Location *location, gchar *backend_id,
ContainmentType type);
void location_remove_backend (Location *location, gchar *backend_id);
void location_foreach_backend (Location *location,
LocationBackendCB callback,
gpointer data);
GList *location_find_path_from_common_parent (Location *location,
Location *location2);
Location *location_get_parent (Location *location);
const gchar *location_get_path (Location *location);
const gchar *location_get_label (Location *location);
const gchar *location_get_id (Location *location);
void location_set_id (Location *location, const gchar *locid);
gint location_store_full_snapshot (Location *location);
GList *location_get_changed_backends (Location *location,
Location *location1);
gboolean location_does_backend_change (Location *location,
Location *location1,
gchar *backend_id);
#endif /* __LOCATION */