2 * msvcrt.dll drive/directory functions
4 * Copyright 1996,1998 Marcus Meissner
5 * Copyright 1996 Jukka Iivonen
6 * Copyright 1997,2000 Uwe Bonnes
7 * Copyright 2000 Jon Griffiths
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
25 #include "wine/port.h"
33 #include "wine/unicode.h"
35 #include "wine/debug.h"
37 WINE_DEFAULT_DEBUG_CHANNEL(msvcrt);
39 /* INTERNAL: Translate WIN32_FIND_DATAA to finddata_t */
40 static void msvcrt_fttofd( const WIN32_FIND_DATAA *fd, struct MSVCRT__finddata_t* ft)
44 if (fd->dwFileAttributes == FILE_ATTRIBUTE_NORMAL)
47 ft->attrib = fd->dwFileAttributes;
49 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftCreationTime, &dw );
51 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastAccessTime, &dw );
53 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastWriteTime, &dw );
55 ft->size = fd->nFileSizeLow;
56 strcpy(ft->name, fd->cFileName);
59 /* INTERNAL: Translate WIN32_FIND_DATAW to wfinddata_t */
60 static void msvcrt_wfttofd( const WIN32_FIND_DATAW *fd, struct MSVCRT__wfinddata_t* ft)
64 if (fd->dwFileAttributes == FILE_ATTRIBUTE_NORMAL)
67 ft->attrib = fd->dwFileAttributes;
69 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftCreationTime, &dw );
71 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastAccessTime, &dw );
73 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastWriteTime, &dw );
75 ft->size = fd->nFileSizeLow;
76 strcpyW(ft->name, fd->cFileName);
79 /* INTERNAL: Translate WIN32_FIND_DATAA to finddatai64_t */
80 static void msvcrt_fttofdi64( const WIN32_FIND_DATAA *fd, struct MSVCRT__finddatai64_t* ft)
84 if (fd->dwFileAttributes == FILE_ATTRIBUTE_NORMAL)
87 ft->attrib = fd->dwFileAttributes;
89 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftCreationTime, &dw );
91 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastAccessTime, &dw );
93 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastWriteTime, &dw );
95 ft->size = ((__int64)fd->nFileSizeHigh) << 32 | fd->nFileSizeLow;
96 strcpy(ft->name, fd->cFileName);
99 /* INTERNAL: Translate WIN32_FIND_DATAW to wfinddatai64_t */
100 static void msvcrt_wfttofdi64( const WIN32_FIND_DATAW *fd, struct MSVCRT__wfinddatai64_t* ft)
104 if (fd->dwFileAttributes == FILE_ATTRIBUTE_NORMAL)
107 ft->attrib = fd->dwFileAttributes;
109 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftCreationTime, &dw );
110 ft->time_create = dw;
111 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastAccessTime, &dw );
112 ft->time_access = dw;
113 RtlTimeToSecondsSince1970( (const LARGE_INTEGER *)&fd->ftLastWriteTime, &dw );
115 ft->size = ((__int64)fd->nFileSizeHigh) << 32 | fd->nFileSizeLow;
116 strcpyW(ft->name, fd->cFileName);
119 /*********************************************************************
122 * Change the current working directory.
125 * newdir [I] Directory to change to
128 * Success: 0. The current working directory is set to newdir.
129 * Failure: -1. errno indicates the error.
132 * See SetCurrentDirectoryA.
134 int CDECL _chdir(const char * newdir)
136 if (!SetCurrentDirectoryA(newdir))
138 msvcrt_set_errno(newdir?GetLastError():0);
144 /*********************************************************************
147 * Unicode version of _chdir.
149 int CDECL _wchdir(const MSVCRT_wchar_t * newdir)
151 if (!SetCurrentDirectoryW(newdir))
153 msvcrt_set_errno(newdir?GetLastError():0);
159 /*********************************************************************
160 * _chdrive (MSVCRT.@)
162 * Change the current drive.
165 * newdrive [I] Drive number to change to (1 = 'A', 2 = 'B', ...)
168 * Success: 0. The current drive is set to newdrive.
169 * Failure: -1. errno indicates the error.
172 * See SetCurrentDirectoryA.
174 int CDECL _chdrive(int newdrive)
176 WCHAR buffer[3] = {'A', ':', 0};
178 buffer[0] += newdrive - 1;
179 if (!SetCurrentDirectoryW( buffer ))
181 msvcrt_set_errno(GetLastError());
183 *MSVCRT__errno() = MSVCRT_EACCES;
189 /*********************************************************************
190 * _findclose (MSVCRT.@)
192 * Close a handle returned by _findfirst().
195 * hand [I] Handle to close
198 * Success: 0. All resources associated with hand are freed.
199 * Failure: -1. errno indicates the error.
204 int CDECL MSVCRT__findclose(long hand)
206 TRACE(":handle %ld\n",hand);
207 if (!FindClose((HANDLE)hand))
209 msvcrt_set_errno(GetLastError());
215 /*********************************************************************
216 * _findfirst (MSVCRT.@)
218 * Open a handle for iterating through a directory.
221 * fspec [I] File specification of files to iterate.
222 * ft [O] Information for the first file found.
225 * Success: A handle suitable for passing to _findnext() and _findclose().
226 * ft is populated with the details of the found file.
227 * Failure: -1. errno indicates the error.
230 * See FindFirstFileA.
232 long CDECL MSVCRT__findfirst(const char * fspec, struct MSVCRT__finddata_t* ft)
234 WIN32_FIND_DATAA find_data;
237 hfind = FindFirstFileA(fspec, &find_data);
238 if (hfind == INVALID_HANDLE_VALUE)
240 msvcrt_set_errno(GetLastError());
243 msvcrt_fttofd(&find_data,ft);
244 TRACE(":got handle %p\n",hfind);
248 /*********************************************************************
249 * _wfindfirst (MSVCRT.@)
251 * Unicode version of _findfirst.
253 long CDECL MSVCRT__wfindfirst(const MSVCRT_wchar_t * fspec, struct MSVCRT__wfinddata_t* ft)
255 WIN32_FIND_DATAW find_data;
258 hfind = FindFirstFileW(fspec, &find_data);
259 if (hfind == INVALID_HANDLE_VALUE)
261 msvcrt_set_errno(GetLastError());
264 msvcrt_wfttofd(&find_data,ft);
265 TRACE(":got handle %p\n",hfind);
269 /*********************************************************************
270 * _findfirsti64 (MSVCRT.@)
272 * 64-bit version of _findfirst.
274 long CDECL MSVCRT__findfirsti64(const char * fspec, struct MSVCRT__finddatai64_t* ft)
276 WIN32_FIND_DATAA find_data;
279 hfind = FindFirstFileA(fspec, &find_data);
280 if (hfind == INVALID_HANDLE_VALUE)
282 msvcrt_set_errno(GetLastError());
285 msvcrt_fttofdi64(&find_data,ft);
286 TRACE(":got handle %p\n",hfind);
290 /*********************************************************************
291 * _wfindfirsti64 (MSVCRT.@)
293 * Unicode version of _findfirsti64.
295 long CDECL MSVCRT__wfindfirsti64(const MSVCRT_wchar_t * fspec, struct MSVCRT__wfinddatai64_t* ft)
297 WIN32_FIND_DATAW find_data;
300 hfind = FindFirstFileW(fspec, &find_data);
301 if (hfind == INVALID_HANDLE_VALUE)
303 msvcrt_set_errno(GetLastError());
306 msvcrt_wfttofdi64(&find_data,ft);
307 TRACE(":got handle %p\n",hfind);
311 /*********************************************************************
312 * _findnext (MSVCRT.@)
314 * Find the next file from a file search handle.
317 * hand [I] Handle to the search returned from _findfirst().
318 * ft [O] Information for the file found.
321 * Success: 0. ft is populated with the details of the found file.
322 * Failure: -1. errno indicates the error.
327 int CDECL MSVCRT__findnext(long hand, struct MSVCRT__finddata_t * ft)
329 WIN32_FIND_DATAA find_data;
331 if (!FindNextFileA((HANDLE)hand, &find_data))
333 *MSVCRT__errno() = MSVCRT_ENOENT;
337 msvcrt_fttofd(&find_data,ft);
341 /*********************************************************************
342 * _wfindnext (MSVCRT.@)
344 * Unicode version of _findnext.
346 int CDECL MSVCRT__wfindnext(long hand, struct MSVCRT__wfinddata_t * ft)
348 WIN32_FIND_DATAW find_data;
350 if (!FindNextFileW((HANDLE)hand, &find_data))
352 *MSVCRT__errno() = MSVCRT_ENOENT;
356 msvcrt_wfttofd(&find_data,ft);
360 /*********************************************************************
361 * _findnexti64 (MSVCRT.@)
363 * 64-bit version of _findnext.
365 int CDECL MSVCRT__findnexti64(long hand, struct MSVCRT__finddatai64_t * ft)
367 WIN32_FIND_DATAA find_data;
369 if (!FindNextFileA((HANDLE)hand, &find_data))
371 *MSVCRT__errno() = MSVCRT_ENOENT;
375 msvcrt_fttofdi64(&find_data,ft);
379 /*********************************************************************
380 * _wfindnexti64 (MSVCRT.@)
382 * Unicode version of _findnexti64.
384 int CDECL MSVCRT__wfindnexti64(long hand, struct MSVCRT__wfinddatai64_t * ft)
386 WIN32_FIND_DATAW find_data;
388 if (!FindNextFileW((HANDLE)hand, &find_data))
390 *MSVCRT__errno() = MSVCRT_ENOENT;
394 msvcrt_wfttofdi64(&find_data,ft);
398 /*********************************************************************
401 * Get the current working directory.
404 * buf [O] Destination for current working directory.
405 * size [I] Size of buf in characters
408 * Success: If buf is NULL, returns an allocated string containing the path.
409 * Otherwise populates buf with the path and returns it.
410 * Failure: NULL. errno indicates the error.
412 char* CDECL _getcwd(char * buf, int size)
415 int dir_len = GetCurrentDirectoryA(MAX_PATH,dir);
418 return NULL; /* FIXME: Real return value untested */
424 return msvcrt_strndup(dir,size);
428 *MSVCRT__errno() = MSVCRT_ERANGE;
429 return NULL; /* buf too small */
435 /*********************************************************************
436 * _wgetcwd (MSVCRT.@)
438 * Unicode version of _getcwd.
440 MSVCRT_wchar_t* CDECL _wgetcwd(MSVCRT_wchar_t * buf, int size)
442 MSVCRT_wchar_t dir[MAX_PATH];
443 int dir_len = GetCurrentDirectoryW(MAX_PATH,dir);
446 return NULL; /* FIXME: Real return value untested */
452 return msvcrt_wstrndup(dir,size);
456 *MSVCRT__errno() = MSVCRT_ERANGE;
457 return NULL; /* buf too small */
463 /*********************************************************************
464 * _getdrive (MSVCRT.@)
466 * Get the current drive number.
472 * Success: The drive letter number from 1 to 26 ("A:" to "Z:").
475 int CDECL _getdrive(void)
477 WCHAR buffer[MAX_PATH];
478 if (GetCurrentDirectoryW( MAX_PATH, buffer ) &&
479 buffer[0] >= 'A' && buffer[0] <= 'z' && buffer[1] == ':')
480 return toupperW(buffer[0]) - 'A' + 1;
484 /*********************************************************************
485 * _getdcwd (MSVCRT.@)
487 * Get the current working directory on a given disk.
490 * drive [I] Drive letter to get the current working directory from.
491 * buf [O] Destination for the current working directory.
492 * size [I] Length of drive in characters.
495 * Success: If drive is NULL, returns an allocated string containing the path.
496 * Otherwise populates drive with the path and returns it.
497 * Failure: NULL. errno indicates the error.
499 char* CDECL _getdcwd(int drive, char * buf, int size)
503 TRACE(":drive %d(%c), size %d\n",drive, drive + 'A' - 1, size);
505 if (!drive || drive == _getdrive())
506 return _getcwd(buf,size); /* current */
510 char drivespec[4] = {'A', ':', 0};
513 drivespec[0] += drive - 1;
514 if (GetDriveTypeA(drivespec) < DRIVE_REMOVABLE)
516 *MSVCRT__errno() = MSVCRT_EACCES;
520 dir_len = GetFullPathNameA(drivespec,MAX_PATH,dir,&dummy);
521 if (dir_len >= size || dir_len < 1)
523 *MSVCRT__errno() = MSVCRT_ERANGE;
524 return NULL; /* buf too small */
527 TRACE(":returning '%s'\n", dir);
529 return _strdup(dir); /* allocate */
536 /*********************************************************************
537 * _wgetdcwd (MSVCRT.@)
539 * Unicode version of _wgetdcwd.
541 MSVCRT_wchar_t* CDECL _wgetdcwd(int drive, MSVCRT_wchar_t * buf, int size)
543 static MSVCRT_wchar_t* dummy;
545 TRACE(":drive %d(%c), size %d\n",drive, drive + 'A' - 1, size);
547 if (!drive || drive == _getdrive())
548 return _wgetcwd(buf,size); /* current */
551 MSVCRT_wchar_t dir[MAX_PATH];
552 MSVCRT_wchar_t drivespec[4] = {'A', ':', '\\', 0};
555 drivespec[0] += drive - 1;
556 if (GetDriveTypeW(drivespec) < DRIVE_REMOVABLE)
558 *MSVCRT__errno() = MSVCRT_EACCES;
562 dir_len = GetFullPathNameW(drivespec,MAX_PATH,dir,&dummy);
563 if (dir_len >= size || dir_len < 1)
565 *MSVCRT__errno() = MSVCRT_ERANGE;
566 return NULL; /* buf too small */
569 TRACE(":returning %s\n", debugstr_w(dir));
571 return _wcsdup(dir); /* allocate */
577 /*********************************************************************
578 * _getdiskfree (MSVCRT.@)
580 * Get information about the free space on a drive.
583 * disk [I] Drive number to get information about (1 = 'A', 2 = 'B', ...)
584 * info [O] Destination for the resulting information.
587 * Success: 0. info is updated with the free space information.
588 * Failure: An error code from GetLastError().
591 * See GetLastError().
593 unsigned int CDECL MSVCRT__getdiskfree(unsigned int disk, struct MSVCRT__diskfree_t * d)
595 WCHAR drivespec[4] = {'@', ':', '\\', 0};
600 return ERROR_INVALID_PARAMETER; /* MSVCRT doesn't set errno here */
602 drivespec[0] += disk; /* make a drive letter */
604 if (GetDiskFreeSpaceW(disk==0?NULL:drivespec,ret,ret+1,ret+2,ret+3))
606 d->sectors_per_cluster = (unsigned)ret[0];
607 d->bytes_per_sector = (unsigned)ret[1];
608 d->avail_clusters = (unsigned)ret[2];
609 d->total_clusters = (unsigned)ret[3];
612 err = GetLastError();
613 msvcrt_set_errno(err);
617 /*********************************************************************
620 * Create a directory.
623 * newdir [I] Name of directory to create.
626 * Success: 0. The directory indicated by newdir is created.
627 * Failure: -1. errno indicates the error.
630 * See CreateDirectoryA.
632 int CDECL _mkdir(const char * newdir)
634 if (CreateDirectoryA(newdir,NULL))
636 msvcrt_set_errno(GetLastError());
640 /*********************************************************************
643 * Unicode version of _mkdir.
645 int CDECL _wmkdir(const MSVCRT_wchar_t* newdir)
647 if (CreateDirectoryW(newdir,NULL))
649 msvcrt_set_errno(GetLastError());
653 /*********************************************************************
656 * Delete a directory.
659 * dir [I] Name of directory to delete.
662 * Success: 0. The directory indicated by newdir is deleted.
663 * Failure: -1. errno indicates the error.
666 * See RemoveDirectoryA.
668 int CDECL _rmdir(const char * dir)
670 if (RemoveDirectoryA(dir))
672 msvcrt_set_errno(GetLastError());
676 /*********************************************************************
679 * Unicode version of _rmdir.
681 int CDECL _wrmdir(const MSVCRT_wchar_t * dir)
683 if (RemoveDirectoryW(dir))
685 msvcrt_set_errno(GetLastError());
689 /*********************************************************************
690 * _wsplitpath (MSVCRT.@)
692 * Unicode version of _splitpath.
694 void CDECL _wsplitpath(const MSVCRT_wchar_t *inpath, MSVCRT_wchar_t *drv, MSVCRT_wchar_t *dir,
695 MSVCRT_wchar_t *fname, MSVCRT_wchar_t *ext )
697 const MSVCRT_wchar_t *p, *end;
699 if (inpath[0] && inpath[1] == ':')
709 else if (drv) drv[0] = 0;
711 /* look for end of directory part */
713 for (p = inpath; *p; p++) if (*p == '/' || *p == '\\') end = p + 1;
715 if (end) /* got a directory */
719 memcpy( dir, inpath, (end - inpath) * sizeof(MSVCRT_wchar_t) );
720 dir[end - inpath] = 0;
724 else if (dir) dir[0] = 0;
726 /* look for extension: what's after the last dot */
728 for (p = inpath; *p; p++) if (*p == '.') end = p;
730 if (!end) end = p; /* there's no extension */
734 memcpy( fname, inpath, (end - inpath) * sizeof(MSVCRT_wchar_t) );
735 fname[end - inpath] = 0;
737 if (ext) strcpyW( ext, end );
740 /*********************************************************************
741 * _wfullpath (MSVCRT.@)
743 * Unicode version of _fullpath.
745 MSVCRT_wchar_t * CDECL _wfullpath(MSVCRT_wchar_t * absPath, const MSVCRT_wchar_t* relPath, MSVCRT_size_t size)
750 BOOL alloced = FALSE;
752 if (!relPath || !*relPath)
753 return _wgetcwd(absPath, size);
757 buffer = MSVCRT_malloc(MAX_PATH * sizeof(WCHAR));
766 *MSVCRT__errno() = MSVCRT_ERANGE;
770 TRACE(":resolving relative path %s\n",debugstr_w(relPath));
772 rc = GetFullPathNameW(relPath,size,buffer,&lastpart);
774 if (rc > 0 && rc <= size )
784 /*********************************************************************
785 * _fullpath (MSVCRT.@)
787 * Create an absolute path from a relative path.
790 * absPath [O] Destination for absolute path
791 * relPath [I] Relative path to convert to absolute
792 * size [I] Length of absPath in characters.
795 * Success: If absPath is NULL, returns an allocated string containing the path.
796 * Otherwise populates absPath with the path and returns it.
797 * Failure: NULL. errno indicates the error.
799 char * CDECL _fullpath(char * absPath, const char* relPath, unsigned int size)
804 BOOL alloced = FALSE;
806 if (!relPath || !*relPath)
807 return _getcwd(absPath, size);
811 buffer = MSVCRT_malloc(MAX_PATH);
820 *MSVCRT__errno() = MSVCRT_ERANGE;
824 TRACE(":resolving relative path '%s'\n",relPath);
826 rc = GetFullPathNameA(relPath,size,buffer,&lastpart);
828 if (rc > 0 && rc <= size)
838 /*********************************************************************
839 * _makepath (MSVCRT.@)
844 * path [O] Destination for created pathname
845 * drive [I] Drive letter (e.g. "A:")
846 * directory [I] Directory
847 * filename [I] Name of the file, excluding extension
848 * extension [I] File extension (e.g. ".TXT")
851 * Nothing. If path is not large enough to hold the resulting pathname,
852 * random process memory will be overwritten.
854 VOID CDECL _makepath(char * path, const char * drive,
855 const char *directory, const char * filename,
856 const char * extension)
860 TRACE("(%s %s %s %s)\n", debugstr_a(drive), debugstr_a(directory),
861 debugstr_a(filename), debugstr_a(extension) );
867 if (drive && drive[0])
873 if (directory && directory[0])
875 strcat(path, directory);
876 ch = path[strlen(path)-1];
877 if (ch != '/' && ch != '\\')
880 if (filename && filename[0])
882 strcat(path, filename);
883 if (extension && extension[0])
885 if ( extension[0] != '.' )
887 strcat(path,extension);
890 TRACE("returning %s\n",path);
893 /*********************************************************************
894 * _wmakepath (MSVCRT.@)
896 * Unicode version of _wmakepath.
898 VOID CDECL _wmakepath(MSVCRT_wchar_t *path, const MSVCRT_wchar_t *drive, const MSVCRT_wchar_t *directory,
899 const MSVCRT_wchar_t *filename, const MSVCRT_wchar_t *extension)
902 TRACE("%s %s %s %s\n", debugstr_w(drive), debugstr_w(directory),
903 debugstr_w(filename), debugstr_w(extension));
909 if (drive && drive[0])
915 if (directory && directory[0])
917 strcatW(path, directory);
918 ch = path[strlenW(path) - 1];
919 if (ch != '/' && ch != '\\')
921 static const MSVCRT_wchar_t backslashW[] = {'\\',0};
922 strcatW(path, backslashW);
925 if (filename && filename[0])
927 strcatW(path, filename);
928 if (extension && extension[0])
930 if ( extension[0] != '.' )
932 static const MSVCRT_wchar_t dotW[] = {'.',0};
935 strcatW(path, extension);
939 TRACE("returning %s\n", debugstr_w(path));
942 /*********************************************************************
943 * _searchenv (MSVCRT.@)
945 * Search for a file in a list of paths from an envronment variable.
948 * file [I] Name of the file to search for.
949 * env [I] Name of the environment variable containing a list of paths.
950 * buf [O] Destination for the found file path.
953 * Nothing. If the file is not found, buf will contain an empty string
956 void CDECL _searchenv(const char* file, const char* env, char *buf)
959 char curPath[MAX_PATH];
964 if (GetFileAttributesA( file ) != INVALID_FILE_ATTRIBUTES)
966 GetFullPathNameA( file, MAX_PATH, buf, NULL );
967 /* Sigh. This error is *always* set, regardless of success */
968 msvcrt_set_errno(ERROR_FILE_NOT_FOUND);
972 /* Search given environment variable */
973 envVal = MSVCRT_getenv(env);
976 msvcrt_set_errno(ERROR_FILE_NOT_FOUND);
981 TRACE(":searching for %s in paths %s\n", file, envVal);
987 while(*end && *end != ';') end++; /* Find end of next path */
988 if (penv == end || !*penv)
990 msvcrt_set_errno(ERROR_FILE_NOT_FOUND);
993 memcpy(curPath, penv, end - penv);
994 if (curPath[end - penv] != '/' || curPath[end - penv] != '\\')
996 curPath[end - penv] = '\\';
997 curPath[end - penv + 1] = '\0';
1000 curPath[end - penv] = '\0';
1002 strcat(curPath, file);
1003 TRACE("Checking for file %s\n", curPath);
1004 if (GetFileAttributesA( curPath ) != INVALID_FILE_ATTRIBUTES)
1006 strcpy(buf, curPath);
1007 msvcrt_set_errno(ERROR_FILE_NOT_FOUND);
1010 penv = *end ? end + 1 : end;