]>
Commit | Line | Data |
---|---|---|
3ecd153a JS |
1 | #ifdef __MINGW64_VERSION_MAJOR |
2 | #include <stdint.h> | |
3 | #include <wchar.h> | |
4 | typedef _sigset_t sigset_t; | |
5 | #endif | |
f4626df5 | 6 | #include <winsock2.h> |
fe3b2b7b | 7 | #include <ws2tcpip.h> |
f4626df5 | 8 | |
3ecd153a JS |
9 | /* MinGW-w64 reports to have flockfile, but it does not actually have it. */ |
10 | #ifdef __MINGW64_VERSION_MAJOR | |
11 | #undef _POSIX_THREAD_SAFE_FUNCTIONS | |
12 | #endif | |
13 | ||
a4e7e317 GC |
14 | struct config_context; |
15 | int mingw_core_config(const char *var, const char *value, | |
16 | const struct config_context *ctx, void *cb); | |
70fc5793 JS |
17 | #define platform_core_config mingw_core_config |
18 | ||
f4626df5 JS |
19 | /* |
20 | * things that are not available in header files | |
21 | */ | |
22 | ||
e7cf4e94 | 23 | typedef int uid_t; |
772991af | 24 | typedef int socklen_t; |
3ecd153a JS |
25 | #ifndef __MINGW64_VERSION_MAJOR |
26 | typedef int pid_t; | |
f4626df5 | 27 | #define hstrerror strerror |
3ecd153a | 28 | #endif |
f4626df5 JS |
29 | |
30 | #define S_IFLNK 0120000 /* Symbolic link */ | |
31 | #define S_ISLNK(x) (((x) & S_IFMT) == S_IFLNK) | |
32 | #define S_ISSOCK(x) 0 | |
4091bfc9 | 33 | |
59de49f8 | 34 | #ifndef S_IRWXG |
f4626df5 JS |
35 | #define S_IRGRP 0 |
36 | #define S_IWGRP 0 | |
37 | #define S_IXGRP 0 | |
4091bfc9 | 38 | #define S_IRWXG (S_IRGRP | S_IWGRP | S_IXGRP) |
59de49f8 JS |
39 | #endif |
40 | #ifndef S_IRWXO | |
f4626df5 | 41 | #define S_IROTH 0 |
4091bfc9 | 42 | #define S_IWOTH 0 |
f4626df5 | 43 | #define S_IXOTH 0 |
4091bfc9 | 44 | #define S_IRWXO (S_IROTH | S_IWOTH | S_IXOTH) |
59de49f8 | 45 | #endif |
90110d76 RJ |
46 | |
47 | #define S_ISUID 0004000 | |
48 | #define S_ISGID 0002000 | |
49 | #define S_ISVTX 0001000 | |
f4626df5 | 50 | |
303e7c48 JS |
51 | #define WIFEXITED(x) 1 |
52 | #define WIFSIGNALED(x) 0 | |
f4626df5 | 53 | #define WEXITSTATUS(x) ((x) & 0xff) |
303e7c48 | 54 | #define WTERMSIG(x) SIGTERM |
f4626df5 | 55 | |
61542f77 | 56 | #ifndef EWOULDBLOCK |
419f37db | 57 | #define EWOULDBLOCK EAGAIN |
61542f77 | 58 | #endif |
e0a064a1 KB |
59 | #ifndef ELOOP |
60 | #define ELOOP EMLINK | |
61 | #endif | |
419f37db IL |
62 | #define SHUT_WR SD_SEND |
63 | ||
d2825065 JS |
64 | #define SIGHUP 1 |
65 | #define SIGQUIT 3 | |
66 | #define SIGKILL 9 | |
67 | #define SIGPIPE 13 | |
68 | #define SIGALRM 14 | |
69 | #define SIGCHLD 17 | |
f4626df5 JS |
70 | |
71 | #define F_GETFD 1 | |
72 | #define F_SETFD 2 | |
73 | #define FD_CLOEXEC 0x1 | |
74 | ||
05d1ed61 BW |
75 | #if !defined O_CLOEXEC && defined O_NOINHERIT |
76 | #define O_CLOEXEC O_NOINHERIT | |
77 | #endif | |
78 | ||
61542f77 | 79 | #ifndef EAFNOSUPPORT |
772991af | 80 | #define EAFNOSUPPORT WSAEAFNOSUPPORT |
61542f77 KB |
81 | #endif |
82 | #ifndef ECONNABORTED | |
772991af | 83 | #define ECONNABORTED WSAECONNABORTED |
61542f77 | 84 | #endif |
fab60274 JS |
85 | #ifndef ENOTSOCK |
86 | #define ENOTSOCK WSAENOTSOCK | |
87 | #endif | |
772991af | 88 | |
f4626df5 JS |
89 | struct passwd { |
90 | char *pw_name; | |
91 | char *pw_gecos; | |
92 | char *pw_dir; | |
93 | }; | |
94 | ||
f4626df5 JS |
95 | typedef void (__cdecl *sig_handler_t)(int); |
96 | struct sigaction { | |
97 | sig_handler_t sa_handler; | |
98 | unsigned sa_flags; | |
99 | }; | |
f4626df5 JS |
100 | #define SA_RESTART 0 |
101 | ||
102 | struct itimerval { | |
103 | struct timeval it_value, it_interval; | |
104 | }; | |
105 | #define ITIMER_REAL 0 | |
106 | ||
7b6aff06 NTND |
107 | struct utsname { |
108 | char sysname[16]; | |
109 | char nodename[1]; | |
110 | char release[16]; | |
111 | char version[16]; | |
112 | char machine[1]; | |
113 | }; | |
114 | ||
77df1f1e ES |
115 | /* |
116 | * sanitize preprocessor namespace polluted by Windows headers defining | |
117 | * macros which collide with git local versions | |
118 | */ | |
119 | #undef HELP_COMMAND /* from winuser.h */ | |
120 | ||
f4626df5 JS |
121 | /* |
122 | * trivial stubs | |
123 | */ | |
124 | ||
125 | static inline int readlink(const char *path, char *buf, size_t bufsiz) | |
126 | { errno = ENOSYS; return -1; } | |
127 | static inline int symlink(const char *oldpath, const char *newpath) | |
128 | { errno = ENOSYS; return -1; } | |
f4626df5 JS |
129 | static inline int fchmod(int fildes, mode_t mode) |
130 | { errno = ENOSYS; return -1; } | |
3ecd153a | 131 | #ifndef __MINGW64_VERSION_MAJOR |
f0c7fd49 JH |
132 | static inline pid_t fork(void) |
133 | { errno = ENOSYS; return -1; } | |
3ecd153a | 134 | #endif |
f4626df5 JS |
135 | static inline unsigned int alarm(unsigned int seconds) |
136 | { return 0; } | |
137 | static inline int fsync(int fd) | |
75f6929a | 138 | { return _commit(fd); } |
f4626df5 JS |
139 | static inline void sync(void) |
140 | {} | |
e7cf4e94 | 141 | static inline uid_t getuid(void) |
f4626df5 JS |
142 | { return 1; } |
143 | static inline struct passwd *getpwnam(const char *name) | |
144 | { return NULL; } | |
5f8763a8 | 145 | static inline int fcntl(int fd, int cmd, ...) |
f4626df5 JS |
146 | { |
147 | if (cmd == F_GETFD || cmd == F_SETFD) | |
148 | return 0; | |
149 | errno = EINVAL; | |
150 | return -1; | |
151 | } | |
ee4512ed | 152 | |
4e6d207c JS |
153 | #define sigemptyset(x) (void)0 |
154 | static inline int sigaddset(sigset_t *set, int signum) | |
155 | { return 0; } | |
f924b52a | 156 | #define SIG_BLOCK 0 |
4e6d207c JS |
157 | #define SIG_UNBLOCK 0 |
158 | static inline int sigprocmask(int how, const sigset_t *set, sigset_t *oldset) | |
159 | { return 0; } | |
9a9a41db JS |
160 | static inline pid_t getppid(void) |
161 | { return 1; } | |
162 | static inline pid_t getpgid(pid_t pid) | |
163 | { return pid == 0 ? getpid() : pid; } | |
164 | static inline pid_t tcgetpgrp(int fd) | |
165 | { return getpid(); } | |
f4626df5 JS |
166 | |
167 | /* | |
168 | * simple adaptors | |
169 | */ | |
170 | ||
85faec9d | 171 | int mingw_mkdir(const char *path, int mode); |
f4626df5 JS |
172 | #define mkdir mingw_mkdir |
173 | ||
ef7108ca | 174 | #define WNOHANG 1 |
956d86d1 | 175 | pid_t waitpid(pid_t pid, int *status, int options); |
f4626df5 | 176 | |
82fc07b7 EFL |
177 | #define kill mingw_kill |
178 | int mingw_kill(pid_t pid, int sig); | |
179 | ||
2bf46a9f MA |
180 | #define locate_in_PATH mingw_locate_in_PATH |
181 | char *mingw_locate_in_PATH(const char *cmd); | |
182 | ||
514213bf EFL |
183 | #ifndef NO_OPENSSL |
184 | #include <openssl/ssl.h> | |
185 | static inline int mingw_SSL_set_fd(SSL *ssl, int fd) | |
186 | { | |
187 | return SSL_set_fd(ssl, _get_osfhandle(fd)); | |
188 | } | |
189 | #define SSL_set_fd mingw_SSL_set_fd | |
190 | ||
191 | static inline int mingw_SSL_set_rfd(SSL *ssl, int fd) | |
192 | { | |
193 | return SSL_set_rfd(ssl, _get_osfhandle(fd)); | |
194 | } | |
195 | #define SSL_set_rfd mingw_SSL_set_rfd | |
196 | ||
197 | static inline int mingw_SSL_set_wfd(SSL *ssl, int fd) | |
198 | { | |
199 | return SSL_set_wfd(ssl, _get_osfhandle(fd)); | |
200 | } | |
201 | #define SSL_set_wfd mingw_SSL_set_wfd | |
202 | #endif | |
203 | ||
f4626df5 JS |
204 | /* |
205 | * implementations of missing functions | |
206 | */ | |
207 | ||
897bb8cb | 208 | int pipe(int filedes[2]); |
f4626df5 JS |
209 | unsigned int sleep (unsigned int seconds); |
210 | int mkstemp(char *template); | |
211 | int gettimeofday(struct timeval *tv, void *tz); | |
3ecd153a | 212 | #ifndef __MINGW64_VERSION_MAJOR |
f4626df5 JS |
213 | struct tm *gmtime_r(const time_t *timep, struct tm *result); |
214 | struct tm *localtime_r(const time_t *timep, struct tm *result); | |
3ecd153a | 215 | #endif |
f4626df5 | 216 | int getpagesize(void); /* defined in MinGW's libgcc.a */ |
e7cf4e94 | 217 | struct passwd *getpwuid(uid_t uid); |
f4626df5 JS |
218 | int setitimer(int type, struct itimerval *in, struct itimerval *out); |
219 | int sigaction(int sig, struct sigaction *in, struct sigaction *out); | |
7be401e0 | 220 | int link(const char *oldpath, const char *newpath); |
7b6aff06 | 221 | int uname(struct utsname *buf); |
80ba074f | 222 | |
25fe217b JS |
223 | /* |
224 | * replacements of existing functions | |
225 | */ | |
226 | ||
337967fb HV |
227 | int mingw_unlink(const char *pathname); |
228 | #define unlink mingw_unlink | |
229 | ||
4f288100 HV |
230 | int mingw_rmdir(const char *path); |
231 | #define rmdir mingw_rmdir | |
232 | ||
3e4a1ba0 JS |
233 | int mingw_open (const char *filename, int oflags, ...); |
234 | #define open mingw_open | |
2b081012 | 235 | #undef OPEN_RETURNS_EINTR |
3e4a1ba0 | 236 | |
176478a8 EFL |
237 | int mingw_fgetc(FILE *stream); |
238 | #define fgetc mingw_fgetc | |
239 | ||
3fdcdbdf JS |
240 | FILE *mingw_fopen (const char *filename, const char *otype); |
241 | #define fopen mingw_fopen | |
242 | ||
243 | FILE *mingw_freopen (const char *filename, const char *otype, FILE *stream); | |
244 | #define freopen mingw_freopen | |
245 | ||
84adb641 JS |
246 | int mingw_fflush(FILE *stream); |
247 | #define fflush mingw_fflush | |
248 | ||
2b86292e JS |
249 | ssize_t mingw_write(int fd, const void *buf, size_t len); |
250 | #define write mingw_write | |
251 | ||
85faec9d KB |
252 | int mingw_access(const char *filename, int mode); |
253 | #undef access | |
254 | #define access mingw_access | |
255 | ||
256 | int mingw_chdir(const char *dirname); | |
257 | #define chdir mingw_chdir | |
258 | ||
259 | int mingw_chmod(const char *filename, int mode); | |
260 | #define chmod mingw_chmod | |
261 | ||
262 | char *mingw_mktemp(char *template); | |
263 | #define mktemp mingw_mktemp | |
264 | ||
25fe217b JS |
265 | char *mingw_getcwd(char *pointer, int len); |
266 | #define getcwd mingw_getcwd | |
267 | ||
fe21c6b2 JS |
268 | #ifdef NO_UNSETENV |
269 | #error "NO_UNSETENV is incompatible with the Windows-specific startup code!" | |
270 | #endif | |
271 | ||
272 | /* | |
273 | * We bind *env() routines (even the mingw_ ones) to private mingw_ versions. | |
274 | * These talk to the CRT using UNICODE/wchar_t, but maintain the original | |
275 | * narrow-char API. | |
276 | * | |
277 | * Note that the MSCRT maintains both ANSI (getenv()) and UNICODE (_wgetenv()) | |
278 | * routines and stores both versions of each environment variable in parallel | |
279 | * (and secretly updates both when you set one or the other), but it uses CP_ACP | |
280 | * to do the conversion rather than CP_UTF8. | |
281 | * | |
282 | * Since everything in the git code base is UTF8, we define the mingw_ routines | |
283 | * to access the CRT using the UNICODE routines and manually convert them to | |
284 | * UTF8. This also avoids round-trip problems. | |
285 | * | |
286 | * This also helps with our linkage, since "_wenviron" is publicly exported | |
287 | * from the CRT. But to access "_environ" we would have to statically link | |
288 | * to the CRT (/MT). | |
289 | * | |
290 | * We require NO_SETENV (and let gitsetenv() call our mingw_putenv). | |
291 | */ | |
292 | #define getenv mingw_getenv | |
293 | #define putenv mingw_putenv | |
294 | #define unsetenv mingw_putenv | |
6fd6aec4 | 295 | char *mingw_getenv(const char *name); |
fe21c6b2 | 296 | int mingw_putenv(const char *name); |
6fd6aec4 | 297 | |
13d24b01 PT |
298 | int mingw_gethostname(char *host, int namelen); |
299 | #define gethostname mingw_gethostname | |
300 | ||
746fb857 JS |
301 | struct hostent *mingw_gethostbyname(const char *host); |
302 | #define gethostbyname mingw_gethostbyname | |
303 | ||
fe3b2b7b MS |
304 | int mingw_getaddrinfo(const char *node, const char *service, |
305 | const struct addrinfo *hints, struct addrinfo **res); | |
306 | #define getaddrinfo mingw_getaddrinfo | |
307 | ||
746fb857 JS |
308 | int mingw_socket(int domain, int type, int protocol); |
309 | #define socket mingw_socket | |
310 | ||
311 | int mingw_connect(int sockfd, struct sockaddr *sa, size_t sz); | |
312 | #define connect mingw_connect | |
313 | ||
772991af MP |
314 | int mingw_bind(int sockfd, struct sockaddr *sa, size_t sz); |
315 | #define bind mingw_bind | |
316 | ||
317 | int mingw_setsockopt(int sockfd, int lvl, int optname, void *optval, int optlen); | |
318 | #define setsockopt mingw_setsockopt | |
319 | ||
a7941795 JS |
320 | int mingw_shutdown(int sockfd, int how); |
321 | #define shutdown mingw_shutdown | |
322 | ||
772991af MP |
323 | int mingw_listen(int sockfd, int backlog); |
324 | #define listen mingw_listen | |
325 | ||
326 | int mingw_accept(int sockfd, struct sockaddr *sa, socklen_t *sz); | |
327 | #define accept mingw_accept | |
328 | ||
ea9e98c3 JS |
329 | int mingw_rename(const char*, const char*); |
330 | #define rename mingw_rename | |
331 | ||
b1b95204 | 332 | #if defined(USE_WIN32_MMAP) || defined(_MSC_VER) |
b130a72b JL |
333 | int mingw_getpagesize(void); |
334 | #define getpagesize mingw_getpagesize | |
335 | #endif | |
336 | ||
abf38abe NS |
337 | int win32_fsync_no_flush(int fd); |
338 | #define fsync_no_flush win32_fsync_no_flush | |
339 | ||
8a94d833 NS |
340 | #define FSYNC_COMPONENTS_PLATFORM_DEFAULT (FSYNC_COMPONENTS_DEFAULT | FSYNC_COMPONENT_LOOSE_OBJECT) |
341 | #define FSYNC_METHOD_DEFAULT (FSYNC_METHOD_BATCH) | |
342 | ||
38abd9b8 EFL |
343 | struct rlimit { |
344 | unsigned int rlim_cur; | |
345 | }; | |
346 | #define RLIMIT_NOFILE 0 | |
347 | ||
348 | static inline int getrlimit(int resource, struct rlimit *rlp) | |
349 | { | |
350 | if (resource != RLIMIT_NOFILE) { | |
351 | errno = EINVAL; | |
352 | return -1; | |
353 | } | |
354 | ||
355 | rlp->rlim_cur = 2048; | |
356 | return 0; | |
357 | } | |
358 | ||
a2374f58 | 359 | /* |
d7e8c874 KB |
360 | * Use mingw specific stat()/lstat()/fstat() implementations on Windows, |
361 | * including our own struct stat with 64 bit st_size and nanosecond-precision | |
362 | * file times. | |
5411bdc4 | 363 | */ |
3ecd153a | 364 | #ifndef __MINGW64_VERSION_MAJOR |
1d4e4cd4 | 365 | #define off_t off64_t |
1d4e4cd4 | 366 | #define lseek _lseeki64 |
172e54e2 | 367 | #ifndef _MSC_VER |
d7e8c874 KB |
368 | struct timespec { |
369 | time_t tv_sec; | |
370 | long tv_nsec; | |
371 | }; | |
3ecd153a | 372 | #endif |
172e54e2 | 373 | #endif |
a2374f58 | 374 | |
d7e8c874 KB |
375 | struct mingw_stat { |
376 | _dev_t st_dev; | |
377 | _ino_t st_ino; | |
378 | _mode_t st_mode; | |
379 | short st_nlink; | |
380 | short st_uid; | |
381 | short st_gid; | |
382 | _dev_t st_rdev; | |
383 | off64_t st_size; | |
384 | struct timespec st_atim; | |
385 | struct timespec st_mtim; | |
386 | struct timespec st_ctim; | |
387 | }; | |
388 | ||
389 | #define st_atime st_atim.tv_sec | |
390 | #define st_mtime st_mtim.tv_sec | |
391 | #define st_ctime st_ctim.tv_sec | |
392 | ||
fa93bb20 SS |
393 | #ifdef stat |
394 | #undef stat | |
395 | #endif | |
d7e8c874 | 396 | #define stat mingw_stat |
180964f0 | 397 | int mingw_lstat(const char *file_name, struct stat *buf); |
9b9784ca | 398 | int mingw_stat(const char *file_name, struct stat *buf); |
180964f0 | 399 | int mingw_fstat(int fd, struct stat *buf); |
fa93bb20 SS |
400 | #ifdef fstat |
401 | #undef fstat | |
402 | #endif | |
5411bdc4 | 403 | #define fstat mingw_fstat |
fa93bb20 SS |
404 | #ifdef lstat |
405 | #undef lstat | |
406 | #endif | |
5411bdc4 | 407 | #define lstat mingw_lstat |
a2374f58 | 408 | |
5411bdc4 | 409 | |
7c0ffa1c JS |
410 | int mingw_utime(const char *file_name, const struct utimbuf *times); |
411 | #define utime mingw_utime | |
9ee0540a JS |
412 | size_t mingw_strftime(char *s, size_t max, |
413 | const char *format, const struct tm *tm); | |
414 | #define strftime mingw_strftime | |
7c0ffa1c | 415 | |
75301f90 | 416 | pid_t mingw_spawnvpe(const char *cmd, const char **argv, char **env, |
f9a2743c | 417 | const char *dir, |
75301f90 | 418 | int fhin, int fhout, int fherr); |
1696d723 | 419 | int mingw_execvp(const char *cmd, char *const *argv); |
f1a4dfb8 | 420 | #define execvp mingw_execvp |
1696d723 | 421 | int mingw_execv(const char *cmd, char *const *argv); |
5debf9a5 | 422 | #define execv mingw_execv |
f1a4dfb8 | 423 | |
cd800eec SP |
424 | static inline unsigned int git_ntohl(unsigned int x) |
425 | { return (unsigned int)ntohl(x); } | |
426 | #define ntohl git_ntohl | |
427 | ||
6072fc31 JS |
428 | sig_handler_t mingw_signal(int sig, sig_handler_t handler); |
429 | #define signal mingw_signal | |
430 | ||
176478a8 EFL |
431 | int mingw_raise(int sig); |
432 | #define raise mingw_raise | |
433 | ||
c09df8a7 PH |
434 | /* |
435 | * ANSI emulation wrappers | |
436 | */ | |
437 | ||
cbb3f3c9 JS |
438 | int winansi_isatty(int fd); |
439 | #define isatty winansi_isatty | |
440 | ||
ff8978d5 JS |
441 | int winansi_dup2(int oldfd, int newfd); |
442 | #define dup2 winansi_dup2 | |
443 | ||
eac14f89 | 444 | void winansi_init(void); |
eac14f89 | 445 | HANDLE winansi_get_osfhandle(int fd); |
c09df8a7 | 446 | |
80ba074f JS |
447 | /* |
448 | * git specific compatibility | |
449 | */ | |
450 | ||
5ca6b7bb JS |
451 | static inline void convert_slashes(char *path) |
452 | { | |
453 | for (; *path; path++) | |
454 | if (*path == '\\') | |
455 | *path = '/'; | |
456 | } | |
80ba074f | 457 | #define PATH_SEP ';' |
7027f508 | 458 | char *mingw_query_user_email(void); |
501afcb8 | 459 | #define query_user_email mingw_query_user_email |
0ef60afd | 460 | #if !defined(__MINGW64_VERSION_MAJOR) && (!defined(_MSC_VER) || _MSC_VER < 1800) |
82f8d969 | 461 | #define PRIuMAX "I64u" |
1562f3be | 462 | #define PRId64 "I64d" |
3ecd153a JS |
463 | #else |
464 | #include <inttypes.h> | |
465 | #endif | |
ba26f296 | 466 | |
bdc77d1d JS |
467 | /** |
468 | * Verifies that the specified path is owned by the user running the | |
469 | * current process. | |
470 | */ | |
17d3883f | 471 | int is_path_owned_by_current_sid(const char *path, struct strbuf *report); |
bdc77d1d JS |
472 | #define is_path_owned_by_current_user is_path_owned_by_current_sid |
473 | ||
d2c84dad JS |
474 | /** |
475 | * Verifies that the given path is a valid one on Windows. | |
476 | * | |
817ddd64 JS |
477 | * In particular, path segments are disallowed which |
478 | * | |
479 | * - end in a period or a space (except the special directories `.` and `..`). | |
480 | * | |
481 | * - contain any of the reserved characters, e.g. `:`, `;`, `*`, etc | |
d2c84dad | 482 | * |
4dc42c6c JS |
483 | * - correspond to reserved names (such as `AUX`, `PRN`, etc) |
484 | * | |
485 | * The `allow_literal_nul` parameter controls whether the path `NUL` should | |
486 | * be considered valid (this makes sense e.g. before opening files, as it is | |
487 | * perfectly legitimate to open `NUL` on Windows, just as it is to open | |
488 | * `/dev/null` on Unix/Linux). | |
489 | * | |
d2c84dad JS |
490 | * Returns 1 upon success, otherwise 0. |
491 | */ | |
4dc42c6c JS |
492 | int is_valid_win32_path(const char *path, int allow_literal_nul); |
493 | #define is_valid_path(path) is_valid_win32_path(path, 0) | |
d2c84dad | 494 | |
1c950a59 KB |
495 | /** |
496 | * Converts UTF-8 encoded string to UTF-16LE. | |
497 | * | |
498 | * To support repositories with legacy-encoded file names, invalid UTF-8 bytes | |
499 | * 0xa0 - 0xff are converted to corresponding printable Unicode chars \u00a0 - | |
500 | * \u00ff, and invalid UTF-8 bytes 0x80 - 0x9f (which would make non-printable | |
501 | * Unicode) are converted to hex-code. | |
502 | * | |
503 | * Lead-bytes not followed by an appropriate number of trail-bytes, over-long | |
504 | * encodings and 4-byte encodings > \u10ffff are detected as invalid UTF-8. | |
505 | * | |
506 | * Maximum space requirement for the target buffer is two wide chars per UTF-8 | |
507 | * char (((strlen(utf) * 2) + 1) [* sizeof(wchar_t)]). | |
508 | * | |
509 | * The maximum space is needed only if the entire input string consists of | |
510 | * invalid UTF-8 bytes in range 0x80-0x9f, as per the following table: | |
511 | * | |
512 | * | | UTF-8 | UTF-16 | | |
513 | * Code point | UTF-8 sequence | bytes | words | ratio | |
514 | * --------------+-------------------+-------+--------+------- | |
515 | * 000000-00007f | 0-7f | 1 | 1 | 1 | |
516 | * 000080-0007ff | c2-df + 80-bf | 2 | 1 | 0.5 | |
517 | * 000800-00ffff | e0-ef + 2 * 80-bf | 3 | 1 | 0.33 | |
518 | * 010000-10ffff | f0-f4 + 3 * 80-bf | 4 | 2 (a) | 0.5 | |
519 | * invalid | 80-9f | 1 | 2 (b) | 2 | |
520 | * invalid | a0-ff | 1 | 1 | 1 | |
521 | * | |
522 | * (a) encoded as UTF-16 surrogate pair | |
523 | * (b) encoded as two hex digits | |
524 | * | |
525 | * Note that, while the UTF-8 encoding scheme can be extended to 5-byte, 6-byte | |
526 | * or even indefinite-byte sequences, the largest valid code point \u10ffff | |
527 | * encodes as only 4 UTF-8 bytes. | |
528 | * | |
529 | * Parameters: | |
530 | * wcs: wide char target buffer | |
531 | * utf: string to convert | |
532 | * wcslen: size of target buffer (in wchar_t's) | |
533 | * utflen: size of string to convert, or -1 if 0-terminated | |
534 | * | |
535 | * Returns: | |
536 | * length of converted string (_wcslen(wcs)), or -1 on failure | |
537 | * | |
538 | * Errors: | |
539 | * EINVAL: one of the input parameters is invalid (e.g. NULL) | |
540 | * ERANGE: the output buffer is too small | |
541 | */ | |
542 | int xutftowcsn(wchar_t *wcs, const char *utf, size_t wcslen, int utflen); | |
543 | ||
544 | /** | |
545 | * Simplified variant of xutftowcsn, assumes input string is \0-terminated. | |
546 | */ | |
547 | static inline int xutftowcs(wchar_t *wcs, const char *utf, size_t wcslen) | |
548 | { | |
549 | return xutftowcsn(wcs, utf, wcslen, -1); | |
550 | } | |
551 | ||
552 | /** | |
553 | * Simplified file system specific variant of xutftowcsn, assumes output | |
554 | * buffer size is MAX_PATH wide chars and input string is \0-terminated, | |
555 | * fails with ENAMETOOLONG if input string is too long. | |
556 | */ | |
557 | static inline int xutftowcs_path(wchar_t *wcs, const char *utf) | |
558 | { | |
559 | int result = xutftowcsn(wcs, utf, MAX_PATH, -1); | |
560 | if (result < 0 && errno == ERANGE) | |
561 | errno = ENAMETOOLONG; | |
562 | return result; | |
563 | } | |
564 | ||
565 | /** | |
566 | * Converts UTF-16LE encoded string to UTF-8. | |
567 | * | |
568 | * Maximum space requirement for the target buffer is three UTF-8 chars per | |
569 | * wide char ((_wcslen(wcs) * 3) + 1). | |
570 | * | |
571 | * The maximum space is needed only if the entire input string consists of | |
572 | * UTF-16 words in range 0x0800-0xd7ff or 0xe000-0xffff (i.e. \u0800-\uffff | |
573 | * modulo surrogate pairs), as per the following table: | |
574 | * | |
575 | * | | UTF-16 | UTF-8 | | |
576 | * Code point | UTF-16 sequence | words | bytes | ratio | |
577 | * --------------+-----------------------+--------+-------+------- | |
578 | * 000000-00007f | 0000-007f | 1 | 1 | 1 | |
579 | * 000080-0007ff | 0080-07ff | 1 | 2 | 2 | |
580 | * 000800-00ffff | 0800-d7ff / e000-ffff | 1 | 3 | 3 | |
581 | * 010000-10ffff | d800-dbff + dc00-dfff | 2 | 4 | 2 | |
582 | * | |
583 | * Note that invalid code points > 10ffff cannot be represented in UTF-16. | |
584 | * | |
585 | * Parameters: | |
586 | * utf: target buffer | |
587 | * wcs: wide string to convert | |
588 | * utflen: size of target buffer | |
589 | * | |
590 | * Returns: | |
591 | * length of converted string, or -1 on failure | |
592 | * | |
593 | * Errors: | |
594 | * EINVAL: one of the input parameters is invalid (e.g. NULL) | |
595 | * ERANGE: the output buffer is too small | |
596 | */ | |
597 | int xwcstoutf(char *utf, const wchar_t *wcs, size_t utflen); | |
598 | ||
657b35f4 RJ |
599 | /* |
600 | * A critical section used in the implementation of the spawn | |
15beaaa3 | 601 | * functions (mingw_spawnv[p]e()) and waitpid(). Initialised in |
657b35f4 RJ |
602 | * the replacement main() macro below. |
603 | */ | |
604 | extern CRITICAL_SECTION pinfo_cs; | |
605 | ||
35eeef47 | 606 | /* |
396ff754 JS |
607 | * Git, like most portable C applications, implements a main() function. On |
608 | * Windows, this main() function would receive parameters encoded in the | |
609 | * current locale, but Git for Windows would prefer UTF-8 encoded parameters. | |
610 | * | |
611 | * To make that happen, we still declare main() here, and then declare and | |
612 | * implement wmain() (which is the Unicode variant of main()) and compile with | |
613 | * -municode. This wmain() function reencodes the parameters from UTF-16 to | |
614 | * UTF-8 format, sets up a couple of other things as required on Windows, and | |
615 | * then hands off to the main() function. | |
35eeef47 | 616 | */ |
396ff754 JS |
617 | int wmain(int argc, const wchar_t **w_argv); |
618 | int main(int argc, const char **argv); | |
e16c60d9 | 619 | |
08809c09 JS |
620 | /* |
621 | * For debugging: if a problem occurs, say, in a Git process that is spawned | |
622 | * from another Git process which in turn is spawned from yet another Git | |
623 | * process, it can be quite daunting to figure out what is going on. | |
624 | * | |
625 | * Call this function to open a new MinTTY (this assumes you are in Git for | |
626 | * Windows' SDK) with a GDB that attaches to the current process right away. | |
627 | */ | |
fcedb379 | 628 | void open_in_gdb(void); |
08809c09 | 629 | |
44626dc7 AH |
630 | /* |
631 | * Used by Pthread API implementation for Windows | |
632 | */ | |
7027f508 | 633 | int err_win_to_posix(DWORD winerr); |
2406bf5f MA |
634 | |
635 | #ifndef NO_UNIX_SOCKETS | |
636 | int mingw_have_unix_sockets(void); | |
637 | #undef have_unix_sockets | |
638 | #define have_unix_sockets mingw_have_unix_sockets | |
639 | #endif |