path: root/lib/ephy-file-helpers.h

/*
 *  Copyright © 2002 Jorn Baayen
 *  Copyright © 2003, 2004 Marco Pesenti Gritti
 *  Copyright © 2004, 2005, 2006 Christian Persch
 *
 *  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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 *  $Id$
 */

#ifndef EPHY_FILE_HELPERS_H
#define EPHY_FILE_HELPERS_H

#include <glib.h>
#include <libgnomevfs/gnome-vfs-mime-handlers.h>
#include <libgnomevfs/gnome-vfs-ops.h>

extern GQuark ephy_file_helpers_error_quark;
#define EPHY_FILE_HELPERS_ERROR_QUARK   (ephy_file_helpers_error_quark)

G_BEGIN_DECLS

typedef enum
{
    EPHY_MIME_PERMISSION_SAFE   = 1,
    EPHY_MIME_PERMISSION_UNSAFE = 2,
    EPHY_MIME_PERMISSION_UNKNOWN    = 3
} EphyMimePermission;

typedef struct _EphyFileMonitor EphyFileMonitor;
typedef void (* EphyFileMonitorFunc) (EphyFileMonitor*, const char*, GnomeVFSMonitorEventType, gpointer);
typedef gboolean (* EphyFileMonitorDelayFunc) (EphyFileMonitor*, gpointer);

gboolean    ephy_file_helpers_init       (const char *profile_dir,
                      gboolean private_profile,
                      gboolean keep_temp_dir,
                      GError **error);

const char *ephy_file                    (const char *filename);

const char *ephy_dot_dir                 (void);

void        ephy_file_helpers_shutdown   (void);

char       *ephy_file_downloads_dir      (void);

char       *ephy_file_get_downloads_dir  (void);

char       *ephy_file_desktop_dir    (void);

const char *ephy_file_tmp_dir        (void);

char       *ephy_file_tmp_filename   (const char *base,
                      const char *extension);

gboolean    ephy_ensure_dir_exists       (const char *dir,
                      GError **);

GSList     *ephy_file_find               (const char *path,
                          const char *fname,
                          gint maxdepth);

gboolean    ephy_file_switch_temp_file   (const char *filename,
                      const char *filename_temp);

void        ephy_file_delete_on_exit     (const char *path);

EphyMimePermission ephy_file_check_mime  (const char *mime_type);

gboolean    ephy_file_launch_desktop_file (const char *filename,
                       const char *parameter,
                       guint32 user_time);

gboolean    ephy_file_launch_application (GnomeVFSMimeApplication *application,
                      const char *parameter,
                      guint32 user_time);

gboolean    ephy_file_launch_handler     (const char *mime_type,
                      const char *address,
                      guint32 user_time);

gboolean    ephy_file_browse_to      (const char *parameter,
                      guint32 user_time);

EphyFileMonitor *ephy_file_monitor_add   (const char *uri,
                      GnomeVFSMonitorType monitor_type,
                      guint delay,
                      EphyFileMonitorFunc callback,
                      EphyFileMonitorDelayFunc delay_func,
                      gpointer user_data);

void       ephy_file_monitor_cancel  (EphyFileMonitor *monitor);

void       ephy_file_delete_directory    (const char *path);

G_END_DECLS

#endif /* EPHY_FILE_HELPERS_H */