/usr/include/wireshark/wsutil/file_util.h is in libwsutil-dev 1.10.6-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | /* file_util.h
* File utility definitions
*
* $Id$
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* 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.
*
* 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.
*/
#ifndef __FILE_UTIL_H__
#define __FILE_UTIL_H__
#include "ws_symbol_export.h"
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
#include <glib.h>
#ifdef _WIN32
#include <io.h>
#include <gmodule.h>
#endif
#ifdef HAVE_SYS_STAT_H
#include <sys/stat.h>
#endif
#ifdef _WIN32
/*
* The structure to pass to ws_stat64() and ws_fstat64().
*/
#define ws_statb64 struct _stat64
/* Win32 (and Win64): we use UTF-8 for filenames and pathnames throughout
* the code, so file functions must convert filenames and pathnames from
* UTF-8 to UTF-16 as we use NT Unicode (Win9x - now unsupported - used
* locale-based encoding here). Microsoft's UN*X-style wrappers don't
* do that - they expect locale-based encodings - so we need our own
* wrappers. (We don't use the wrappers from GLib as that would, at
* least for the wrappers that return file descriptors or take them
* as arguments, require that we use the version of the C runtime with
* which the GLib binaries were built, and we can't guarantee to do that.)
*
* Note also that ws_stdio_rename() uses MoveFileEx() with
* MOVEFILE_REPLACE_EXISTING, so that it acts like UN*X rename(),
* removing the target if necessary.
*/
#include <stdio.h>
WS_DLL_PUBLIC int ws_stdio_open (const gchar *filename, int flags, int mode);
WS_DLL_PUBLIC int ws_stdio_rename (const gchar *oldfilename, const gchar *newfilename);
WS_DLL_PUBLIC int ws_stdio_mkdir (const gchar *filename, int mode);
WS_DLL_PUBLIC int ws_stdio_stat64 (const gchar *filename, ws_statb64 *buf);
WS_DLL_PUBLIC int ws_stdio_unlink (const gchar *filename);
WS_DLL_PUBLIC int ws_stdio_remove (const gchar *filename);
WS_DLL_PUBLIC FILE * ws_stdio_fopen (const gchar *filename, const gchar *mode);
WS_DLL_PUBLIC FILE * ws_stdio_freopen (const gchar *filename, const gchar *mode, FILE *stream);
#define ws_open ws_stdio_open
#define ws_rename ws_stdio_rename
#define ws_mkdir ws_stdio_mkdir
#define ws_stat64 ws_stdio_stat64
#define ws_unlink ws_stdio_unlink
#define ws_remove ws_stdio_remove
#define ws_fopen ws_stdio_fopen
#define ws_freopen ws_stdio_freopen
/*
* These routines don't take pathnames, so they don't require
* pathname-converting wrappers on Windows.
*/
#define ws_read _read
#define ws_write _write
#define ws_close _close
#define ws_dup _dup
#define ws_fstat64 _fstati64 /* use _fstati64 for 64-bit size support */
#define ws_lseek64 _lseeki64 /* use _lseeki64 for 64-bit offset support */
#define ws_fdopen _fdopen
/* DLL loading */
/** Try to remove the current directory from the DLL search path.
* SetDllDirectory is tried, then SetCurrentDirectory(program_dir)
*
* @return TRUE if we were able to call SetDllDirectory, FALSE otherwise.
*/
WS_DLL_PUBLIC
gboolean ws_init_dll_search_path();
/** Load a DLL using LoadLibrary.
* Only the system and program directories are searched.
*
* @param library_name The name of the DLL.
* @return A handle to the DLL if found, NULL on failure.
*/
WS_DLL_PUBLIC
void *ws_load_library(gchar *library_name);
/** Load a DLL using g_module_open.
* Only the system and program directories are searched.
*
* @param module_name The name of the DLL.
* @param flags Flags to be passed to g_module_open.
* @return A handle to the DLL if found, NULL on failure.
*/
WS_DLL_PUBLIC
GModule *ws_module_open(gchar *module_name, GModuleFlags flags);
/*
* utf8 version of getenv, needed to get win32 filename paths
*/
WS_DLL_PUBLIC char *getenv_utf8(const char *varname);
/** Create or open a "Wireshark is running" mutex.
* Create or open a mutex which signals that Wireshark or its associated
* executables is running. Used by the installer to test for a running application.
*/
WS_DLL_PUBLIC void create_app_running_mutex();
#else /* _WIN32 */
/*
* The structure to pass to ws_fstat64().
*/
#define ws_statb64 struct stat
/* Not Windows, presumed to be UN*X-compatible */
#define ws_open open
#define ws_rename rename
#define ws_mkdir(dir,mode) mkdir(dir,mode)
#define ws_stat64 stat
#define ws_unlink unlink
#define ws_remove remove
#define ws_fopen fopen
#define ws_freopen freopen
#define ws_read read
#define ws_write write
#define ws_close close
#define ws_dup dup
#define ws_fstat64 fstat /* AC_SYS_LARGEFILE should make off_t 64-bit */
#define ws_lseek64 lseek /* AC_SYS_LARGEFILE should make off_t 64-bit */
#define ws_fdopen fdopen
#define O_BINARY 0 /* Win32 needs the O_BINARY flag for open() */
#endif /* _WIN32 */
/* directory handling */
#define WS_DIR GDir
#define WS_DIRENT const char
#define ws_dir_open g_dir_open
#define ws_dir_read_name g_dir_read_name
#define ws_dir_get_name(dirent) dirent
#define ws_dir_rewind g_dir_rewind
#define ws_dir_close g_dir_close
/* XXX - remove include "dirent.h" */
/* XXX - remove include "direct.h" */
/* XXX - remove include "sys/stat.h" */
/* XXX - update docs (e.g. README.developer) */
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __FILE_UTIL_H__ */
|