mirror of https://github.com/python/cpython
336 lines
9.2 KiB
C
336 lines
9.2 KiB
C
#ifndef Py_INTERNAL_FILEUTILS_H
|
|
#define Py_INTERNAL_FILEUTILS_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef Py_BUILD_CORE
|
|
# error "this header requires Py_BUILD_CORE define"
|
|
#endif
|
|
|
|
#include <locale.h> // struct lconv
|
|
|
|
|
|
/* A routine to check if a file descriptor can be select()-ed. */
|
|
#ifdef _MSC_VER
|
|
/* On Windows, any socket fd can be select()-ed, no matter how high */
|
|
#define _PyIsSelectable_fd(FD) (1)
|
|
#else
|
|
#define _PyIsSelectable_fd(FD) ((unsigned int)(FD) < (unsigned int)FD_SETSIZE)
|
|
#endif
|
|
|
|
struct _fileutils_state {
|
|
int force_ascii;
|
|
};
|
|
|
|
typedef enum {
|
|
_Py_ERROR_UNKNOWN=0,
|
|
_Py_ERROR_STRICT,
|
|
_Py_ERROR_SURROGATEESCAPE,
|
|
_Py_ERROR_REPLACE,
|
|
_Py_ERROR_IGNORE,
|
|
_Py_ERROR_BACKSLASHREPLACE,
|
|
_Py_ERROR_SURROGATEPASS,
|
|
_Py_ERROR_XMLCHARREFREPLACE,
|
|
_Py_ERROR_OTHER
|
|
} _Py_error_handler;
|
|
|
|
// Export for '_testinternalcapi' shared extension
|
|
PyAPI_FUNC(_Py_error_handler) _Py_GetErrorHandler(const char *errors);
|
|
|
|
// Export for '_testinternalcapi' shared extension
|
|
PyAPI_FUNC(int) _Py_DecodeLocaleEx(
|
|
const char *arg,
|
|
wchar_t **wstr,
|
|
size_t *wlen,
|
|
const char **reason,
|
|
int current_locale,
|
|
_Py_error_handler errors);
|
|
|
|
// Export for '_testinternalcapi' shared extension
|
|
PyAPI_FUNC(int) _Py_EncodeLocaleEx(
|
|
const wchar_t *text,
|
|
char **str,
|
|
size_t *error_pos,
|
|
const char **reason,
|
|
int current_locale,
|
|
_Py_error_handler errors);
|
|
|
|
extern char* _Py_EncodeLocaleRaw(
|
|
const wchar_t *text,
|
|
size_t *error_pos);
|
|
|
|
extern PyObject* _Py_device_encoding(int);
|
|
|
|
#if defined(MS_WINDOWS) || defined(__APPLE__)
|
|
/* On Windows, the count parameter of read() is an int (bpo-9015, bpo-9611).
|
|
On macOS 10.13, read() and write() with more than INT_MAX bytes
|
|
fail with EINVAL (bpo-24658). */
|
|
# define _PY_READ_MAX INT_MAX
|
|
# define _PY_WRITE_MAX INT_MAX
|
|
#else
|
|
/* write() should truncate the input to PY_SSIZE_T_MAX bytes,
|
|
but it's safer to do it ourself to have a portable behaviour */
|
|
# define _PY_READ_MAX PY_SSIZE_T_MAX
|
|
# define _PY_WRITE_MAX PY_SSIZE_T_MAX
|
|
#endif
|
|
|
|
#ifdef MS_WINDOWS
|
|
struct _Py_stat_struct {
|
|
uint64_t st_dev;
|
|
uint64_t st_ino;
|
|
unsigned short st_mode;
|
|
int st_nlink;
|
|
int st_uid;
|
|
int st_gid;
|
|
unsigned long st_rdev;
|
|
__int64 st_size;
|
|
time_t st_atime;
|
|
int st_atime_nsec;
|
|
time_t st_mtime;
|
|
int st_mtime_nsec;
|
|
time_t st_ctime;
|
|
int st_ctime_nsec;
|
|
time_t st_birthtime;
|
|
int st_birthtime_nsec;
|
|
unsigned long st_file_attributes;
|
|
unsigned long st_reparse_tag;
|
|
uint64_t st_ino_high;
|
|
};
|
|
#else
|
|
# define _Py_stat_struct stat
|
|
#endif
|
|
|
|
// Export for 'mmap' shared extension
|
|
PyAPI_FUNC(int) _Py_fstat(
|
|
int fd,
|
|
struct _Py_stat_struct *status);
|
|
|
|
// Export for 'mmap' shared extension
|
|
PyAPI_FUNC(int) _Py_fstat_noraise(
|
|
int fd,
|
|
struct _Py_stat_struct *status);
|
|
|
|
// Export for '_tkinter' shared extension
|
|
PyAPI_FUNC(int) _Py_stat(
|
|
PyObject *path,
|
|
struct stat *status);
|
|
|
|
// Export for 'select' shared extension (Solaris newDevPollObject())
|
|
PyAPI_FUNC(int) _Py_open(
|
|
const char *pathname,
|
|
int flags);
|
|
|
|
// Export for '_posixsubprocess' shared extension
|
|
PyAPI_FUNC(int) _Py_open_noraise(
|
|
const char *pathname,
|
|
int flags);
|
|
|
|
extern FILE* _Py_wfopen(
|
|
const wchar_t *path,
|
|
const wchar_t *mode);
|
|
|
|
extern Py_ssize_t _Py_read(
|
|
int fd,
|
|
void *buf,
|
|
size_t count);
|
|
|
|
// Export for 'select' shared extension (Solaris devpoll_flush())
|
|
PyAPI_FUNC(Py_ssize_t) _Py_write(
|
|
int fd,
|
|
const void *buf,
|
|
size_t count);
|
|
|
|
// Export for '_posixsubprocess' shared extension
|
|
PyAPI_FUNC(Py_ssize_t) _Py_write_noraise(
|
|
int fd,
|
|
const void *buf,
|
|
size_t count);
|
|
|
|
#ifdef HAVE_READLINK
|
|
extern int _Py_wreadlink(
|
|
const wchar_t *path,
|
|
wchar_t *buf,
|
|
/* Number of characters of 'buf' buffer
|
|
including the trailing NUL character */
|
|
size_t buflen);
|
|
#endif
|
|
|
|
#ifdef HAVE_REALPATH
|
|
extern wchar_t* _Py_wrealpath(
|
|
const wchar_t *path,
|
|
wchar_t *resolved_path,
|
|
/* Number of characters of 'resolved_path' buffer
|
|
including the trailing NUL character */
|
|
size_t resolved_path_len);
|
|
#endif
|
|
|
|
extern wchar_t* _Py_wgetcwd(
|
|
wchar_t *buf,
|
|
/* Number of characters of 'buf' buffer
|
|
including the trailing NUL character */
|
|
size_t buflen);
|
|
|
|
extern int _Py_get_inheritable(int fd);
|
|
|
|
// Export for '_socket' shared extension
|
|
PyAPI_FUNC(int) _Py_set_inheritable(int fd, int inheritable,
|
|
int *atomic_flag_works);
|
|
|
|
// Export for '_posixsubprocess' shared extension
|
|
PyAPI_FUNC(int) _Py_set_inheritable_async_safe(int fd, int inheritable,
|
|
int *atomic_flag_works);
|
|
|
|
// Export for '_socket' shared extension
|
|
PyAPI_FUNC(int) _Py_dup(int fd);
|
|
|
|
extern int _Py_get_blocking(int fd);
|
|
|
|
extern int _Py_set_blocking(int fd, int blocking);
|
|
|
|
#ifdef MS_WINDOWS
|
|
extern void* _Py_get_osfhandle_noraise(int fd);
|
|
|
|
// Export for '_testconsole' shared extension
|
|
PyAPI_FUNC(void*) _Py_get_osfhandle(int fd);
|
|
|
|
extern int _Py_open_osfhandle_noraise(void *handle, int flags);
|
|
|
|
extern int _Py_open_osfhandle(void *handle, int flags);
|
|
#endif /* MS_WINDOWS */
|
|
|
|
// This is used after getting NULL back from Py_DecodeLocale().
|
|
#define DECODE_LOCALE_ERR(NAME, LEN) \
|
|
((LEN) == (size_t)-2) \
|
|
? _PyStatus_ERR("cannot decode " NAME) \
|
|
: _PyStatus_NO_MEMORY()
|
|
|
|
extern int _Py_HasFileSystemDefaultEncodeErrors;
|
|
|
|
extern int _Py_DecodeUTF8Ex(
|
|
const char *arg,
|
|
Py_ssize_t arglen,
|
|
wchar_t **wstr,
|
|
size_t *wlen,
|
|
const char **reason,
|
|
_Py_error_handler errors);
|
|
|
|
extern int _Py_EncodeUTF8Ex(
|
|
const wchar_t *text,
|
|
char **str,
|
|
size_t *error_pos,
|
|
const char **reason,
|
|
int raw_malloc,
|
|
_Py_error_handler errors);
|
|
|
|
extern wchar_t* _Py_DecodeUTF8_surrogateescape(
|
|
const char *arg,
|
|
Py_ssize_t arglen,
|
|
size_t *wlen);
|
|
|
|
extern int
|
|
_Py_wstat(const wchar_t *, struct stat *);
|
|
|
|
extern int _Py_GetForceASCII(void);
|
|
|
|
/* Reset "force ASCII" mode (if it was initialized).
|
|
|
|
This function should be called when Python changes the LC_CTYPE locale,
|
|
so the "force ASCII" mode can be detected again on the new locale
|
|
encoding. */
|
|
extern void _Py_ResetForceASCII(void);
|
|
|
|
|
|
extern int _Py_GetLocaleconvNumeric(
|
|
struct lconv *lc,
|
|
PyObject **decimal_point,
|
|
PyObject **thousands_sep);
|
|
|
|
// Export for '_posixsubprocess' (on macOS)
|
|
PyAPI_FUNC(void) _Py_closerange(int first, int last);
|
|
|
|
extern wchar_t* _Py_GetLocaleEncoding(void);
|
|
extern PyObject* _Py_GetLocaleEncodingObject(void);
|
|
|
|
#ifdef HAVE_NON_UNICODE_WCHAR_T_REPRESENTATION
|
|
extern int _Py_LocaleUsesNonUnicodeWchar(void);
|
|
|
|
extern wchar_t* _Py_DecodeNonUnicodeWchar(
|
|
const wchar_t* native,
|
|
Py_ssize_t size);
|
|
|
|
extern int _Py_EncodeNonUnicodeWchar_InPlace(
|
|
wchar_t* unicode,
|
|
Py_ssize_t size);
|
|
#endif
|
|
|
|
extern int _Py_isabs(const wchar_t *path);
|
|
extern int _Py_abspath(const wchar_t *path, wchar_t **abspath_p);
|
|
#ifdef MS_WINDOWS
|
|
extern int _PyOS_getfullpathname(const wchar_t *path, wchar_t **abspath_p);
|
|
#endif
|
|
extern wchar_t* _Py_join_relfile(const wchar_t *dirname,
|
|
const wchar_t *relfile);
|
|
extern int _Py_add_relfile(wchar_t *dirname,
|
|
const wchar_t *relfile,
|
|
size_t bufsize);
|
|
extern size_t _Py_find_basename(const wchar_t *filename);
|
|
|
|
// Export for '_testinternalcapi' shared extension
|
|
PyAPI_FUNC(wchar_t*) _Py_normpath(wchar_t *path, Py_ssize_t size);
|
|
|
|
extern wchar_t *_Py_normpath_and_size(wchar_t *path, Py_ssize_t size, Py_ssize_t *length);
|
|
|
|
// The Windows Games API family does not provide these functions
|
|
// so provide our own implementations. Remove them in case they get added
|
|
// to the Games API family
|
|
#if defined(MS_WINDOWS_GAMES) && !defined(MS_WINDOWS_DESKTOP)
|
|
#include <winerror.h> // HRESULT
|
|
|
|
extern HRESULT PathCchSkipRoot(const wchar_t *pszPath, const wchar_t **ppszRootEnd);
|
|
#endif /* defined(MS_WINDOWS_GAMES) && !defined(MS_WINDOWS_DESKTOP) */
|
|
|
|
extern void _Py_skiproot(const wchar_t *path, Py_ssize_t size, Py_ssize_t *drvsize, Py_ssize_t *rootsize);
|
|
|
|
// Macros to protect CRT calls against instant termination when passed an
|
|
// invalid parameter (bpo-23524). IPH stands for Invalid Parameter Handler.
|
|
// Usage:
|
|
//
|
|
// _Py_BEGIN_SUPPRESS_IPH
|
|
// ...
|
|
// _Py_END_SUPPRESS_IPH
|
|
#if defined _MSC_VER && _MSC_VER >= 1900
|
|
|
|
# include <stdlib.h> // _set_thread_local_invalid_parameter_handler()
|
|
|
|
extern _invalid_parameter_handler _Py_silent_invalid_parameter_handler;
|
|
# define _Py_BEGIN_SUPPRESS_IPH \
|
|
{ _invalid_parameter_handler _Py_old_handler = \
|
|
_set_thread_local_invalid_parameter_handler(_Py_silent_invalid_parameter_handler);
|
|
# define _Py_END_SUPPRESS_IPH \
|
|
_set_thread_local_invalid_parameter_handler(_Py_old_handler); }
|
|
#else
|
|
# define _Py_BEGIN_SUPPRESS_IPH
|
|
# define _Py_END_SUPPRESS_IPH
|
|
#endif /* _MSC_VER >= 1900 */
|
|
|
|
// Export for 'select' shared extension (Argument Clinic code)
|
|
PyAPI_FUNC(int) _PyLong_FileDescriptor_Converter(PyObject *, void *);
|
|
|
|
// Export for test_peg_generator
|
|
PyAPI_FUNC(char*) _Py_UniversalNewlineFgetsWithSize(char *, int, FILE*, PyObject *, size_t*);
|
|
|
|
extern int _PyFile_Flush(PyObject *);
|
|
|
|
#ifndef MS_WINDOWS
|
|
extern int _Py_GetTicksPerSecond(long *ticks_per_second);
|
|
#endif
|
|
|
|
// Export for '_testcapi' shared extension
|
|
PyAPI_FUNC(int) _Py_IsValidFD(int fd);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_INTERNAL_FILEUTILS_H */
|