400 lines
14 KiB
C
400 lines
14 KiB
C
/***
|
|
*io.h - declarations for low-level file handling and I/O functions
|
|
*
|
|
* Copyright (c) 1985-2001, Microsoft Corporation. All rights reserved.
|
|
*
|
|
*Purpose:
|
|
* This file contains the function declarations for the low-level
|
|
* file handling and I/O functions.
|
|
*
|
|
* [Public]
|
|
*
|
|
*Revision History:
|
|
* 10/20/87 JCR Removed "MSC40_ONLY" entries
|
|
* 11/09/87 JCR Multi-thread support
|
|
* 12-11-87 JCR Added "_loadds" functionality
|
|
* 12-17-87 JCR Added _MTHREAD_ONLY comments
|
|
* 12-18-87 JCR Added _FAR_ to declarations
|
|
* 02-10-88 JCR Cleaned up white space
|
|
* 08-19-88 GJF Modified to also work for the 386 (small model only)
|
|
* 05-03-89 JCR Added _INTERNAL_IFSTRIP for relinc usage
|
|
* 08-03-89 GJF Cleanup, now specific to OS/2 2.0 (i.e., 386 flat model)
|
|
* 08-14-89 GJF Added prototype for _pipe()
|
|
* 10-30-89 GJF Fixed copyright
|
|
* 11-02-89 JCR Changed "DLL" to "_DLL"
|
|
* 11-17-89 GJF read() should take "void *" not "char *", write()
|
|
* should take "const void *" not "char *". Also,
|
|
* added const to appropriate arg types for access(),
|
|
* chmod(), creat(), open() and sopen()
|
|
* 03-01-90 GJF Added #ifndef _INC_IO and #include <cruntime.h>
|
|
* stuff. Also, removed some (now) useless preprocessor
|
|
* directives.
|
|
* 03-21-90 GJF Replaced _cdecl with _CALLTYPE1 or _CALLTYPE2 in
|
|
* prototypes.
|
|
* 05-28-90 SBM Added _commit()
|
|
* 01-18-91 GJF ANSI naming.
|
|
* 02-25-91 SRW Exposed _get_osfhandle and _open_osfhandle [_WIN32_]
|
|
* 08-01-91 GJF No _pipe for Dosx32.
|
|
* 08-20-91 JCR C++ and ANSI naming
|
|
* 08-26-91 BWM Added _findfirst, etc.
|
|
* 09-16-91 BWM Changed find handle type to long.
|
|
* 09-28-91 JCR ANSI names: DOSX32=prototypes, WIN32=#defines for now
|
|
* 03-30-92 DJM POSIX support.
|
|
* 06-23-92 GJF // is non-ANSI comment delimiter.
|
|
* 08-06-92 GJF Function calling type and variable type macros.
|
|
* 08-25-92 GJF For POSIX build, #ifdef-ed out all but some internally
|
|
* used macros (and these are stripped out on release).
|
|
* 09-03-92 GJF Merge two changes above.
|
|
* 01-21-93 GJF Removed support for C6-386's _cdecl.
|
|
* 03-29-93 JWM Increased name buffer in finddata structure to 260 bytes.
|
|
* 04-06-93 SKS Replace _CRTAPI1/2 with __cdecl, _CRTVAR1 with nothing
|
|
* 04-07-93 SKS Add _CRTIMP keyword for CRT DLL model
|
|
* Use link-time aliases for old names, not #define's
|
|
* 05-17-93 SKS #if for old names no longer checks for _cplusplus.
|
|
* It used to do so past because #define-ing names like
|
|
* open, read, write, etc. created problems for users
|
|
* 09-01-93 GJF Merged NT SDK and Cuda versions.
|
|
* 12-07-93 CFW Add wide char version protos.
|
|
* 11-03-94 GJF Ensure 8 byte alignment.
|
|
* 11-18-94 GJF Added prototypes for _lseeki64, _filelengthi64 and
|
|
* _telli64.
|
|
* 12-07-94 SKS Add comment for ifstrip utility (src release process)
|
|
* 12-15-94 XY merged with mac header
|
|
* 12-29-94 GJF Added _[w]findfilei64 and _[w]findnexti64. Also removed
|
|
* obsolete _CALLTYPE* macro.
|
|
* 02-11-95 CFW Add _CRTBLD to avoid users getting wrong headers.
|
|
* 02-14-95 CFW Clean up Mac merge.
|
|
* 02-24-95 SKS Replace _MTHREAD_ONLY comments (stripped by source
|
|
* cleansing) with #ifdef _NOT_CRTL_BUILD_
|
|
* 10-06-95 SKS Add "const" to "char *" in prototypes for *findfirst().
|
|
* 12-14-95 JWM Add "#pragma once".
|
|
* 02-20-97 GJF Cleaned out obsolete support for _CRTAPI* and _NTSDK.
|
|
* Also, detab-ed.
|
|
* 09-30-97 JWM Restored not-so-obsolete _CRTAPI1 support.
|
|
* 10-07-97 RDL Added IA64.
|
|
* 02-10-98 GJF Changes for Win64: made time_t __int64, and changed
|
|
* arg and return types to intptr_t where appropriate
|
|
* 05-04-98 GJF Added __time64_t support.
|
|
* 05-13-99 PML Remove _CRTAPI1
|
|
* 05-17-99 PML Remove all Macintosh support.
|
|
* 10-06-99 PML Add _W64 modifier to types which are 32 bits in Win32,
|
|
* 64 bits in Win64.
|
|
* 11-12-99 PML Wrap __time64_t in its own #ifndef.
|
|
*
|
|
****/
|
|
|
|
#if _MSC_VER > 1000 /*IFSTRIP=IGN*/
|
|
#pragma once
|
|
#endif
|
|
|
|
#ifndef _INC_IO
|
|
#define _INC_IO
|
|
|
|
#if !defined(_WIN32)
|
|
#error ERROR: Only Win32 target supported!
|
|
#endif
|
|
|
|
#ifndef _CRTBLD
|
|
/* This version of the header files is NOT for user programs.
|
|
* It is intended for use when building the C runtimes ONLY.
|
|
* The version intended for public use will not have this message.
|
|
*/
|
|
#error ERROR: Use of C runtime library internal header file.
|
|
#endif /* _CRTBLD */
|
|
|
|
#ifdef _MSC_VER
|
|
/*
|
|
* Currently, all MS C compilers for Win32 platforms default to 8 byte
|
|
* alignment.
|
|
*/
|
|
#pragma pack(push,8)
|
|
#endif /* _MSC_VER */
|
|
|
|
#ifndef _POSIX_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef _INTERNAL_IFSTRIP_
|
|
#include <cruntime.h>
|
|
#endif /* _INTERNAL_IFSTRIP_ */
|
|
|
|
#if !defined(_W64)
|
|
#if !defined(__midl) && (defined(_X86_) || defined(_M_IX86)) && _MSC_VER >= 1300 /*IFSTRIP=IGN*/
|
|
#define _W64 __w64
|
|
#else
|
|
#define _W64
|
|
#endif
|
|
#endif
|
|
|
|
/* Define _CRTIMP */
|
|
|
|
#ifndef _CRTIMP
|
|
#ifdef CRTDLL
|
|
#define _CRTIMP __declspec(dllexport)
|
|
#else /* ndef CRTDLL */
|
|
#ifdef _DLL
|
|
#define _CRTIMP __declspec(dllimport)
|
|
#else /* ndef _DLL */
|
|
#define _CRTIMP
|
|
#endif /* _DLL */
|
|
#endif /* CRTDLL */
|
|
#endif /* _CRTIMP */
|
|
|
|
|
|
/* Define __cdecl for non-Microsoft compilers */
|
|
|
|
#if ( !defined(_MSC_VER) && !defined(__cdecl) )
|
|
#define __cdecl
|
|
#endif
|
|
|
|
#ifndef _INTPTR_T_DEFINED
|
|
#ifdef _WIN64
|
|
typedef __int64 intptr_t;
|
|
#else
|
|
typedef _W64 int intptr_t;
|
|
#endif
|
|
#define _INTPTR_T_DEFINED
|
|
#endif
|
|
|
|
#ifndef _WCHAR_T_DEFINED
|
|
typedef unsigned short wchar_t;
|
|
#define _WCHAR_T_DEFINED
|
|
#endif
|
|
|
|
#ifndef _TIME_T_DEFINED
|
|
#ifdef _WIN64
|
|
typedef __int64 time_t; /* time value */
|
|
#else
|
|
typedef _W64 long time_t; /* time value */
|
|
#endif
|
|
#define _TIME_T_DEFINED /* avoid multiple def's of time_t */
|
|
#endif
|
|
|
|
#ifndef _TIME64_T_DEFINED
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
typedef __int64 __time64_t; /* 64-bit time value */
|
|
#endif
|
|
#define _TIME64_T_DEFINED
|
|
#endif
|
|
|
|
#ifndef _FSIZE_T_DEFINED
|
|
typedef unsigned long _fsize_t; /* Could be 64 bits for Win32 */
|
|
#define _FSIZE_T_DEFINED
|
|
#endif
|
|
|
|
#ifndef _FINDDATA_T_DEFINED
|
|
|
|
struct _finddata_t {
|
|
unsigned attrib;
|
|
time_t time_create; /* -1 for FAT file systems */
|
|
time_t time_access; /* -1 for FAT file systems */
|
|
time_t time_write;
|
|
_fsize_t size;
|
|
char name[260];
|
|
};
|
|
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
|
|
struct _finddatai64_t {
|
|
unsigned attrib;
|
|
time_t time_create; /* -1 for FAT file systems */
|
|
time_t time_access; /* -1 for FAT file systems */
|
|
time_t time_write;
|
|
__int64 size;
|
|
char name[260];
|
|
};
|
|
|
|
struct __finddata64_t {
|
|
unsigned attrib;
|
|
__time64_t time_create; /* -1 for FAT file systems */
|
|
__time64_t time_access; /* -1 for FAT file systems */
|
|
__time64_t time_write;
|
|
__int64 size;
|
|
char name[260];
|
|
};
|
|
|
|
#endif
|
|
|
|
#define _FINDDATA_T_DEFINED
|
|
#endif
|
|
|
|
#ifndef _WFINDDATA_T_DEFINED
|
|
|
|
struct _wfinddata_t {
|
|
unsigned attrib;
|
|
time_t time_create; /* -1 for FAT file systems */
|
|
time_t time_access; /* -1 for FAT file systems */
|
|
time_t time_write;
|
|
_fsize_t size;
|
|
wchar_t name[260];
|
|
};
|
|
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
|
|
struct _wfinddatai64_t {
|
|
unsigned attrib;
|
|
time_t time_create; /* -1 for FAT file systems */
|
|
time_t time_access; /* -1 for FAT file systems */
|
|
time_t time_write;
|
|
__int64 size;
|
|
wchar_t name[260];
|
|
};
|
|
|
|
struct __wfinddata64_t {
|
|
unsigned attrib;
|
|
__time64_t time_create; /* -1 for FAT file systems */
|
|
__time64_t time_access; /* -1 for FAT file systems */
|
|
__time64_t time_write;
|
|
__int64 size;
|
|
wchar_t name[260];
|
|
};
|
|
|
|
#endif
|
|
|
|
#define _WFINDDATA_T_DEFINED
|
|
#endif
|
|
|
|
/* File attribute constants for _findfirst() */
|
|
|
|
#define _A_NORMAL 0x00 /* Normal file - No read/write restrictions */
|
|
#define _A_RDONLY 0x01 /* Read only file */
|
|
#define _A_HIDDEN 0x02 /* Hidden file */
|
|
#define _A_SYSTEM 0x04 /* System file */
|
|
#define _A_SUBDIR 0x10 /* Subdirectory */
|
|
#define _A_ARCH 0x20 /* Archive file */
|
|
|
|
/* function prototypes */
|
|
|
|
_CRTIMP int __cdecl _access(const char *, int);
|
|
_CRTIMP int __cdecl _chmod(const char *, int);
|
|
_CRTIMP int __cdecl _chsize(int, long);
|
|
_CRTIMP int __cdecl _close(int);
|
|
_CRTIMP int __cdecl _commit(int);
|
|
_CRTIMP int __cdecl _creat(const char *, int);
|
|
_CRTIMP int __cdecl _dup(int);
|
|
_CRTIMP int __cdecl _dup2(int, int);
|
|
_CRTIMP int __cdecl _eof(int);
|
|
_CRTIMP long __cdecl _filelength(int);
|
|
_CRTIMP intptr_t __cdecl _findfirst(const char *, struct _finddata_t *);
|
|
_CRTIMP int __cdecl _findnext(intptr_t, struct _finddata_t *);
|
|
_CRTIMP int __cdecl _findclose(intptr_t);
|
|
_CRTIMP int __cdecl _isatty(int);
|
|
_CRTIMP int __cdecl _locking(int, int, long);
|
|
_CRTIMP long __cdecl _lseek(int, long, int);
|
|
_CRTIMP char * __cdecl _mktemp(char *);
|
|
_CRTIMP int __cdecl _open(const char *, int, ...);
|
|
_CRTIMP int __cdecl _pipe(int *, unsigned int, int);
|
|
_CRTIMP int __cdecl _read(int, void *, unsigned int);
|
|
_CRTIMP int __cdecl remove(const char *);
|
|
_CRTIMP int __cdecl rename(const char *, const char *);
|
|
_CRTIMP int __cdecl _setmode(int, int);
|
|
_CRTIMP int __cdecl _sopen(const char *, int, int, ...);
|
|
_CRTIMP long __cdecl _tell(int);
|
|
_CRTIMP int __cdecl _umask(int);
|
|
_CRTIMP int __cdecl _unlink(const char *);
|
|
_CRTIMP int __cdecl _write(int, const void *, unsigned int);
|
|
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
_CRTIMP __int64 __cdecl _filelengthi64(int);
|
|
_CRTIMP intptr_t __cdecl _findfirsti64(const char *, struct _finddatai64_t *);
|
|
_CRTIMP intptr_t __cdecl _findfirst64(const char *, struct __finddata64_t *);
|
|
_CRTIMP int __cdecl _findnexti64(intptr_t, struct _finddatai64_t *);
|
|
_CRTIMP int __cdecl _findnext64(intptr_t, struct __finddata64_t *);
|
|
_CRTIMP __int64 __cdecl _lseeki64(int, __int64, int);
|
|
_CRTIMP __int64 __cdecl _telli64(int);
|
|
#endif
|
|
|
|
#ifndef _WIO_DEFINED
|
|
|
|
/* wide function prototypes, also declared in wchar.h */
|
|
|
|
_CRTIMP int __cdecl _waccess(const wchar_t *, int);
|
|
_CRTIMP int __cdecl _wchmod(const wchar_t *, int);
|
|
_CRTIMP int __cdecl _wcreat(const wchar_t *, int);
|
|
_CRTIMP intptr_t __cdecl _wfindfirst(const wchar_t *, struct _wfinddata_t *);
|
|
_CRTIMP int __cdecl _wfindnext(intptr_t, struct _wfinddata_t *);
|
|
_CRTIMP int __cdecl _wunlink(const wchar_t *);
|
|
_CRTIMP int __cdecl _wrename(const wchar_t *, const wchar_t *);
|
|
_CRTIMP int __cdecl _wopen(const wchar_t *, int, ...);
|
|
_CRTIMP int __cdecl _wsopen(const wchar_t *, int, int, ...);
|
|
_CRTIMP wchar_t * __cdecl _wmktemp(wchar_t *);
|
|
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
_CRTIMP intptr_t __cdecl _wfindfirsti64(const wchar_t *, struct _wfinddatai64_t *);
|
|
_CRTIMP int __cdecl _wfindnexti64(intptr_t, struct _wfinddatai64_t *);
|
|
_CRTIMP intptr_t __cdecl _wfindfirst64(const wchar_t *, struct __wfinddata64_t *);
|
|
_CRTIMP int __cdecl _wfindnext64(intptr_t, struct __wfinddata64_t *);
|
|
#endif
|
|
|
|
#define _WIO_DEFINED
|
|
#endif
|
|
|
|
#ifndef _NOT_CRTL_BUILD_
|
|
#ifdef _MT
|
|
int __cdecl _chsize_lk(int,long);
|
|
int __cdecl _close_lk(int);
|
|
long __cdecl _lseek_lk(int, long, int);
|
|
int __cdecl _setmode_lk(int, int);
|
|
int __cdecl _read_lk(int, void *, unsigned int);
|
|
int __cdecl _write_lk(int, const void *, unsigned int);
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
__int64 __cdecl _lseeki64_lk(int, __int64, int);
|
|
#endif
|
|
#else /* not _MT */
|
|
#define _chsize_lk(fh,size) _chsize(fh,size)
|
|
#define _close_lk(fh) _close(fh)
|
|
#define _lseek_lk(fh,offset,origin) _lseek(fh,offset,origin)
|
|
#define _setmode_lk(fh,mode) _setmode(fh,mode)
|
|
#define _read_lk(fh,buff,count) _read(fh,buff,count)
|
|
#define _write_lk(fh,buff,count) _write(fh,buff,count)
|
|
#if _INTEGRAL_MAX_BITS >= 64 /*IFSTRIP=IGN*/
|
|
#define _lseeki64_lk(fh,offset,origin) _lseeki64(fh,offset,origin)
|
|
#endif
|
|
#endif /* _MT */
|
|
#endif /* _NOT_CRTL_BUILD_ */
|
|
|
|
_CRTIMP intptr_t __cdecl _get_osfhandle(int);
|
|
_CRTIMP int __cdecl _open_osfhandle(intptr_t, int);
|
|
|
|
#if !__STDC__
|
|
|
|
/* Non-ANSI names for compatibility */
|
|
|
|
_CRTIMP int __cdecl access(const char *, int);
|
|
_CRTIMP int __cdecl chmod(const char *, int);
|
|
_CRTIMP int __cdecl chsize(int, long);
|
|
_CRTIMP int __cdecl close(int);
|
|
_CRTIMP int __cdecl creat(const char *, int);
|
|
_CRTIMP int __cdecl dup(int);
|
|
_CRTIMP int __cdecl dup2(int, int);
|
|
_CRTIMP int __cdecl eof(int);
|
|
_CRTIMP long __cdecl filelength(int);
|
|
_CRTIMP int __cdecl isatty(int);
|
|
_CRTIMP int __cdecl locking(int, int, long);
|
|
_CRTIMP long __cdecl lseek(int, long, int);
|
|
_CRTIMP char * __cdecl mktemp(char *);
|
|
_CRTIMP int __cdecl open(const char *, int, ...);
|
|
_CRTIMP int __cdecl read(int, void *, unsigned int);
|
|
_CRTIMP int __cdecl setmode(int, int);
|
|
_CRTIMP int __cdecl sopen(const char *, int, int, ...);
|
|
_CRTIMP long __cdecl tell(int);
|
|
_CRTIMP int __cdecl umask(int);
|
|
_CRTIMP int __cdecl unlink(const char *);
|
|
_CRTIMP int __cdecl write(int, const void *, unsigned int);
|
|
|
|
#endif /* __STDC__ */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _POSIX_ */
|
|
|
|
#ifdef _MSC_VER
|
|
#pragma pack(pop)
|
|
#endif /* _MSC_VER */
|
|
|
|
#endif /* _INC_IO */
|