2000-09-28 03:16:29 +00:00
|
|
|
/* filesystem.h
|
|
|
|
* Filesystem utility definitions
|
|
|
|
*
|
2006-05-21 05:12:17 +00:00
|
|
|
* Wireshark - Network traffic analyzer
|
|
|
|
* By Gerald Combs <gerald@wireshark.org>
|
2000-09-28 03:16:29 +00:00
|
|
|
* Copyright 1998 Gerald Combs
|
2002-08-28 20:41:00 +00:00
|
|
|
*
|
2000-09-28 03:16:29 +00:00
|
|
|
* 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
|
|
|
|
* of the License, or (at your option) any later version.
|
2002-08-28 20:41:00 +00:00
|
|
|
*
|
2000-09-28 03:16:29 +00:00
|
|
|
* 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.
|
2002-08-28 20:41:00 +00:00
|
|
|
*
|
2000-09-28 03:16:29 +00:00
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
2012-06-28 22:56:06 +00:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
2000-09-28 03:16:29 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef FILESYSTEM_H
|
|
|
|
#define FILESYSTEM_H
|
|
|
|
|
2013-03-01 23:53:11 +00:00
|
|
|
#include "ws_symbol_export.h"
|
2017-09-05 16:18:00 +00:00
|
|
|
#include "ws_attributes.h"
|
2013-03-01 23:53:11 +00:00
|
|
|
|
2010-12-01 18:25:18 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
2008-01-24 17:06:22 +00:00
|
|
|
/*
|
|
|
|
* Default profile name.
|
|
|
|
*/
|
|
|
|
#define DEFAULT_PROFILE "Default"
|
|
|
|
|
|
|
|
|
Add a routine to attempt to get the absolute pathname of the executable
file, strip off the last component to get the pathname of the directory
containing the executable file, and save it for future use. On Windows,
you can get that from the OS, but, on UN*X, you have to look at argv[0]
and derive the absolute path from that (argv[0] is not guaranteed to be
an absolute path, or even a path at all). (In addition, if you're
running from the build directory, you might have to strip off a ".libs/"
added to argv[0] as an artifact of the libtoolizing script.)
Use that in the About dialog, and use it to construct the path of
dumpcap.
Don't put quotes into the path of dumpcap; you don't have to quote
strings with spaces in them when handing them to execvp and, in fact,
you *mustn't* quote them, as the quotes will be treated as part of the
pathname.
svn path=/trunk/; revision=17267
2006-02-12 03:15:29 +00:00
|
|
|
/*
|
|
|
|
* Get the pathname of the directory from which the executable came,
|
2006-05-01 06:51:14 +00:00
|
|
|
* and save it for future use. Returns NULL on success, and a
|
|
|
|
* g_mallocated string containing an error on failure.
|
Add a routine to attempt to get the absolute pathname of the executable
file, strip off the last component to get the pathname of the directory
containing the executable file, and save it for future use. On Windows,
you can get that from the OS, but, on UN*X, you have to look at argv[0]
and derive the absolute path from that (argv[0] is not guaranteed to be
an absolute path, or even a path at all). (In addition, if you're
running from the build directory, you might have to strip off a ".libs/"
added to argv[0] as an artifact of the libtoolizing script.)
Use that in the About dialog, and use it to construct the path of
dumpcap.
Don't put quotes into the path of dumpcap; you don't have to quote
strings with spaces in them when handing them to execvp and, in fact,
you *mustn't* quote them, as the quotes will be treated as part of the
pathname.
svn path=/trunk/; revision=17267
2006-02-12 03:15:29 +00:00
|
|
|
*/
|
2015-12-12 02:34:47 +00:00
|
|
|
WS_DLL_PUBLIC char *init_progfile_dir(const char *arg0, int (*function_addr)(int, char **));
|
Add a routine to attempt to get the absolute pathname of the executable
file, strip off the last component to get the pathname of the directory
containing the executable file, and save it for future use. On Windows,
you can get that from the OS, but, on UN*X, you have to look at argv[0]
and derive the absolute path from that (argv[0] is not guaranteed to be
an absolute path, or even a path at all). (In addition, if you're
running from the build directory, you might have to strip off a ".libs/"
added to argv[0] as an artifact of the libtoolizing script.)
Use that in the About dialog, and use it to construct the path of
dumpcap.
Don't put quotes into the path of dumpcap; you don't have to quote
strings with spaces in them when handing them to execvp and, in fact,
you *mustn't* quote them, as the quotes will be treated as part of the
pathname.
svn path=/trunk/; revision=17267
2006-02-12 03:15:29 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Get the directory in which the program resides.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_progfile_dir(void);
|
2002-06-23 21:33:09 +00:00
|
|
|
|
Add a WIRESHARK_RUN_FROM_BUILD_DIRECTORY environment variable on UN*X;
if set, and if the program isn't running with additional privileges,
it'll treat the directory in which the program is found as the data
directory.
If, on Windows, the version-number subdirectory of {data
directory}\plugins doesn't exist (which is assumed to mean that the
program is being run from the build directory), or if, on UN*X,
WIRESHARK_RUN_FROM_BUILD_DIRECTORY is set, the plugin directory is the
"plugins" subdirectory of the data directory, and all subdirectories of
that directory are scanned for plugins, as the "plugins" subdirectory of
the build directory contains subdirectories for the plugins; this means
that if we're running from the build directory, we'll find the plugins
we built in the build tree.
When generating the wireshark-filter man page, run tshark with
WIRESHARK_RUN_FROM_BUILD_DIRECTORY set, so it uses the plugins from the
build to generate the list of filters.
svn path=/trunk/; revision=20261
2007-01-02 06:49:40 +00:00
|
|
|
/*
|
2007-05-25 20:03:26 +00:00
|
|
|
* Get the directory in which plugins are stored; this must not be called
|
|
|
|
* before init_progfile_dir() is called, as they might be stored in a
|
|
|
|
* subdirectory of the program file directory.
|
Add a WIRESHARK_RUN_FROM_BUILD_DIRECTORY environment variable on UN*X;
if set, and if the program isn't running with additional privileges,
it'll treat the directory in which the program is found as the data
directory.
If, on Windows, the version-number subdirectory of {data
directory}\plugins doesn't exist (which is assumed to mean that the
program is being run from the build directory), or if, on UN*X,
WIRESHARK_RUN_FROM_BUILD_DIRECTORY is set, the plugin directory is the
"plugins" subdirectory of the data directory, and all subdirectories of
that directory are scanned for plugins, as the "plugins" subdirectory of
the build directory contains subdirectories for the plugins; this means
that if we're running from the build directory, we'll find the plugins
we built in the build tree.
When generating the wireshark-filter man page, run tshark with
WIRESHARK_RUN_FROM_BUILD_DIRECTORY set, so it uses the plugins from the
build to generate the list of filters.
svn path=/trunk/; revision=20261
2007-01-02 06:49:40 +00:00
|
|
|
*/
|
2017-09-18 14:45:17 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_plugins_dir(void);
|
Add a WIRESHARK_RUN_FROM_BUILD_DIRECTORY environment variable on UN*X;
if set, and if the program isn't running with additional privileges,
it'll treat the directory in which the program is found as the data
directory.
If, on Windows, the version-number subdirectory of {data
directory}\plugins doesn't exist (which is assumed to mean that the
program is being run from the build directory), or if, on UN*X,
WIRESHARK_RUN_FROM_BUILD_DIRECTORY is set, the plugin directory is the
"plugins" subdirectory of the data directory, and all subdirectories of
that directory are scanned for plugins, as the "plugins" subdirectory of
the build directory contains subdirectories for the plugins; this means
that if we're running from the build directory, we'll find the plugins
we built in the build tree.
When generating the wireshark-filter man page, run tshark with
WIRESHARK_RUN_FROM_BUILD_DIRECTORY set, so it uses the plugins from the
build to generate the list of filters.
svn path=/trunk/; revision=20261
2007-01-02 06:49:40 +00:00
|
|
|
|
2017-09-18 15:25:20 +00:00
|
|
|
/*
|
|
|
|
* Append VERSION_MAJOR.VERSION_MINOR to the plugin dir.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC const char *get_plugins_dir_with_version(void);
|
|
|
|
|
2017-09-10 22:38:36 +00:00
|
|
|
/*
|
|
|
|
* Get the personal plugin dir.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC const char *get_plugins_pers_dir(void);
|
|
|
|
|
2017-09-18 15:25:20 +00:00
|
|
|
/*
|
|
|
|
* Append VERSION_MAJOR.VERSION_MINOR to the plugin personal dir.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC const char *get_plugins_pers_dir_with_version(void);
|
|
|
|
|
2014-02-25 13:05:11 +00:00
|
|
|
/*
|
|
|
|
* Get the directory in which extcap hooks are stored; this must not be called
|
|
|
|
* before init_progfile_dir() is called, as they might be stored in a
|
|
|
|
* subdirectory of the program file directory.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC const char *get_extcap_dir(void);
|
|
|
|
|
Add a WIRESHARK_RUN_FROM_BUILD_DIRECTORY environment variable on UN*X;
if set, and if the program isn't running with additional privileges,
it'll treat the directory in which the program is found as the data
directory.
If, on Windows, the version-number subdirectory of {data
directory}\plugins doesn't exist (which is assumed to mean that the
program is being run from the build directory), or if, on UN*X,
WIRESHARK_RUN_FROM_BUILD_DIRECTORY is set, the plugin directory is the
"plugins" subdirectory of the data directory, and all subdirectories of
that directory are scanned for plugins, as the "plugins" subdirectory of
the build directory contains subdirectories for the plugins; this means
that if we're running from the build directory, we'll find the plugins
we built in the build tree.
When generating the wireshark-filter man page, run tshark with
WIRESHARK_RUN_FROM_BUILD_DIRECTORY set, so it uses the plugins from the
build to generate the list of filters.
svn path=/trunk/; revision=20261
2007-01-02 06:49:40 +00:00
|
|
|
/*
|
|
|
|
* Get the flag indicating whether we're running from a build
|
|
|
|
* directory.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean running_in_build_directory(void);
|
Add a WIRESHARK_RUN_FROM_BUILD_DIRECTORY environment variable on UN*X;
if set, and if the program isn't running with additional privileges,
it'll treat the directory in which the program is found as the data
directory.
If, on Windows, the version-number subdirectory of {data
directory}\plugins doesn't exist (which is assumed to mean that the
program is being run from the build directory), or if, on UN*X,
WIRESHARK_RUN_FROM_BUILD_DIRECTORY is set, the plugin directory is the
"plugins" subdirectory of the data directory, and all subdirectories of
that directory are scanned for plugins, as the "plugins" subdirectory of
the build directory contains subdirectories for the plugins; this means
that if we're running from the build directory, we'll find the plugins
we built in the build tree.
When generating the wireshark-filter man page, run tshark with
WIRESHARK_RUN_FROM_BUILD_DIRECTORY set, so it uses the plugins from the
build to generate the list of filters.
svn path=/trunk/; revision=20261
2007-01-02 06:49:40 +00:00
|
|
|
|
2007-01-14 22:25:22 +00:00
|
|
|
/*
|
|
|
|
* Get the directory in which global configuration files are
|
|
|
|
* stored.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_datafile_dir(void);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
2003-05-15 07:44:54 +00:00
|
|
|
/*
|
|
|
|
* Construct the path name of a global configuration file, given the
|
|
|
|
* file name.
|
2008-02-26 18:58:12 +00:00
|
|
|
*
|
|
|
|
* The returned file name was g_malloc()'d so it must be g_free()d when the
|
|
|
|
* caller is done with it.
|
2003-05-15 07:44:54 +00:00
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC char *get_datafile_path(const char *filename);
|
2003-05-15 07:44:54 +00:00
|
|
|
|
2001-10-21 21:48:00 +00:00
|
|
|
/*
|
|
|
|
* Get the directory in which files that, at least on UNIX, are
|
|
|
|
* system files (such as "/etc/ethers") are stored; on Windows,
|
2006-05-28 19:49:07 +00:00
|
|
|
* there's no "/etc" directory, so we get them from the Wireshark
|
2001-10-21 21:48:00 +00:00
|
|
|
* global configuration and data file directory.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_systemfile_dir(void);
|
2001-10-21 21:48:00 +00:00
|
|
|
|
2008-01-14 16:40:23 +00:00
|
|
|
/*
|
2010-12-07 20:24:57 +00:00
|
|
|
* Set the configuration profile name to be used for storing
|
2008-01-14 16:40:23 +00:00
|
|
|
* personal configuration files.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC void set_profile_name(const gchar *profilename);
|
2008-01-14 16:40:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Get the current configuration profile name used for storing
|
|
|
|
* personal configuration files.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_profile_name(void);
|
2008-01-14 16:40:23 +00:00
|
|
|
|
2010-10-01 16:29:37 +00:00
|
|
|
/*
|
|
|
|
* Check if current profile is default profile.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean is_default_profile(void);
|
2010-10-01 16:29:37 +00:00
|
|
|
|
2011-02-26 17:23:24 +00:00
|
|
|
/*
|
|
|
|
* Check if we have global profiles.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean has_global_profiles(void);
|
2011-02-26 17:23:24 +00:00
|
|
|
|
2008-01-14 16:40:23 +00:00
|
|
|
/*
|
|
|
|
* Get the directory used to store configuration profile directories.
|
2017-02-18 15:46:24 +00:00
|
|
|
* Caller must free the returned string
|
2008-01-14 16:40:23 +00:00
|
|
|
*/
|
2017-02-18 15:46:24 +00:00
|
|
|
WS_DLL_PUBLIC char *get_profiles_dir(void);
|
2008-01-14 16:40:23 +00:00
|
|
|
|
2017-06-20 19:12:48 +00:00
|
|
|
/*
|
|
|
|
* Create the directory used to store configuration profile directories.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC int create_profiles_dir(char **pf_dir_path_return);
|
|
|
|
|
2011-02-26 17:23:24 +00:00
|
|
|
/*
|
|
|
|
* Get the directory used to store global configuration profile directories.
|
2017-02-18 15:46:24 +00:00
|
|
|
* Caller must free the returned string
|
2011-02-26 17:23:24 +00:00
|
|
|
*/
|
2017-02-18 15:46:24 +00:00
|
|
|
WS_DLL_PUBLIC char *get_global_profiles_dir(void);
|
2011-02-26 17:23:24 +00:00
|
|
|
|
|
|
|
|
2009-12-21 12:32:31 +00:00
|
|
|
/*
|
|
|
|
* Store filenames used for personal config files so we know which
|
|
|
|
* files to copy when duplicate a configuration profile.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC void profile_store_persconffiles(gboolean store);
|
2009-12-21 12:32:31 +00:00
|
|
|
|
2008-01-14 16:40:23 +00:00
|
|
|
/*
|
|
|
|
* Check if given configuration profile exists.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean profile_exists(const gchar *profilename, gboolean global);
|
2008-01-14 16:40:23 +00:00
|
|
|
|
2010-12-07 20:24:57 +00:00
|
|
|
/*
|
2008-01-14 16:40:23 +00:00
|
|
|
* Create a directory for the given configuration profile.
|
|
|
|
* If we attempted to create it, and failed, return -1 and
|
|
|
|
* set "*pf_dir_path_return" to the pathname of the directory we failed
|
|
|
|
* to create (it's g_mallocated, so our caller should free it); otherwise,
|
|
|
|
* return 0.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int create_persconffile_profile(const char *profilename,
|
2008-01-14 16:40:23 +00:00
|
|
|
char **pf_dir_path_return);
|
|
|
|
|
2010-12-07 20:24:57 +00:00
|
|
|
/*
|
2008-01-14 16:40:23 +00:00
|
|
|
* Delete the directory for the given configuration profile.
|
|
|
|
* If we attempted to delete it, and failed, return -1 and
|
|
|
|
* set "*pf_dir_path_return" to the pathname of the directory we failed
|
|
|
|
* to delete (it's g_mallocated, so our caller should free it); otherwise,
|
|
|
|
* return 0.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int delete_persconffile_profile(const char *profilename,
|
2008-01-14 16:40:23 +00:00
|
|
|
char **pf_dir_path_return);
|
|
|
|
|
2010-12-07 20:24:57 +00:00
|
|
|
/*
|
2008-01-14 16:40:23 +00:00
|
|
|
* Rename the directory for the given confinguration profile.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int rename_persconffile_profile(const char *fromname, const char *toname,
|
2010-12-07 20:24:57 +00:00
|
|
|
char **pf_from_dir_path_return,
|
2008-01-14 16:40:23 +00:00
|
|
|
char **pf_to_dir_path_return);
|
|
|
|
|
2010-12-07 20:24:57 +00:00
|
|
|
/*
|
2009-12-21 12:32:31 +00:00
|
|
|
* Copy files in one profile to the other.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int copy_persconffile_profile(const char *toname, const char *fromname,
|
2011-02-26 17:23:24 +00:00
|
|
|
gboolean from_global,
|
2009-12-21 12:32:31 +00:00
|
|
|
char **pf_filename_return,
|
|
|
|
char **pf_to_dir_path_return,
|
|
|
|
char **pf_from_dir_path_return);
|
|
|
|
|
2001-10-23 05:01:02 +00:00
|
|
|
/*
|
|
|
|
* Create the directory that holds personal configuration files, if
|
|
|
|
* necessary. If we attempted to create it, and failed, return -1 and
|
2001-10-24 06:13:07 +00:00
|
|
|
* set "*pf_dir_path_return" to the pathname of the directory we failed
|
|
|
|
* to create (it's g_mallocated, so our caller should free it); otherwise,
|
2001-10-23 05:01:02 +00:00
|
|
|
* return 0.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int create_persconffile_dir(char **pf_dir_path_return);
|
2001-10-23 05:01:02 +00:00
|
|
|
|
2001-10-24 07:18:39 +00:00
|
|
|
/*
|
|
|
|
* Construct the path name of a personal configuration file, given the
|
2008-01-14 16:40:23 +00:00
|
|
|
* file name. If using configuration profiles this directory will be
|
|
|
|
* used if "from_profile" is TRUE.
|
2001-10-24 07:18:39 +00:00
|
|
|
*
|
2008-02-26 18:58:12 +00:00
|
|
|
* The returned file name was g_malloc()'d so it must be g_free()d when the
|
|
|
|
* caller is done with it.
|
2001-10-24 07:18:39 +00:00
|
|
|
*/
|
2013-04-09 02:48:03 +00:00
|
|
|
WS_DLL_PUBLIC char *get_persconffile_path(const char *filename, gboolean from_profile);
|
2001-10-24 07:18:39 +00:00
|
|
|
|
2013-11-19 19:45:38 +00:00
|
|
|
/*
|
|
|
|
* Set the path of the personal configuration file directory.
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC void set_persconffile_dir(const char *p);
|
|
|
|
|
2007-01-14 22:25:22 +00:00
|
|
|
/*
|
|
|
|
* Get the (default) directory in which personal data is stored.
|
|
|
|
*
|
|
|
|
* On Win32, this is the "My Documents" folder in the personal profile.
|
|
|
|
* On UNIX this is simply the current directory.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_persdatafile_dir(void);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
2010-12-07 20:24:57 +00:00
|
|
|
/*
|
2013-11-19 19:45:38 +00:00
|
|
|
* Set the path of the directory in which personal data is stored.
|
2007-03-14 02:55:54 +00:00
|
|
|
*/
|
2013-11-19 19:45:38 +00:00
|
|
|
WS_DLL_PUBLIC void set_persdatafile_dir(const char *p);
|
2007-03-14 02:55:54 +00:00
|
|
|
|
2004-01-24 01:44:29 +00:00
|
|
|
/*
|
2004-01-24 02:01:44 +00:00
|
|
|
* Return an error message for UNIX-style errno indications on open or
|
|
|
|
* create operations.
|
2004-01-24 01:44:29 +00:00
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *file_open_error_message(int err, gboolean for_writing);
|
2004-01-24 01:44:29 +00:00
|
|
|
|
2004-01-24 02:01:44 +00:00
|
|
|
/*
|
|
|
|
* Return an error message for UNIX-style errno indications on write
|
|
|
|
* operations.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *file_write_error_message(int err);
|
2004-01-24 02:01:44 +00:00
|
|
|
|
2007-01-14 22:25:22 +00:00
|
|
|
/*
|
|
|
|
* Given a pathname, return the last component.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC const char *get_basename(const char *);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
2010-08-10 11:36:18 +00:00
|
|
|
/*
|
|
|
|
* Given a pathname, return a pointer to the last pathname separator
|
|
|
|
* character in the pathname, or NULL if the pathname contains no
|
|
|
|
* separators.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC char *find_last_pathname_separator(const char *path);
|
2010-08-10 11:36:18 +00:00
|
|
|
|
2007-01-14 22:25:22 +00:00
|
|
|
/*
|
|
|
|
* Given a pathname, return a string containing everything but the
|
|
|
|
* last component. NOTE: this overwrites the pathname handed into
|
|
|
|
* it....
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC char *get_dirname(char *);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Given a pathname, return:
|
|
|
|
*
|
|
|
|
* the errno, if an attempt to "stat()" the file fails;
|
|
|
|
*
|
|
|
|
* EISDIR, if the attempt succeeded and the file turned out
|
|
|
|
* to be a directory;
|
|
|
|
*
|
|
|
|
* 0, if the attempt succeeded and the file turned out not
|
|
|
|
* to be a directory.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int test_for_directory(const char *);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Given a pathname, return:
|
|
|
|
*
|
|
|
|
* the errno, if an attempt to "stat()" the file fails;
|
|
|
|
*
|
|
|
|
* ESPIPE, if the attempt succeeded and the file turned out
|
|
|
|
* to be a FIFO;
|
|
|
|
*
|
|
|
|
* 0, if the attempt succeeded and the file turned out not
|
|
|
|
* to be a FIFO.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC int test_for_fifo(const char *);
|
2007-01-14 22:25:22 +00:00
|
|
|
|
2005-04-12 21:12:19 +00:00
|
|
|
/*
|
|
|
|
* Check, if file is existing.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean file_exists(const char *fname);
|
2005-04-12 21:12:19 +00:00
|
|
|
|
|
|
|
/*
|
2009-02-15 21:47:57 +00:00
|
|
|
* Check if two filenames are identical (with absolute and relative paths).
|
2005-04-12 21:12:19 +00:00
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean files_identical(const char *fname1, const char *fname2);
|
2005-04-12 21:12:19 +00:00
|
|
|
|
2009-02-15 21:47:57 +00:00
|
|
|
/*
|
|
|
|
* Copy a file in binary mode, for those operating systems that care about
|
|
|
|
* such things. This should be OK for all files, even text files, as
|
|
|
|
* we'll copy the raw bytes, and we don't look at the bytes as we copy
|
|
|
|
* them.
|
|
|
|
*
|
|
|
|
* Returns TRUE on success, FALSE on failure. If a failure, it also
|
|
|
|
* displays a simple dialog window with the error message.
|
|
|
|
*/
|
2013-03-01 23:53:11 +00:00
|
|
|
WS_DLL_PUBLIC gboolean copy_file_binary_mode(const char *from_filename,
|
2009-02-15 21:47:57 +00:00
|
|
|
const char *to_filename);
|
|
|
|
|
2016-12-09 10:46:20 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Given a filename return a filesystem URL. Relative paths are prefixed with
|
|
|
|
* the datafile directory path.
|
|
|
|
*
|
|
|
|
* @param filename A file name or path. Relative paths will be prefixed with
|
|
|
|
* the data file directory path.
|
|
|
|
* @return A filesystem URL for the file or NULL on failure. A non-NULL return
|
|
|
|
* value must be freed with g_free().
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC gchar* data_file_url(const gchar *filename);
|
|
|
|
|
2017-02-08 13:25:57 +00:00
|
|
|
/*
|
|
|
|
* Free the internal structtures
|
|
|
|
*/
|
|
|
|
WS_DLL_PUBLIC void free_progdirs(void);
|
|
|
|
|
2010-12-01 18:25:18 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
2000-12-22 22:26:19 +00:00
|
|
|
#endif /* FILESYSTEM_H */
|