1 /* path.cc: path support.
3 This file is part of Cygwin.
5 This software is a copyrighted work licensed under the terms of the
6 Cygwin license. Please consult the file "CYGWIN_LICENSE" for
9 /* This module's job is to
10 - convert between POSIX and Win32 style filenames,
11 - support the `mount' functionality,
12 - support symlinks for files and directories
14 Pathnames are handled as follows:
16 - A \ or : in a path denotes a pure windows spec.
17 - Paths beginning with // (or \\) are not translated (i.e. looked
18 up in the mount table) and are assumed to be UNC path names.
20 The goal in the above set of rules is to allow both POSIX and Win32
21 flavors of pathnames without either interfering. The rules are
22 intended to be as close to a superset of both as possible.
24 Note that you can have more than one path to a file. The mount
25 table is always prefered when translating Win32 paths to POSIX
26 paths. Win32 paths in mount table entries may be UNC paths or
27 standard Win32 paths starting with <drive-letter>:
29 Text vs Binary issues are not considered here in path style
30 decisions, although the appropriate flags are retrieved and
31 stored in various structures.
33 Removing mounted filesystem support would simplify things greatly,
34 but having it gives us a mechanism of treating disk that lives on a
35 UNIX machine as having UNIX semantics [it allows one to edit a text
36 file on that disk and not have cr's magically appear and perhaps
37 break apps running on UNIX boxes]. It also useful to be able to
38 layout a hierarchy without changing the underlying directories.
40 The semantics of mounting file systems is not intended to precisely
41 follow normal UNIX systems.
43 Each DOS drive is defined to have a current directory. Supporting
44 this would complicate things so for now things are defined so that
48 /* This file includes both the XPG and GNU basename functions, with the
49 former exported as "basename" for ABI compatibility but the latter
50 declared as such for source compatibility with glibc. This tells
51 <string.h> not to declare the GNU variant in order to prevent a conflicting
52 declaration error with the XPG variant implemented herein. */
53 #define basename basename
55 #include <w32api/winioctl.h>
56 #include <w32api/shlobj.h>
57 #include <sys/param.h>
58 #include <sys/cygwin.h>
66 #include "shared_info.h"
71 suffix_info stat_suffixes
[] =
80 char contents
[SYMLINK_MAX
+ 1];
85 unsigned _mount_flags
;
86 unsigned _pc_flags
; /* Relevant pathconv_arg flags from path_conv caller */
98 /* mount_flags is an incoming value set in path_conv */
100 int check (char *path
, const suffix_info
*suffixes
, fs_info
&fs
,
101 path_conv_handle
&conv_hdl
);
102 int set (char *path
);
103 bool parse_device (const char *);
104 int check_sysfile (HANDLE h
);
105 int check_shortcut (HANDLE h
);
106 int check_reparse_point (HANDLE h
, bool remote
);
107 int check_nfs_symlink (HANDLE h
);
108 int posixify (char *srcbuf
);
109 bool set_error (int);
111 bool has_ext () const { return ext_here
&& *ext_here
; }
112 char *ext () const { return ext_here
; }
113 bool ext_tacked_on () const { return _ext_tacked_on
; }
114 void ext_tacked_on (bool _neto
) { _ext_tacked_on
= _neto
; }
115 const char *content () const { return contents
; }
116 void clear_content () { contents
[0] = '\0'; }
117 size_t path_len () const { return _path_len
; }
118 void path_len (size_t _pl
) { _path_len
= _pl
; }
119 unsigned path_flags () const { return _path_flags
; }
120 void path_flags (unsigned _pflags
) { _path_flags
= _pflags
; }
121 unsigned mount_flags () const { return _mount_flags
; }
122 void mount_flags (unsigned _mflags
) { _mount_flags
= _mflags
; }
123 unsigned pc_flags () const { return _pc_flags
; }
124 void pc_flags (unsigned _pflags
) { _pc_flags
= _pflags
; }
125 unsigned fileattr () const { return _fileattr
; }
126 void fileattr (unsigned _fflags
) { _fileattr
= _fflags
; }
127 bool issymlink () const { return _issymlink
; }
128 void issymlink (bool _is
) { _issymlink
= _is
; }
129 int error () const { return _error
; }
130 void error (int _err
) { _error
= _err
; }
131 bool isdevice () const { return _dev
!= FH_NADA
; }
132 dev_t
dev () const { return _dev
; }
133 void dev (dev_t _ndev
) { _dev
= _ndev
; }
134 __mode_t
mode () const { return _mode
; }
135 void mode (__mode_t _nmode
) { _mode
= _nmode
; }
138 SRWLOCK NO_COPY
cwdstuff::cwd_lock
;
140 static const GUID GUID_shortcut
141 = { 0x00021401L
, 0, 0, {0xc0, 0, 0, 0, 0, 0, 0, 0x46}};
145 WSH_FLAG_IDLIST
= 0x01, /* Contains an ITEMIDLIST. */
146 WSH_FLAG_FILE
= 0x02, /* Contains a file locator element. */
147 WSH_FLAG_DESC
= 0x04, /* Contains a description. */
148 WSH_FLAG_RELPATH
= 0x08, /* Contains a relative path. */
149 WSH_FLAG_WD
= 0x10, /* Contains a working dir. */
150 WSH_FLAG_CMDLINE
= 0x20, /* Contains command line args. */
151 WSH_FLAG_ICON
= 0x40 /* Contains a custom icon. */
154 struct win_shortcut_hdr
156 DWORD size
; /* Header size in bytes. Must contain 0x4c. */
157 GUID magic
; /* GUID of shortcut files. */
158 DWORD flags
; /* Content flags. See above. */
160 /* The next fields from attr to icon_no are always set to 0 in Cygwin
161 and U/Win shortcuts. */
162 DWORD attr
; /* Target file attributes. */
163 FILETIME ctime
; /* These filetime items are never touched by the */
164 FILETIME mtime
; /* system, apparently. Values don't matter. */
166 DWORD filesize
; /* Target filesize. */
167 DWORD icon_no
; /* Icon number. */
169 DWORD run
; /* Values defined in winuser.h. Use SW_NORMAL. */
170 DWORD hotkey
; /* Hotkey value. Set to 0. */
171 DWORD dummy
[2]; /* Future extension probably. Always 0. */
174 /* Return non-zero if PATH1 is a prefix of PATH2.
175 Both are assumed to be of the same path style and / vs \ usage.
177 LEN1 = strlen (PATH1). It's passed because often it's already known.
180 /foo/ is a prefix of /foo <-- may seem odd, but desired
181 /foo is a prefix of /foo/
182 / is a prefix of /foo/bar
183 / is not a prefix of foo/bar
184 foo/ is a prefix foo/bar
185 /foo is not a prefix of /foobar
189 path_prefix_p (const char *path1
, const char *path2
, int len1
,
190 bool caseinsensitive
)
192 /* Handle case where PATH1 has trailing '/' and when it doesn't. */
193 if (len1
> 0 && isdirsep (path1
[len1
- 1]))
197 return isdirsep (path2
[0]) && !isdirsep (path2
[1]);
199 if (isdirsep (path2
[len1
]) || path2
[len1
] == 0 || path1
[len1
- 1] == ':')
200 return caseinsensitive
? strncasematch (path1
, path2
, len1
)
201 : !strncmp (path1
, path2
, len1
);
206 /* Return non-zero if paths match in first len chars.
207 Check is dependent of the case sensitivity setting. */
209 pathnmatch (const char *path1
, const char *path2
, int len
, bool caseinsensitive
)
211 return caseinsensitive
212 ? strncasematch (path1
, path2
, len
) : !strncmp (path1
, path2
, len
);
215 /* Return non-zero if paths match. Check is dependent of the case
216 sensitivity setting. */
218 pathmatch (const char *path1
, const char *path2
, bool caseinsensitive
)
220 return caseinsensitive
221 ? strcasematch (path1
, path2
) : !strcmp (path1
, path2
);
224 /* TODO: This function is used in mkdir and rmdir to generate correct
225 error messages in case of paths ending in /. or /.. components.
226 Right now, normalize_posix_path will just normalize
227 those components away, which changes the semantics. */
229 has_dot_last_component (const char *dir
, bool test_dot_dot
)
231 /* SUSv3: . and .. are not allowed as last components in various system
232 calls. Don't test for backslash path separator since that's a Win32
233 path following Win32 rules. */
234 const char *last_comp
= strchr (dir
, '\0');
236 if (last_comp
== dir
)
237 return false; /* Empty string. Probably shouldn't happen here? */
239 /* Detect run of trailing slashes */
240 while (last_comp
> dir
&& *--last_comp
== '/')
243 /* Detect just a run of slashes or a path that does not end with a slash. */
244 if (*last_comp
!= '.')
247 /* We know we have a trailing dot here. Check that it really is a standalone "."
248 path component by checking that it is at the beginning of the string or is
250 if (last_comp
== dir
|| *--last_comp
== '/')
253 /* If we're not checking for '..' we're done. Ditto if we're now pointing to
255 if (!test_dot_dot
|| *last_comp
!= '.')
256 return false; /* either not testing for .. or this was not '..' */
258 /* Repeat previous test for standalone or path component. */
259 return last_comp
== dir
|| last_comp
[-1] == '/';
262 /* Normalize a POSIX path.
263 All duplicate /'s, except for 2 leading /'s, are deleted.
264 The result is 0 for success, or an errno error value. */
267 normalize_posix_path (const char *src
, char *dst
, char *&tail
)
269 const char *in_src
= src
;
270 char *dst_start
= dst
;
271 bool check_parent
= false;
272 syscall_printf ("src %s", src
);
274 if ((isdrive (src
) && isdirsep (src
[2])) || *src
== '\\')
278 if (!isslash (src
[0]))
280 if (!cygheap
->cwd
.get (dst
))
282 tail
= strchr (tail
, '\0');
283 if (isslash (dst
[0]) && isslash (dst
[1]))
287 if (tail
== dst_start
+ 1 && *dst_start
== '/')
291 if (tail
> dst
&& !isslash (tail
[-1]))
294 /* Two leading /'s? If so, preserve them. */
295 else if (isslash (src
[1]) && !isslash (src
[2]))
305 /* Strip runs of /'s. */
327 if (!isslash (src
[1]))
330 else if (src
[2] && !isslash (src
[2]))
334 /* According to POSIX semantics all elements of path must
335 exist. To follow it, we must validate our path before
336 removing the trailing component. Check_parent is needed
337 for performance optimization, in order not to verify paths
338 which are already verified. For example this prevents
339 double check in case of foo/bar/../.. */
342 if (tail
> dst_start
) /* Don't check for / or // dir. */
345 debug_printf ("checking %s before '..'", dst
);
346 /* In conjunction with native and NFS symlinks,
347 this call can result in a recursion which eats
348 up our tmp_pathbuf buffers. This in turn results
349 in a api_fatal call. To avoid that, we're
350 checking our remaining buffers and return an
351 error code instead. Note that this only happens
352 if the path contains 15 or more relative native/NFS
353 symlinks with a ".." in the target path. */
355 if (!tp
.check_usage (4, 3))
357 path_conv
head (dst
, PC_SYM_FOLLOW
| PC_POSIX
);
362 /* At this point, dst is a normalized path. If the
363 normalized path created by path_conv does not
364 match the normalized path we're just testing, then
365 the path in dst contains native symlinks. If we
366 just plunge along, removing the previous path
367 component, we may end up removing a symlink from
368 the path and the resulting path will be invalid.
369 So we replace dst with what we found in head
370 instead. All the work replacing symlinks has been
371 done in that path anyway, so why repeat it? */
372 tail
= stpcpy (dst
, head
.get_posix ());
374 check_parent
= false;
376 while (tail
> dst_start
&& !isslash (*--tail
))
384 if ((tail
- dst
) >= NT_MAX_PATH
)
386 debug_printf ("ENAMETOOLONG = normalize_posix_path (%s)", src
);
394 debug_printf ("%s = normalize_posix_path (%s)", dst
, in_src
);
398 int err
= normalize_win32_path (in_src
, dst
, tail
);
400 for (char *p
= dst
; (p
= strchr (p
, '\\')); p
++)
406 path_conv::add_ext_from_sym (symlink_info
&sym
)
410 suffix
= path
+ sym
.path_len ();
411 if (sym
.ext_tacked_on ())
412 strcpy ((char *) suffix
, sym
.ext ());
416 static void mkrelpath (char *dst
, bool caseinsensitive
);
419 mkrelpath (char *path
, bool caseinsensitive
)
422 char *cwd_win32
= tp
.c_get ();
423 if (!cygheap
->cwd
.get (cwd_win32
, 0))
426 unsigned cwdlen
= strlen (cwd_win32
);
427 if (!path_prefix_p (cwd_win32
, path
, cwdlen
, caseinsensitive
))
430 size_t n
= strlen (path
);
438 tail
+= isdirsep (cwd_win32
[cwdlen
- 1]) ? cwdlen
: cwdlen
+ 1;
440 memmove (path
, tail
, strlen (tail
) + 1);
446 path_conv::set_posix (const char *path_copy
)
450 size_t n
= strlen (path_copy
) + 1;
451 char *p
= (char *) crealloc_abort ((void *) posix_path
, n
);
452 posix_path
= (const char *) memcpy (p
, path_copy
, n
);
457 str2uni_cat (UNICODE_STRING
&tgt
, const char *srcstr
)
459 int len
= sys_mbstowcs (tgt
.Buffer
+ tgt
.Length
/ sizeof (WCHAR
),
460 (tgt
.MaximumLength
- tgt
.Length
) / sizeof (WCHAR
),
463 tgt
.Length
+= (len
- 1) * sizeof (WCHAR
);
467 get_nt_native_path (const char *path
, UNICODE_STRING
& upath
, bool dos
)
470 if (path
[0] == '/') /* special path w/o NT path representation. */
471 str2uni_cat (upath
, path
);
472 else if (path
[0] != '\\') /* X:\... or relative path. */
474 if (path
[1] == ':') /* X:\... */
476 RtlAppendUnicodeStringToString (&upath
, &ro_u_natp
);
477 str2uni_cat (upath
, path
);
478 /* The drive letter must be upper case. */
479 upath
.Buffer
[4] = towupper (upath
.Buffer
[4]);
480 transform_chars (&upath
, 7);
482 else /* relative path */
484 str2uni_cat (upath
, path
);
485 transform_chars (&upath
, 0);
488 else if (path
[1] != '\\') /* \Device\... */
489 str2uni_cat (upath
, path
);
490 else if ((path
[2] != '.' && path
[2] != '?')
491 || path
[3] != '\\') /* \\server\share\... */
493 RtlAppendUnicodeStringToString (&upath
, &ro_u_uncp
);
494 str2uni_cat (upath
, path
+ 2);
495 transform_chars (&upath
, 8);
497 else /* \\.\device or \\?\foo */
499 RtlAppendUnicodeStringToString (&upath
, &ro_u_natp
);
500 str2uni_cat (upath
, path
+ 4);
504 /* Unfortunately we can't just use transform_chars with the tfx_rev_chars
505 table since only leading and trailing spaces and dots are affected.
506 So we step to every backslash and fix surrounding dots and spaces.
507 That makes these broken filesystems a bit slower, but, hey. */
508 PWCHAR cp
= upath
.Buffer
+ 7;
509 PWCHAR cend
= upath
.Buffer
+ upath
.Length
/ sizeof (WCHAR
);
514 while (*ccp
== L
'.' || *ccp
== L
' ')
516 while (cp
[1] == L
' ')
519 while (*--cp
== L
'.' || *cp
== L
' ')
525 /* Handle with extrem care! Only used in a certain instance in try_to_bin.
526 Every other usage needs a careful check. */
528 path_conv::set_nt_native_path (PUNICODE_STRING new_path
)
530 wide_path
= (PWCHAR
) crealloc_abort (wide_path
, new_path
->MaximumLength
);
531 memcpy (wide_path
, new_path
->Buffer
, new_path
->Length
);
532 uni_path
.Length
= new_path
->Length
;
533 uni_path
.MaximumLength
= new_path
->MaximumLength
;
534 uni_path
.Buffer
= wide_path
;
537 /* If suffix is not NULL, append the suffix string verbatim.
538 This is used by fhandler_mqueue::mq_open to append an NTFS stream suffix. */
540 path_conv::get_nt_native_path (PUNICODE_STRING suffix
)
550 uni_path
.MaximumLength
= (strlen (path
) + 10) * sizeof (WCHAR
);
552 uni_path
.MaximumLength
+= suffix
->Length
;
553 wide_path
= (PWCHAR
) cmalloc_abort (HEAP_STR
, uni_path
.MaximumLength
);
554 uni_path
.Buffer
= wide_path
;
555 ::get_nt_native_path (path
, uni_path
, has_dos_filenames_only ());
557 RtlAppendUnicodeStringToString (&uni_path
, suffix
);
564 path_conv::get_wide_win32_path (PWCHAR wc
)
566 get_nt_native_path ();
569 wcpcpy (wc
, wide_path
);
576 getfileattr (const char *path
, bool caseinsensitive
) /* path has to be always absolute. */
579 UNICODE_STRING upath
;
580 OBJECT_ATTRIBUTES attr
;
581 FILE_BASIC_INFORMATION fbi
;
586 InitializeObjectAttributes (&attr
, &upath
,
587 caseinsensitive
? OBJ_CASE_INSENSITIVE
: 0,
589 get_nt_native_path (path
, upath
, false);
591 status
= NtQueryAttributesFile (&attr
, &fbi
);
592 if (NT_SUCCESS (status
))
593 return fbi
.FileAttributes
;
595 if (status
!= STATUS_OBJECT_NAME_NOT_FOUND
596 && status
!= STATUS_NO_SUCH_FILE
) /* File not found on 9x share */
598 /* File exists but access denied. Try to get attribute through
600 UNICODE_STRING dirname
, basename
;
602 FILE_BOTH_DIR_INFORMATION fdi
;
604 RtlSplitUnicodePath (&upath
, &dirname
, &basename
);
605 InitializeObjectAttributes (&attr
, &dirname
,
606 caseinsensitive
? OBJ_CASE_INSENSITIVE
: 0,
608 status
= NtOpenFile (&dir
, SYNCHRONIZE
| FILE_LIST_DIRECTORY
,
609 &attr
, &io
, FILE_SHARE_VALID_FLAGS
,
610 FILE_SYNCHRONOUS_IO_NONALERT
611 | FILE_OPEN_FOR_BACKUP_INTENT
612 | FILE_DIRECTORY_FILE
);
613 if (NT_SUCCESS (status
))
615 status
= NtQueryDirectoryFile (dir
, NULL
, NULL
, 0, &io
,
617 FileBothDirectoryInformation
,
618 TRUE
, &basename
, TRUE
);
620 if (NT_SUCCESS (status
) || status
== STATUS_BUFFER_OVERFLOW
)
621 return fdi
.FileAttributes
;
624 SetLastError (RtlNtStatusToDosError (status
));
625 return INVALID_FILE_ATTRIBUTES
;
628 /* Convert an arbitrary path SRC to a pure Win32 path, suitable for
629 passing to Win32 API routines.
631 If an error occurs, `error' is set to the errno value.
632 Otherwise it is set to 0.
635 SYMLINK_FOLLOW - convert to PATH symlink points to
636 SYMLINK_NOFOLLOW - convert to PATH of symlink itself
637 SYMLINK_IGNORE - do not check PATH for symlinks
638 SYMLINK_CONTENTS - just return symlink contents
641 /* TODO: This implementation is only preliminary. For internal
642 purposes it's necessary to have a path_conv::check function which
643 takes a UNICODE_STRING src path, otherwise we waste a lot of time
644 for converting back and forth. The below implementation does
645 realy nothing but converting to char *, until path_conv handles
646 wide-char paths directly. */
648 path_conv::check (const UNICODE_STRING
*src
, unsigned opt
,
649 const suffix_info
*suffixes
)
652 char *path
= tp
.c_get ();
654 user_shared
->warned_msdos
= true;
655 sys_wcstombs (path
, NT_MAX_PATH
, src
->Buffer
, src
->Length
/ sizeof (WCHAR
));
656 path_conv::check (path
, opt
, suffixes
);
660 path_conv::check (const char *src
, unsigned opt
,
661 const suffix_info
*suffixes
)
663 /* The tmp_buf array is used when expanding symlinks. It is NT_MAX_PATH * 2
664 in length so that we can hold the expanded symlink plus a trailer. */
666 char *path_copy
= tp
.c_get ();
667 char *pathbuf
= tp
.c_get ();
668 char *tmp_buf
= tp
.t_get ();
669 char *THIS_path
= tp
.c_get ();
671 bool need_directory
= 0;
672 bool add_ext
= false;
674 char *tail
, *path_end
;
678 static path_conv last_path_conv
;
679 static char last_src
[CYG_MAX_PATH
];
681 if (*last_src
&& strcmp (last_src
, src
) == 0)
683 *this = last_path_conv
;
694 fileattr
= INVALID_FILE_ATTRIBUTES
;
695 caseinsensitive
= OBJ_CASE_INSENSITIVE
;
701 cfree (modifiable_path ());
704 close_conv_handle ();
708 cfree ((void *) posix_path
);
711 int component
= 0; // Number of translated components
713 if (!(opt
& PC_NULLEMPTY
))
721 bool is_msdos
= false;
722 /* This loop handles symlink expansion. */
725 is_relpath
= !isabspath (src
);
726 error
= normalize_posix_path (src
, path_copy
, tail
);
736 /* Detect if the user was looking for a directory. We have to strip
737 the trailing slash initially while trying to add extensions but
738 take it into account during processing */
739 if (tail
> path_copy
+ 2 && isslash (tail
[-1]))
746 /* Scan path_copy from right to left looking either for a symlink
747 or an actual existing file. If an existing file is found, just
748 return. If a symlink is found, exit the for loop.
749 Also: be careful to preserve the errno returned from
750 symlink.check as the caller may need it. */
751 /* FIXME: Do we have to worry about multiple \'s here? */
752 component
= 0; // Number of translated components
753 sym
.clear_content ();
758 /* Make sure to check certain flags on last component only. */
759 for (unsigned pc_flags
= opt
& (PC_NO_ACCESS_CHECK
| PC_KEEP_HANDLE
760 | PC_SYM_FOLLOW
| PC_SYM_NOFOLLOW_REP
);
762 pc_flags
= opt
& (PC_SYM_FOLLOW
| PC_SYM_NOFOLLOW_REP
))
764 const suffix_info
*suff
;
767 /* Don't allow symlink.check to set anything in the path_conv
768 class if we're working on an inner component of the path */
777 full_path
= THIS_path
;
780 retry_fs_via_processfd
:
782 /* Convert to native path spec sans symbolic link info. */
784 error
= mount_table
->conv_to_win32_path (path_copy
, full_path
,
791 sym
.pc_flags (pc_flags
);
792 sym
.mount_flags (mnt_flags
);
800 if (iscygdrive_dev (dev
))
803 fileattr
= FILE_ATTRIBUTE_DIRECTORY
804 | FILE_ATTRIBUTE_READONLY
;
807 fileattr
= getfileattr (THIS_path
,
808 sym
.mount_flags () & MOUNT_NOPOSIX
);
813 else if (isdev_dev (dev
))
815 /* Make sure that the path handling goes on as with FH_FS. */
817 else if (isvirtual_dev (dev
))
819 /* FIXME: Calling build_fhandler here is not the right way to
821 fhandler_virtual
*fh
= (fhandler_virtual
*)
822 build_fh_dev (dev
, path_copy
);
823 virtual_ftype_t file_type
;
825 file_type
= virt_none
;
828 file_type
= fh
->exists ();
829 virt_fileid () = fh
->fileid ();
830 if (file_type
== virt_symlink
831 || file_type
== virt_fdsymlink
)
834 symlen
= sym
.set (fh
->get_filebuf ());
836 else if (file_type
== virt_fsdir
&& dev
== FH_PROCESSFD
)
838 /* FIXME: This is YA bad hack to workaround that
839 we're checking for isvirtual_dev at this point.
840 This should only happen if the file is actually
841 a virtual file, and NOT already if the preceeding
842 path components constitute a virtual file.
844 Anyway, what we do here is this: If the descriptor
845 symlink points to a dir, and if there are trailing
846 path components, it's actually pointing somewhere
847 else. The format_process_fd function returns the
848 full path, resolved symlink plus trailing path
849 components, in its filebuf. This is a POSIX path
850 we know nothing about, so we have to convert it to
851 native again, calling conv_to_win32_path. Since
852 basically nothing happened yet, just copy it over
853 into full_path and jump back to the
854 conv_to_win32_path call. What a mess. */
855 stpcpy (path_copy
, fh
->get_filebuf ());
857 goto retry_fs_via_processfd
;
859 else if (file_type
== virt_none
&& dev
== FH_PROCESSFD
)
861 error
= get_errno ();
875 fileattr
= FILE_ATTRIBUTE_DIRECTORY
;
882 /* Allow open/linkat to do the right thing. */
883 if (opt
& PC_SYM_NOFOLLOW_PROCFD
)
885 opt
&= ~PC_SYM_FOLLOW
;
886 sym
.path_flags (sym
.path_flags ()
887 | PATH_RESOLVE_PROCFD
);
891 goto is_virtual_symlink
;
903 dev
.parse (FH_SOCKET
);
908 /* Access to real file or directory via block device
909 entry in /proc/sys. Convert to real file and go with
912 goto is_fs_via_procsys
;
914 /* Block special device. Convert to a /dev/sd* like
915 block device unless the trailing slash has been
916 requested. In this case, the target is the root
917 directory of the filesystem on this block device.
918 So we convert this to a real file and attach the
922 fileattr
= FILE_ATTRIBUTE_DEVICE
;
924 /* Use a /dev/sd* device number > /dev/sddx.
925 FIXME: Define a new major DEV_ice number. */
926 dev
.parse (DEV_SD_HIGHPART_END
, 9999);
930 strcat (full_path
, "\\");
931 fileattr
|= FILE_ATTRIBUTE_DIRECTORY
;
938 fileattr
= FILE_ATTRIBUTE_DEVICE
;
942 fileattr
= INVALID_FILE_ATTRIBUTES
;
943 goto virtual_component_retry
;
945 if (component
== 0 || dev
!= FH_NETDRIVE
)
946 mount_flags
|= MOUNT_RO
;
949 /* devn should not be a device. If it is, then stop parsing. */
950 else if (dev
!= FH_FS
)
953 mount_flags
= sym
.mount_flags ();
959 goto out
; /* Found a device. Stop parsing. */
962 /* If path is only a drivename, Windows interprets it as the
963 current working directory on this drive instead of the root
964 dir which is what we want. So we need the trailing backslash
966 if (full_path
[0] && full_path
[1] == ':' && full_path
[2] == '\0')
972 /* If the incoming path was given in DOS notation, always treat
973 it as caseinsensitive,noacl path. This must be set before
974 calling sym.check, otherwise the path is potentially treated
977 sym
.mount_flags (sym
.mount_flags ()
978 | MOUNT_NOPOSIX
| MOUNT_NOACL
);
982 symlen
= sym
.check (full_path
, suff
, fs
, conv_handle
);
993 dev
.parse (sym
.dev ());
995 dev
.mode (sym
.mode ());
996 fileattr
= sym
.fileattr ();
1000 if (sym
.path_flags () & PATH_SOCKET
)
1007 fileattr
= sym
.fileattr ();
1008 #ifdef __WITH_AF_UNIX
1009 dev
.parse ((sym
.path_flags () & PATH_REP
) ? FH_UNIX
: FH_LOCAL
);
1011 dev
.parse (FH_LOCAL
);
1012 #endif /* __WITH_AF_UNIX */
1014 mount_flags
= sym
.mount_flags ();
1015 path_flags
= sym
.path_flags ();
1021 /* Make sure that /dev always exists. */
1022 fileattr
= isdev_dev (dev
) ? FILE_ATTRIBUTE_DIRECTORY
1024 mount_flags
= sym
.mount_flags ();
1025 path_flags
= sym
.path_flags ();
1027 else if (isdev_dev (dev
))
1029 /* If we're looking for a non-existing file below /dev,
1030 make sure that the device type is converted to FH_FS, so
1031 that subsequent code handles the file correctly. Unless
1032 /dev itself doesn't exist on disk. In that case /dev
1033 is handled as virtual filesystem, and virtual filesystems
1034 are read-only. The PC_KEEP_HANDLE check allows to check
1035 for a call from an informational system call. In that
1036 case we just stick to ENOENT, and the device type doesn't
1038 if (sym
.error () == ENOENT
&& !(opt
& PC_KEEP_HANDLE
))
1044 /* If symlink.check found an existing non-symlink file, then
1045 it sets the appropriate flag. It also sets any suffix found
1047 if (!sym
.issymlink ()
1048 && sym
.fileattr () != INVALID_FILE_ATTRIBUTES
)
1050 error
= sym
.error ();
1053 else if (!(sym
.fileattr () & FILE_ATTRIBUTE_DIRECTORY
))
1058 goto out
; // file found
1060 /* Found a symlink if symlen > 0 or short-circuited a native
1061 symlink or junction point if symlen < 0.
1062 If symlen > 0 and component == 0, then the src path itself
1063 was a symlink. If !follow_mode then we're done. Otherwise
1064 we have to insert the path found into the full path that we
1065 are building and perform all of these operations again on the
1066 newly derived path. */
1069 /* if symlen is negativ, the actual native symlink or
1070 junction point is an inner path component. Just fix up
1071 symlen to be positive and don't try any PC_SYM_FOLLOW
1075 else if (component
== 0
1076 && (!(opt
& PC_SYM_FOLLOW
)
1077 || (is_winapi_reparse_point ()
1078 && (opt
& PC_SYM_NOFOLLOW_REP
))))
1080 /* Usually a trailing slash requires to follow a symlink,
1081 even with PC_SYM_NOFOLLOW. The reason is that "foo/"
1082 is equivalent to "foo/." so the symlink is in fact not
1083 the last path component.
1085 PC_SYM_NOFOLLOW_DIR is used to indicate that the
1086 last path component is the target symlink and the
1087 trailing slash is supposed to be ignored. */
1088 if (!need_directory
|| (opt
& PC_SYM_NOFOLLOW_DIR
))
1090 /* last component of path is a symlink. */
1091 set_symlink (symlen
);
1092 /* make sure not to set errno to ENOTDIR. */
1094 if (opt
& PC_SYM_CONTENTS
)
1096 strcpy (THIS_path
, sym
.content ());
1103 /* Following a symlink we can't trust the collected
1104 filesystem information any longer. */
1106 /* Close handle, if we have any. Otherwise we're collecting
1107 handles while following symlinks. */
1108 conv_handle
.close ();
1111 else if (sym
.error () && sym
.error () != ENOENT
)
1113 error
= sym
.error ();
1116 /* No existing file found. */
1118 virtual_component_retry
:
1119 /* Find the new "tail" of the path, e.g. in '/for/bar/baz',
1120 /baz is the tail. */
1121 if (tail
!= path_end
)
1123 while (--tail
> path_copy
+ 1 && *tail
!= '/') {}
1124 /* Exit loop if there is no tail or we are at the
1125 beginning of a UNC path */
1126 if (tail
<= path_copy
+ 1)
1127 goto out
; // all done
1129 /* Haven't found an existing pathname component yet.
1130 Pinch off the tail and try again. */
1135 /* Arrive here if above loop detected a symlink. */
1136 if (++loop
> SYMLOOP_MAX
)
1138 error
= ELOOP
; // Eep.
1142 /* Place the link content, possibly with head and/or tail,
1146 if (isabspath (sym
.content ()))
1147 headptr
= tmp_buf
; /* absolute path */
1150 /* Copy the first part of the path (with ending /) and point to
1152 char *prevtail
= tail
;
1153 while (--prevtail
> path_copy
&& *prevtail
!= '/') {}
1154 int headlen
= prevtail
- path_copy
+ 1;;
1155 memcpy (tmp_buf
, path_copy
, headlen
);
1156 headptr
= &tmp_buf
[headlen
];
1159 /* Make sure there is enough space */
1160 if (headptr
+ symlen
>= tmp_buf
+ (2 * NT_MAX_PATH
))
1163 error
= ENAMETOOLONG
;
1164 set_path ("::ENAMETOOLONG::");
1168 /* Copy the symlink contents to the end of tmp_buf.
1170 for (const char *p
= sym
.content (); *p
; p
++)
1171 *headptr
++ = *p
== '\\' ? '/' : *p
;
1174 /* Copy any tail component (with the 0) */
1175 if (tail
++ < path_end
)
1177 /* Add a slash if needed. There is space. */
1178 if (*(headptr
- 1) != '/')
1180 int taillen
= path_end
- tail
+ 1;
1181 if (headptr
+ taillen
> tmp_buf
+ (2 * NT_MAX_PATH
))
1183 memcpy (headptr
, tail
, taillen
);
1186 /* Evaluate everything all over again. */
1190 if (!(opt
& PC_SYM_CONTENTS
))
1194 set_path (THIS_path
);
1196 add_ext_from_sym (sym
);
1197 if (dev
== FH_NETDRIVE
&& component
)
1199 /* This case indicates a non-existant resp. a non-retrievable
1200 share. This happens for instance if the share is a printer.
1201 In this case the path must not be treated like a FH_NETDRIVE,
1202 but like a FH_FS instead, so the usual open call for files
1206 else if (isproc_dev (dev
) && fileattr
== INVALID_FILE_ATTRIBUTES
)
1208 /* FIXME: Usually we don't set error to ENOENT if a file doesn't
1209 exist. This is typically indicated by the fileattr content.
1210 So, why here? The downside is that cygwin_conv_path just gets
1211 an error for these paths so it reports the error back to the
1212 application. Unlike in all other cases of non-existant files,
1213 for which check doesn't set error, so cygwin_conv_path just
1214 returns the path, as intended. */
1218 else if (!need_directory
|| error
)
1219 /* nothing to do */;
1220 else if (fileattr
== INVALID_FILE_ATTRIBUTES
)
1221 /* Reattach trailing dirsep in native path. */
1222 strcat (modifiable_path (), "\\");
1223 else if (fileattr
& FILE_ATTRIBUTE_DIRECTORY
)
1224 path_flags
&= ~PATH_SYMLINK
;
1227 debug_printf ("%s is a non-directory", path
);
1232 /* Restore last path component */
1233 if (tail
< path_end
&& tail
> path_copy
+ 1)
1238 /* If FS hasn't been checked already in symlink_info::check,
1240 if (fs
.inited ()|| fs
.update (get_nt_native_path (), NULL
))
1242 /* Incoming DOS paths are treated like DOS paths in native
1243 Windows applications. No ACLs, just default settings. */
1245 fs
.has_acls (false);
1246 debug_printf ("this->path(%s), has_acls(%d)",
1247 path
, fs
.has_acls ());
1248 /* CV: We could use this->has_acls() but I want to make sure that
1249 we don't forget that the MOUNT_NOACL flag must be taken into
1251 if (!(mount_flags
& MOUNT_NOACL
) && fs
.has_acls ())
1252 set_exec (0); /* We really don't know if this is executable or
1253 not here but set it to not executable since
1254 it will be figured out later by anything
1255 which cares about this. */
1257 /* If the FS has been found to have unreliable inodes, note
1258 that in mount_flags. */
1259 if (!fs
.hasgood_inode ())
1260 mount_flags
|= MOUNT_IHASH
;
1261 /* If the OS is caseinsensitive or the FS is caseinsensitive,
1262 don't handle path casesensitive. */
1263 if (cygwin_shared
->obcaseinsensitive
|| fs
.caseinsensitive ())
1264 mount_flags
|= MOUNT_NOPOSIX
;
1265 caseinsensitive
= (mount_flags
& MOUNT_NOPOSIX
)
1266 ? OBJ_CASE_INSENSITIVE
: 0;
1267 if (exec_state () != dont_know_if_executable
)
1271 else if (issymlink () || issocket ())
1274 /* FIXME: bad hack alert!!! We need a better solution */
1275 if (!strncmp (path_copy
, MQ_PATH
, MQ_LEN
) && path_copy
[MQ_LEN
])
1276 dev
.parse (FH_MQUEUE
);
1279 if (opt
& PC_NOFULL
)
1283 mkrelpath (this->modifiable_path (), !!caseinsensitive
);
1284 /* Invalidate wide_path so that wide relpath can be created
1285 in later calls to get_nt_native_path or get_wide_win32_path. */
1292 size_t n
= strlen (this->path
);
1293 /* Do not add trailing \ to UNC device names like \\.\a: */
1294 if (this->path
[n
- 1] != '\\' &&
1295 (strncmp (this->path
, "\\\\.\\", 4) != 0))
1297 this->modifiable_path ()[n
] = '\\';
1298 this->modifiable_path ()[n
+ 1] = '\0';
1304 path_flags
|= PATH_OPEN
;
1307 path_flags
|= PATH_CTTY
;
1310 set_posix (path_copy
);
1315 last_path_conv
= *this;
1316 strcpy (last_src
, src
);
1337 path_conv::serialize (HANDLE h
, unsigned int &n
) const
1340 size_t nlen
= 0, plen
= 0;
1344 nlen
= strlen (path
) + 1;
1346 plen
= strlen (posix_path
) + 1;
1347 n
= sizeof (pc_flat
) + nlen
+ plen
;
1348 pcf
= (pc_flat
*) cmalloc (HEAP_COMMUNE
, n
);
1354 memcpy ((void *) &pcf
->pc
, this, sizeof *this);
1356 pcf
->name_len
= nlen
;
1357 pcf
->posix_len
= plen
;
1360 p
= stpcpy (p
, path
) + 1;
1362 stpcpy (p
, posix_path
);
1367 path_conv::deserialize (void *bufp
)
1369 pc_flat
*pcf
= (pc_flat
*) bufp
;
1373 memcpy ((void *) this, &pcf
->pc
, sizeof *this);
1374 wide_path
= uni_path
.Buffer
= NULL
;
1375 uni_path
.MaximumLength
= uni_path
.Length
= 0;
1376 path
= posix_path
= NULL
;
1385 dev
.parse (pcf
->pc
.dev
);
1391 path_conv::~path_conv ()
1395 cfree ((void *) posix_path
);
1400 cfree (modifiable_path ());
1408 close_conv_handle ();
1412 path_conv::is_binary ()
1415 PWCHAR bintest
= tp
.w_get ();
1418 return GetBinaryTypeW (get_wide_win32_path (bintest
), &bin
)
1419 && (bin
== SCS_32BIT_BINARY
|| bin
== SCS_64BIT_BINARY
);
1422 /* Helper function to fill the fai datastructure for a file. */
1424 file_get_fai (HANDLE h
, PFILE_ALL_INFORMATION pfai
)
1429 /* Some FSes (Netapps) don't implement FileNetworkOpenInformation. */
1430 status
= NtQueryInformationFile (h
, &io
, pfai
, sizeof *pfai
,
1431 FileAllInformation
);
1432 if (likely (status
== STATUS_BUFFER_OVERFLOW
))
1433 status
= STATUS_SUCCESS
;
1434 /* Filesystems with broken FileAllInformation exist, too. See the thread
1435 starting with https://cygwin.com/ml/cygwin/2016-07/msg00350.html. */
1436 else if (!NT_SUCCESS (status
) && status
!= STATUS_ACCESS_DENIED
)
1438 memset (pfai
, 0, sizeof *pfai
);
1439 status
= NtQueryInformationFile (h
, &io
, &pfai
->BasicInformation
,
1440 sizeof pfai
->BasicInformation
,
1441 FileBasicInformation
);
1442 if (NT_SUCCESS (status
))
1444 /* The return value of FileInternalInformation is largely ignored.
1445 We only make absolutely sure the inode number is set to 0 in
1447 status
= NtQueryInformationFile (h
, &io
, &pfai
->InternalInformation
,
1448 sizeof pfai
->InternalInformation
,
1449 FileInternalInformation
);
1450 if (!NT_SUCCESS (status
))
1451 pfai
->InternalInformation
.IndexNumber
.QuadPart
= 0LL;
1452 status
= NtQueryInformationFile (h
, &io
, &pfai
->StandardInformation
,
1453 sizeof pfai
->StandardInformation
,
1454 FileStandardInformation
);
1460 /* Normalize a Win32 path.
1461 /'s are converted to \'s in the process.
1462 All duplicate \'s, except for 2 leading \'s, are deleted.
1464 The result is 0 for success, or an errno error value.
1465 FIXME: A lot of this should be mergeable with the POSIX critter. */
1467 normalize_win32_path (const char *src
, char *dst
, char *&tail
)
1469 const char *src_start
= src
;
1470 const char *dst_start
= dst
;
1471 bool beg_src_slash
= isdirsep (src
[0]);
1474 /* Skip Win32 long path name prefix and NT object directory prefix. */
1475 if (beg_src_slash
&& (src
[1] == '?' || isdirsep (src
[1]))
1476 && src
[2] == '?' && isdirsep (src
[3]))
1479 if (isdrive (src
) && (isdirsep (src
[2]) || !src
[2]))
1480 beg_src_slash
= false;
1481 else if (!strncmp (src
, "UNC", 3) && isdirsep (src
[3]))
1482 /* native UNC path */
1483 src
+= 2; /* Fortunately the first char is not copied... */
1487 if (beg_src_slash
&& isdirsep (src
[1]))
1489 if (isdirsep (src
[2]))
1491 /* More than two slashes are just folded into one. */
1493 while (isdirsep (src
[1]))
1498 /* Two slashes start a network or device path. */
1501 if (src
[1] == '.' && isdirsep (src
[2]))
1509 /* If backslash is missing in src, add one. */
1510 if (!isdirsep (src
[0]))
1513 if (tail
== dst_start
)
1517 /* Always convert drive letter to uppercase for case sensitivity. */
1518 *tail
++ = cyg_toupper (*src
++);
1521 /* If backslash is missing in src, add one. */
1522 if (!isdirsep (src
[0]))
1525 else if (*src
!= '/')
1527 /* Make sure dst points to the rightmost backslash which must not
1528 be backtracked over during ".." evaluation. This is either
1529 the backslash after the network path prefix (i.e. "\\") or
1530 the backslash after a drive letter (i.e. C:\"). */
1533 tail
+= cygheap
->cwd
.get_drive (dst
);
1534 /* network path, drive == '\\\\'? Decrement tail to avoid
1535 triple backslash in output. */
1540 else if (cygheap
->cwd
.get (dst
, 0))
1542 tail
= strchr (tail
, '\0');
1543 if (tail
[-1] != '\\')
1550 return get_errno ();
1554 /* At this point dst points to the first backslash, even if it only gets
1555 written in the first iteration of the following loop. Backing up to
1556 handle ".." components can not underrun that border (thus avoiding
1557 subsequent buffer underruns with fatal results). */
1560 /* Strip duplicate /'s. */
1561 if (isdirsep (src
[0]) && isdirsep (src
[1]))
1564 else if (src
[0] == '.' && isdirsep (src
[1])
1565 && (src
== src_start
|| isdirsep (src
[-1])))
1568 /* Skip /'s to the next path component. */
1569 while (isdirsep (*src
))
1573 /* Backup if "..". */
1574 else if (src
[0] == '.' && src
[1] == '.' && tail
[-1] == '\\')
1576 if (!isdirsep (src
[2]) && src
[2] != '\0')
1580 /* Back up over /, but not if it's the first one. */
1583 /* Now back up to the next /. */
1584 while (tail
> dst
+ 1 && tail
[-1] != '\\' && tail
[-2] != ':')
1587 /* Skip /'s to the next path component. */
1588 while (isdirsep (*src
))
1592 /* Otherwise, add char to result. */
1601 if ((tail
- dst
) >= NT_MAX_PATH
)
1602 return ENAMETOOLONG
;
1604 if (tail
> dst
+ 1 && tail
[-1] == '.' && tail
[-2] == '\\')
1607 debug_printf ("%s = normalize_win32_path (%s)", dst_start
, src_start
);
1611 /* Various utilities. */
1613 /* nofinalslash: Remove trailing / and \ from SRC (except for the
1614 first one). It is ok for src == dst. */
1617 nofinalslash (const char *src
, char *dst
)
1619 int len
= strlen (src
);
1621 memcpy (dst
, src
, len
+ 1);
1622 while (len
> 1 && isdirsep (dst
[--len
]))
1626 /* conv_path_list: Convert a list of path names to/from Win32/POSIX. */
1629 conv_path_list (const char *src
, char *dst
, size_t size
,
1630 cygwin_conv_path_t what
)
1633 char src_delim
, dst_delim
;
1635 bool env_cvt
= false;
1637 if (what
== (cygwin_conv_path_t
) ENV_CVT
)
1639 what
= CCP_WIN_A_TO_POSIX
| CCP_RELATIVE
;
1642 if ((what
& CCP_CONVTYPE_MASK
) == CCP_WIN_A_TO_POSIX
)
1654 len
= strlen (src
) + 1;
1655 if (len
<= NT_MAX_PATH
* sizeof (WCHAR
))
1656 srcbuf
= (char *) tp
.w_get ();
1658 srcbuf
= (char *) alloca (len
);
1662 bool saw_empty
= false;
1665 char *srcpath
= srcbuf
;
1666 char *s
= strccpy (srcpath
, &src
, src_delim
);
1667 size_t len
= s
- srcpath
;
1668 if (len
>= NT_MAX_PATH
)
1673 /* Paths in Win32 path lists in the environment (%Path%), are often
1674 enclosed in quotes (usually paths with spaces). Trailing backslashes
1675 are common, too. Remove them. */
1678 if (*srcpath
== '"')
1684 while (len
&& s
[-1] == '\\')
1693 err
= cygwin_conv_path (what
, srcpath
, d
, size
- (d
- dst
));
1695 else if ((what
& CCP_CONVTYPE_MASK
) == CCP_POSIX_TO_WIN_A
)
1698 err
= cygwin_conv_path (what
, ".", d
, size
- (d
- dst
));
1708 d
= strchr (d
, '\0');
1722 /********************** Symbolic Link Support **************************/
1724 /* Create a symlink from FROMPATH to TOPATH. */
1727 symlink (const char *oldpath
, const char *newpath
)
1729 path_conv win32_newpath
;
1733 if (!*oldpath
|| !*newpath
)
1739 /* Trailing dirsep is a no-no, only errno differs. */
1740 bool has_trailing_dirsep
= isdirsep (newpath
[strlen (newpath
) - 1]);
1741 win32_newpath
.check (newpath
,
1742 PC_SYM_NOFOLLOW
| PC_SYM_NOFOLLOW_DIR
| PC_POSIX
,
1745 if (win32_newpath
.error
|| has_trailing_dirsep
)
1747 set_errno (win32_newpath
.error
?:
1748 win32_newpath
.exists () ? EEXIST
: ENOENT
);
1752 return symlink_worker (oldpath
, win32_newpath
, false);
1754 __except (EFAULT
) {}
1760 symlink_nfs (const char *oldpath
, path_conv
&win32_newpath
)
1762 /* On NFS, create symlinks by calling NtCreateFile with an EA of type
1763 NfsSymlinkTargetName containing ... the symlink target name. */
1765 PFILE_FULL_EA_INFORMATION pffei
;
1768 OBJECT_ATTRIBUTES attr
;
1771 pffei
= (PFILE_FULL_EA_INFORMATION
) tp
.w_get ();
1772 pffei
->NextEntryOffset
= 0;
1774 pffei
->EaNameLength
= sizeof (NFS_SYML_TARGET
) - 1;
1775 char *EaValue
= stpcpy (pffei
->EaName
, NFS_SYML_TARGET
) + 1;
1776 pffei
->EaValueLength
= sizeof (WCHAR
) *
1777 (sys_mbstowcs ((PWCHAR
) EaValue
, NT_MAX_PATH
, oldpath
) - 1);
1778 status
= NtCreateFile (&fh
, FILE_WRITE_DATA
| FILE_WRITE_EA
| SYNCHRONIZE
,
1779 win32_newpath
.get_object_attr (attr
, sec_none_nih
),
1780 &io
, NULL
, FILE_ATTRIBUTE_SYSTEM
,
1781 FILE_SHARE_VALID_FLAGS
, FILE_CREATE
,
1782 FILE_SYNCHRONOUS_IO_NONALERT
1783 | FILE_OPEN_FOR_BACKUP_INTENT
,
1784 pffei
, NT_MAX_PATH
* sizeof (WCHAR
));
1785 if (!NT_SUCCESS (status
))
1787 __seterrno_from_nt_status (status
);
1794 /* Count backslashes between s and e. */
1796 cnt_bs (PWCHAR s
, PWCHAR e
)
1806 #ifndef SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE
1807 #define SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE 2
1811 symlink_native (const char *oldpath
, path_conv
&win32_newpath
)
1814 path_conv win32_oldpath
;
1815 PUNICODE_STRING final_oldpath
, final_newpath
;
1816 UNICODE_STRING final_oldpath_buf
;
1819 if (isabspath (oldpath
))
1821 win32_oldpath
.check (oldpath
, PC_SYM_NOFOLLOW
, stat_suffixes
);
1822 final_oldpath
= win32_oldpath
.get_nt_native_path ();
1826 /* The symlink target is relative to the directory in which
1827 the symlink gets created, not relative to the cwd. Therefore
1828 we have to mangle the path quite a bit before calling path_conv. */
1829 ssize_t len
= strrchr (win32_newpath
.get_posix (), '/')
1830 - win32_newpath
.get_posix () + 1;
1831 char *absoldpath
= tp
.t_get ();
1832 stpcpy (stpncpy (absoldpath
, win32_newpath
.get_posix (), len
),
1834 win32_oldpath
.check (absoldpath
, PC_SYM_NOFOLLOW
, stat_suffixes
);
1836 /* Try hard to keep Windows symlink path relative. */
1838 /* 1. Find common path prefix. Skip leading \\?\, but take pre-increment
1839 of the following loop into account. */
1840 PWCHAR c_old
= win32_oldpath
.get_nt_native_path ()->Buffer
+ 3;
1841 PWCHAR c_new
= win32_newpath
.get_nt_native_path ()->Buffer
+ 3;
1842 /* Windows compatible == always check case insensitive. */
1843 while (towupper (*++c_old
) == towupper (*++c_new
))
1845 /* The last component could share a common prefix, so make sure we end
1846 up on the first char after the last common backslash. */
1847 while (c_old
[-1] != L
'\\')
1850 /* 2. Check if prefix is long enough. The prefix must at least points to
1851 a complete device: \\?\X:\ or \\?\UNC\server\share\ are the minimum
1852 prefix strings. We start counting behind the \\?\ for speed. */
1853 int num
= cnt_bs (win32_oldpath
.get_nt_native_path ()->Buffer
+ 4, c_old
);
1854 if (num
< 1 /* locale drive. */
1855 || (win32_oldpath
.get_nt_native_path ()->Buffer
[5] != L
':'
1856 && num
< 3)) /* UNC path. */
1858 /* 3a. No valid common path prefix: Create absolute symlink. */
1859 final_oldpath
= win32_oldpath
.get_nt_native_path ();
1863 /* 3b. Common path prefx. Count number of additional directories
1864 in symlink's path, and prepend as much ".." path components
1865 to the target path. */
1866 PWCHAR e_new
= win32_newpath
.get_nt_native_path ()->Buffer
1867 + win32_newpath
.get_nt_native_path ()->Length
1869 num
= cnt_bs (c_new
, e_new
);
1870 final_oldpath
= &final_oldpath_buf
;
1871 final_oldpath
->Buffer
= tp
.w_get ();
1872 PWCHAR e_old
= final_oldpath
->Buffer
;
1874 e_old
= wcpcpy (e_old
, L
"..\\");
1875 wcpcpy (e_old
, c_old
);
1878 /* If the symlink target doesn't exist, don't create native symlink.
1879 Otherwise the directory flag in the symlink is potentially wrong
1880 when the target comes into existence, and native tools will fail.
1881 This is so screwball. This is no problem on AFS, fortunately. */
1882 if (!win32_oldpath
.exists () && !win32_oldpath
.fs_is_afs ())
1884 SetLastError (ERROR_FILE_NOT_FOUND
);
1887 /* Don't allow native symlinks to Cygwin special files. However, the
1888 caller shoud know because this case shouldn't be covered by the
1889 default "nativestrict" behaviour, so we use a special return code. */
1890 if (win32_oldpath
.isspecial ())
1892 /* Convert native paths to Win32 UNC paths. */
1893 final_newpath
= win32_newpath
.get_nt_native_path ();
1894 final_newpath
->Buffer
[1] = L
'\\';
1895 /* oldpath may be relative. Make sure to convert only absolute paths
1897 if (final_oldpath
->Buffer
[0] == L
'\\')
1899 /* Starting with Windows 8.1, the ShellExecuteW function does not
1900 handle the long path prefix correctly for symlink targets. Thus,
1901 we create simple short paths < MAX_PATH without long path prefix. */
1902 if (RtlEqualUnicodePathPrefix (final_oldpath
, &ro_u_uncp
, TRUE
)
1903 && final_oldpath
->Length
< (MAX_PATH
+ 6) * sizeof (WCHAR
))
1905 final_oldpath
->Buffer
+= 6;
1906 final_oldpath
->Buffer
[0] = L
'\\';
1908 else if (final_oldpath
->Length
< (MAX_PATH
+ 4) * sizeof (WCHAR
))
1909 final_oldpath
->Buffer
+= 4;
1910 else /* Stick to long path, fix native prefix for Win32 API calls. */
1911 final_oldpath
->Buffer
[1] = L
'\\';
1913 /* Try to create native symlink. */
1914 flags
= win32_oldpath
.isdir () ? SYMBOLIC_LINK_FLAG_DIRECTORY
: 0;
1915 if (wincap
.has_unprivileged_createsymlink ())
1916 flags
|= SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE
;
1917 if (!CreateSymbolicLinkW (final_newpath
->Buffer
, final_oldpath
->Buffer
,
1920 /* Repair native newpath, we still need it. */
1921 final_newpath
->Buffer
[1] = L
'?';
1927 #ifndef IO_REPARSE_TAG_LX_SYMLINK
1928 #define IO_REPARSE_TAG_LX_SYMLINK (0xa000001d)
1931 typedef struct _REPARSE_LX_SYMLINK_BUFFER
1934 WORD ReparseDataLength
;
1937 DWORD FileType
; /* Take member name with a grain of salt. Value is
1938 apparently always 2 for symlinks. */
1939 char PathBuffer
[1];/* POSIX path as given to symlink(2).
1940 Path is not \0 terminated.
1941 Length is ReparseDataLength - sizeof (FileType).
1943 Chars given in incompatible codesets, e. g. umlauts
1944 in ISO-8859-x, are converted to the Unicode
1945 REPLACEMENT CHARACTER 0xfffd == \xef\xbf\bd */
1946 } LxSymlinkReparseBuffer
;
1947 } REPARSE_LX_SYMLINK_BUFFER
,*PREPARSE_LX_SYMLINK_BUFFER
;
1950 symlink_wsl (const char *oldpath
, path_conv
&win32_newpath
)
1953 PREPARSE_LX_SYMLINK_BUFFER rpl
= (PREPARSE_LX_SYMLINK_BUFFER
) tp
.c_get ();
1954 char *path_buf
= rpl
->LxSymlinkReparseBuffer
.PathBuffer
;
1955 const int max_pathlen
= MAXIMUM_REPARSE_DATA_BUFFER_SIZE
1956 - offsetof (REPARSE_LX_SYMLINK_BUFFER
,
1957 LxSymlinkReparseBuffer
.PathBuffer
);
1958 PWCHAR utf16
= tp
.w_get ();
1961 OBJECT_ATTRIBUTES attr
;
1965 rpl
->ReparseTag
= IO_REPARSE_TAG_LX_SYMLINK
;
1967 rpl
->LxSymlinkReparseBuffer
.FileType
= 2;
1968 /* Convert cygdrive prefix to "/mnt" for WSL compatibility, but only if
1969 cygdrive prefix is not "/", otherwise suffer random "/mnt" symlinks... */
1970 if (mount_table
->cygdrive_len
> 1
1971 && path_prefix_p (mount_table
->cygdrive
, oldpath
,
1972 mount_table
->cygdrive_len
, false)
1973 && (strlen (oldpath
+ mount_table
->cygdrive_len
- 1) < 2
1974 || (islower (oldpath
[mount_table
->cygdrive_len
])
1975 && (oldpath
[mount_table
->cygdrive_len
+ 1] == '/'
1976 || oldpath
[mount_table
->cygdrive_len
+ 1] == '\0'))))
1977 stpcpy (stpcpy (path_buf
, "/mnt"),
1978 oldpath
+ mount_table
->cygdrive_len
- 1);
1980 *stpncpy (path_buf
, oldpath
, max_pathlen
) = '\0';
1981 /* Convert target path to UTF-16 and then back to UTF-8 to make sure the
1982 WSL symlink is in UTF-8, independent of the current Cygwin codeset. */
1983 sys_mbstowcs (utf16
, NT_MAX_PATH
, path_buf
);
1984 len
= WideCharToMultiByte (CP_UTF8
, 0, utf16
, -1, path_buf
, max_pathlen
,
1986 /* Length is omitting trailing \0. */
1987 rpl
->ReparseDataLength
= sizeof (DWORD
) + len
- 1;
1988 /* Create reparse point. */
1989 status
= NtCreateFile (&fh
, DELETE
| FILE_GENERIC_WRITE
1990 | READ_CONTROL
| WRITE_DAC
,
1991 win32_newpath
.get_object_attr (attr
, sec_none_nih
),
1992 &io
, NULL
, FILE_ATTRIBUTE_NORMAL
,
1993 FILE_SHARE_VALID_FLAGS
, FILE_CREATE
,
1994 FILE_SYNCHRONOUS_IO_NONALERT
1995 | FILE_NON_DIRECTORY_FILE
1996 | FILE_OPEN_FOR_BACKUP_INTENT
1997 | FILE_OPEN_REPARSE_POINT
,
1999 if (!NT_SUCCESS (status
))
2001 SetLastError (RtlNtStatusToDosError (status
));
2004 set_created_file_access (fh
, win32_newpath
, S_IFLNK
| STD_RBITS
| STD_WBITS
);
2005 status
= NtFsControlFile (fh
, NULL
, NULL
, NULL
, &io
, FSCTL_SET_REPARSE_POINT
,
2006 (LPVOID
) rpl
, REPARSE_DATA_BUFFER_HEADER_SIZE
2007 + rpl
->ReparseDataLength
,
2009 if (!NT_SUCCESS (status
))
2011 SetLastError (RtlNtStatusToDosError (status
));
2012 FILE_DISPOSITION_INFORMATION fdi
= { TRUE
};
2013 status
= NtSetInformationFile (fh
, &io
, &fdi
, sizeof fdi
,
2014 FileDispositionInformation
);
2016 if (!NT_SUCCESS (status
))
2017 debug_printf ("Setting delete dispostion failed, status = %y", status
);
2025 symlink_worker (const char *oldpath
, path_conv
&win32_newpath
, bool isdevice
)
2033 /* POSIX says that empty 'newpath' is invalid input while empty
2034 'oldpath' is valid -- it's symlink resolver job to verify if
2035 symlink contents point to existing filesystem object */
2038 if (strlen (oldpath
) > SYMLINK_MAX
)
2040 set_errno (ENAMETOOLONG
);
2044 /* Default symlink type is determined by global allow_winsymlinks
2045 variable. Device files are always shortcuts. */
2046 wsym_type
= isdevice
? WSYM_lnk
: allow_winsymlinks
;
2047 /* NFS has its own, dedicated way to create symlinks. */
2048 if (win32_newpath
.fs_is_nfs () && !isdevice
)
2049 wsym_type
= WSYM_nfs
;
2050 /* MVFS doesn't handle the SYSTEM DOS attribute, but it handles the R/O
2051 attribute. Therefore we create symlinks on MVFS always as shortcuts. */
2052 else if (win32_newpath
.fs_is_mvfs ())
2053 wsym_type
= WSYM_lnk
;
2054 /* AFS only supports native symlinks. */
2055 else if (win32_newpath
.fs_is_afs ())
2056 wsym_type
= WSYM_nativestrict
;
2057 /* Don't try native symlinks on FSes not supporting reparse points. */
2058 else if ((wsym_type
== WSYM_native
|| wsym_type
== WSYM_nativestrict
)
2059 && !(win32_newpath
.fs_flags () & FILE_SUPPORTS_REPARSE_POINTS
))
2060 wsym_type
= WSYM_default
;
2062 /* Attach .lnk suffix when shortcut is requested. */
2063 if (wsym_type
== WSYM_lnk
&& !win32_newpath
.exists ()
2064 && (isdevice
|| !win32_newpath
.fs_is_nfs ()))
2066 char *newplnk
= tp
.c_get ();
2067 stpcpy (stpcpy (newplnk
, win32_newpath
.get_posix ()), ".lnk");
2068 win32_newpath
.check (newplnk
, PC_SYM_NOFOLLOW
| PC_POSIX
);
2071 if (win32_newpath
.error
)
2073 set_errno (win32_newpath
.error
);
2077 syscall_printf ("symlink (%s, %S) wsym_type %d", oldpath
,
2078 win32_newpath
.get_nt_native_path (), wsym_type
);
2080 if ((!isdevice
&& win32_newpath
.exists ())
2081 || (win32_newpath
.isdevice () && !win32_newpath
.is_fs_special ()))
2087 /* Handle NFS, native symlinks and WSL symlinks in their own functions. */
2091 res
= symlink_nfs (oldpath
, win32_newpath
);
2094 case WSYM_nativestrict
:
2095 res
= symlink_native (oldpath
, win32_newpath
);
2098 /* Strictly native? Too bad, unless the target is a Cygwin
2100 if (res
== -1 && wsym_type
== WSYM_nativestrict
)
2105 /* Otherwise, fall back to default symlink type. */
2106 wsym_type
= WSYM_default
;
2109 if (win32_newpath
.fs_flags () & FILE_SUPPORTS_REPARSE_POINTS
)
2111 res
= symlink_wsl (oldpath
, win32_newpath
);
2115 /* On FSes not supporting reparse points, or in case of an error
2116 creating the WSL symlink, fall back to creating the plain old
2117 SYSTEM file symlink. */
2118 wsym_type
= WSYM_sysfile
;
2124 if (wsym_type
== WSYM_lnk
)
2126 path_conv win32_oldpath
;
2127 ITEMIDLIST
*pidl
= NULL
;
2128 size_t full_len
= 0;
2129 unsigned short oldpath_len
, desc_len
, relpath_len
, pidl_len
= 0;
2130 char desc
[MAX_PATH
+ 1], *relpath
;
2134 /* First create an IDLIST to learn how big our shortcut is
2138 /* The symlink target is relative to the directory in which the
2139 symlink gets created, not relative to the cwd. Therefore we
2140 have to mangle the path quite a bit before calling path_conv.*/
2141 if (isabspath (oldpath
))
2142 win32_oldpath
.check (oldpath
,
2147 len
= strrchr (win32_newpath
.get_posix (), '/')
2148 - win32_newpath
.get_posix () + 1;
2149 char *absoldpath
= tp
.t_get ();
2150 stpcpy (stpncpy (absoldpath
, win32_newpath
.get_posix (),
2153 win32_oldpath
.check (absoldpath
, PC_SYM_NOFOLLOW
,
2156 if (SUCCEEDED (SHGetDesktopFolder (&psl
)))
2158 WCHAR wc_path
[win32_oldpath
.get_wide_win32_path_len () + 1];
2159 win32_oldpath
.get_wide_win32_path (wc_path
);
2160 /* Amazing but true: Even though the ParseDisplayName method
2161 takes a wide char path name, it does not understand the
2162 Win32 prefix for long pathnames! So we have to tack off
2163 the prefix and convert the path to the "normal" syntax
2164 for ParseDisplayName. */
2165 PWCHAR wc
= wc_path
+ 4;
2166 if (wc
[1] != L
':') /* native UNC path */
2169 if (SUCCEEDED (res
= psl
->ParseDisplayName (NULL
, NULL
, wc
,
2175 for (p
= pidl
; p
->mkid
.cb
> 0;
2176 p
= (ITEMIDLIST
*)((char *) p
+ p
->mkid
.cb
))
2178 pidl_len
= (char *) p
- (char *) pidl
+ 2;
2183 /* Compute size of shortcut file. */
2184 full_len
= sizeof (win_shortcut_hdr
);
2186 full_len
+= sizeof (unsigned short) + pidl_len
;
2187 oldpath_len
= strlen (oldpath
);
2188 /* Unfortunately the length of the description is restricted to a
2189 length of 2000 bytes. We don't want to add considerations for
2190 the different lengths and even 2000 bytes is not enough for long
2191 path names. So what we do here is to set the description to the
2192 POSIX path only if the path is not longer than MAX_PATH characters.
2193 We append the full path name after the regular shortcut data
2194 (see below), which works fine with Windows Explorer as well
2195 as older Cygwin versions (as long as the whole file isn't bigger
2196 than 8K). The description field is only used for backward
2197 compatibility to older Cygwin versions and those versions are
2198 not capable of handling long path names anyway. */
2199 desc_len
= stpcpy (desc
, oldpath_len
> MAX_PATH
2200 ? "[path too long]" : oldpath
) - desc
;
2201 full_len
+= sizeof (unsigned short) + desc_len
;
2202 /* Devices get the oldpath string unchanged as relative path. */
2205 relpath_len
= oldpath_len
;
2206 stpcpy (relpath
= tp
.c_get (), oldpath
);
2210 relpath_len
= strlen (win32_oldpath
.get_win32 ());
2211 stpcpy (relpath
= tp
.c_get (), win32_oldpath
.get_win32 ());
2213 full_len
+= sizeof (unsigned short) + relpath_len
;
2214 full_len
+= sizeof (unsigned short) + oldpath_len
;
2215 /* 1 byte more for trailing 0 written by stpcpy. */
2216 if (full_len
< NT_MAX_PATH
* sizeof (WCHAR
))
2219 buf
= (char *) alloca (full_len
+ 1);
2221 /* Create shortcut header */
2222 win_shortcut_hdr
*shortcut_header
= (win_shortcut_hdr
*) buf
;
2223 memset (shortcut_header
, 0, sizeof *shortcut_header
);
2224 shortcut_header
->size
= sizeof *shortcut_header
;
2225 shortcut_header
->magic
= GUID_shortcut
;
2226 shortcut_header
->flags
= (WSH_FLAG_DESC
| WSH_FLAG_RELPATH
);
2228 shortcut_header
->flags
|= WSH_FLAG_IDLIST
;
2229 shortcut_header
->run
= SW_NORMAL
;
2230 cp
= buf
+ sizeof (win_shortcut_hdr
);
2235 *(unsigned short *)cp
= pidl_len
;
2236 memcpy (cp
+= 2, pidl
, pidl_len
);
2238 CoTaskMemFree (pidl
);
2241 /* Create description */
2242 *(unsigned short *)cp
= desc_len
;
2243 cp
= stpcpy (cp
+= 2, desc
);
2245 /* Create relpath */
2246 *(unsigned short *)cp
= relpath_len
;
2247 cp
= stpcpy (cp
+= 2, relpath
);
2249 /* Append the POSIX path after the regular shortcut data for
2250 the long path support. */
2251 unsigned short *plen
= (unsigned short *) cp
;
2253 *(PWCHAR
) cp
= 0xfeff; /* BOM */
2255 *plen
= sys_mbstowcs ((PWCHAR
) cp
, NT_MAX_PATH
, oldpath
)
2259 else /* wsym_type == WSYM_sysfile */
2261 /* Default technique creating a symlink. */
2263 cp
= stpcpy (buf
, SYMLINK_COOKIE
);
2264 *(PWCHAR
) cp
= 0xfeff; /* BOM */
2266 /* Note that the terminating nul is written. */
2267 cp
+= sys_mbstowcs ((PWCHAR
) cp
, NT_MAX_PATH
, oldpath
)
2271 OBJECT_ATTRIBUTES attr
;
2277 access
= DELETE
| FILE_GENERIC_WRITE
;
2278 if (isdevice
&& win32_newpath
.exists ())
2280 status
= NtOpenFile (&fh
, FILE_WRITE_ATTRIBUTES
,
2281 win32_newpath
.get_object_attr (attr
,
2283 &io
, 0, FILE_OPEN_FOR_BACKUP_INTENT
);
2284 if (!NT_SUCCESS (status
))
2286 __seterrno_from_nt_status (status
);
2289 status
= NtSetAttributesFile (fh
, FILE_ATTRIBUTE_NORMAL
);
2291 if (!NT_SUCCESS (status
))
2293 __seterrno_from_nt_status (status
);
2297 else if (!isdevice
&& win32_newpath
.has_acls ()
2298 && !win32_newpath
.isremote ())
2299 /* If the filesystem supports ACLs, we will overwrite the DACL after the
2300 call to NtCreateFile. This requires a handle with READ_CONTROL and
2301 WRITE_DAC access, otherwise get_file_sd and set_file_sd both have to
2302 open the file again.
2303 FIXME: On remote NTFS shares open sometimes fails because even the
2304 creator of the file doesn't have the right to change the DACL.
2305 I don't know what setting that is or how to recognize such a share,
2306 so for now we don't request WRITE_DAC on remote drives. */
2307 access
|= READ_CONTROL
| WRITE_DAC
;
2309 status
= NtCreateFile (&fh
, access
,
2310 win32_newpath
.get_object_attr (attr
, sec_none_nih
),
2311 &io
, NULL
, FILE_ATTRIBUTE_NORMAL
,
2312 FILE_SHARE_VALID_FLAGS
,
2313 isdevice
? FILE_OVERWRITE_IF
: FILE_CREATE
,
2314 FILE_SYNCHRONOUS_IO_NONALERT
2315 | FILE_NON_DIRECTORY_FILE
2316 | FILE_OPEN_FOR_BACKUP_INTENT
,
2318 if (!NT_SUCCESS (status
))
2320 __seterrno_from_nt_status (status
);
2323 if (io
.Information
== FILE_CREATED
&& win32_newpath
.has_acls ())
2324 set_created_file_access (fh
, win32_newpath
,
2325 S_IFLNK
| STD_RBITS
| STD_WBITS
);
2326 status
= NtWriteFile (fh
, NULL
, NULL
, NULL
, &io
, buf
, cp
- buf
,
2328 if (NT_SUCCESS (status
) && io
.Information
== (ULONG
) (cp
- buf
))
2330 status
= NtSetAttributesFile (fh
, wsym_type
== WSYM_lnk
2331 ? FILE_ATTRIBUTE_READONLY
2332 : FILE_ATTRIBUTE_SYSTEM
);
2333 if (!NT_SUCCESS (status
))
2334 debug_printf ("Setting attributes failed, status = %y", status
);
2339 __seterrno_from_nt_status (status
);
2340 FILE_DISPOSITION_INFORMATION fdi
= { TRUE
};
2341 status
= NtSetInformationFile (fh
, &io
, &fdi
, sizeof fdi
,
2342 FileDispositionInformation
);
2343 if (!NT_SUCCESS (status
))
2344 debug_printf ("Setting delete dispostion failed, status = %y",
2350 __except (EFAULT
) {}
2352 syscall_printf ("%d = symlink_worker(%s, %s, %d)",
2353 res
, oldpath
, win32_newpath
.get_posix (), isdevice
);
2358 cmp_shortcut_header (win_shortcut_hdr
*file_header
)
2360 /* A Cygwin or U/Win shortcut only contains a description and a relpath.
2361 Cygwin shortcuts also might contain an ITEMIDLIST. The run type is
2362 always set to SW_NORMAL. */
2363 return file_header
->size
== sizeof (win_shortcut_hdr
)
2364 && !memcmp (&file_header
->magic
, &GUID_shortcut
, sizeof GUID_shortcut
)
2365 && (file_header
->flags
& ~WSH_FLAG_IDLIST
)
2366 == (WSH_FLAG_DESC
| WSH_FLAG_RELPATH
)
2367 && file_header
->run
== SW_NORMAL
;
2371 symlink_info::check_shortcut (HANDLE h
)
2374 win_shortcut_hdr
*file_header
;
2380 FILE_STANDARD_INFORMATION fsi
;
2381 LARGE_INTEGER off
= { QuadPart
:0LL };
2383 status
= NtQueryInformationFile (h
, &io
, &fsi
, sizeof fsi
,
2384 FileStandardInformation
);
2385 if (!NT_SUCCESS (status
))
2390 if (fsi
.EndOfFile
.QuadPart
<= (LONGLONG
) sizeof (win_shortcut_hdr
)
2391 || fsi
.EndOfFile
.QuadPart
> 4 * 65536)
2393 if (fsi
.EndOfFile
.LowPart
< NT_MAX_PATH
* sizeof (WCHAR
))
2394 buf
= (char *) tp
.w_get ();
2396 buf
= (char *) alloca (fsi
.EndOfFile
.LowPart
+ 1);
2397 status
= NtReadFile (h
, NULL
, NULL
, NULL
, &io
, buf
, fsi
.EndOfFile
.LowPart
,
2399 if (!NT_SUCCESS (status
))
2401 if (status
!= STATUS_END_OF_FILE
)
2405 file_header
= (win_shortcut_hdr
*) buf
;
2406 if (io
.Information
!= fsi
.EndOfFile
.LowPart
2407 || !cmp_shortcut_header (file_header
))
2409 cp
= buf
+ sizeof (win_shortcut_hdr
);
2410 if (file_header
->flags
& WSH_FLAG_IDLIST
) /* Skip ITEMIDLIST */
2411 cp
+= *(unsigned short *) cp
+ 2;
2412 if (!(len
= *(unsigned short *) cp
))
2415 /* Check if this is a device file - these start with the sequence :\\ */
2416 if (strncmp (cp
, ":\\", 2) == 0)
2417 res
= strlen (strcpy (contents
, cp
)); /* Don't mess with device files */
2420 /* Has appended full path? If so, use it instead of description. */
2421 unsigned short relpath_len
= *(unsigned short *) (cp
+ len
);
2422 if (cp
+ len
+ 2 + relpath_len
< buf
+ fsi
.EndOfFile
.LowPart
)
2424 cp
+= len
+ 2 + relpath_len
;
2425 len
= *(unsigned short *) cp
;
2428 if (*(PWCHAR
) cp
== 0xfeff) /* BOM */
2430 char *tmpbuf
= tp
.c_get ();
2431 if (sys_wcstombs (tmpbuf
, NT_MAX_PATH
, (PWCHAR
) (cp
+ 2))
2434 res
= posixify (tmpbuf
);
2436 else if (len
> SYMLINK_MAX
)
2441 res
= posixify (cp
);
2444 if (res
) /* It's a symlink. */
2445 path_flags (path_flags () | PATH_SYMLINK
| PATH_LNK
);
2450 symlink_info::check_sysfile (HANDLE h
)
2453 char cookie_buf
[sizeof (SYMLINK_COOKIE
) - 1];
2454 char *srcbuf
= tp
.c_get ();
2458 bool interix_symlink
= false;
2459 LARGE_INTEGER off
= { QuadPart
:0LL };
2461 status
= NtReadFile (h
, NULL
, NULL
, NULL
, &io
, cookie_buf
,
2462 sizeof (cookie_buf
), &off
, NULL
);
2463 if (!NT_SUCCESS (status
))
2465 debug_printf ("ReadFile1 failed %y", status
);
2466 if (status
!= STATUS_END_OF_FILE
)
2470 off
.QuadPart
= io
.Information
;
2471 if (io
.Information
== sizeof (cookie_buf
)
2472 && memcmp (cookie_buf
, SYMLINK_COOKIE
, sizeof (cookie_buf
)) == 0)
2474 /* It's a symlink. */
2475 path_flags (path_flags () | PATH_SYMLINK
);
2477 else if (io
.Information
== sizeof (cookie_buf
)
2478 && memcmp (cookie_buf
, SOCKET_COOKIE
, sizeof (cookie_buf
)) == 0)
2479 path_flags (path_flags () | PATH_SOCKET
);
2480 else if (io
.Information
>= sizeof (INTERIX_SYMLINK_COOKIE
)
2481 && memcmp (cookie_buf
, INTERIX_SYMLINK_COOKIE
,
2482 sizeof (INTERIX_SYMLINK_COOKIE
) - 1) == 0)
2484 /* It's an Interix symlink. */
2485 path_flags (path_flags () | PATH_SYMLINK
);
2486 interix_symlink
= true;
2487 /* Interix symlink cookies are shorter than Cygwin symlink cookies, so
2488 in case of an Interix symlink cooky we have read too far into the
2489 file. Set file pointer back to the position right after the cookie. */
2490 off
.QuadPart
= sizeof (INTERIX_SYMLINK_COOKIE
) - 1;
2492 if (path_flags () & PATH_SYMLINK
)
2494 status
= NtReadFile (h
, NULL
, NULL
, NULL
, &io
, srcbuf
,
2495 NT_MAX_PATH
, &off
, NULL
);
2496 if (!NT_SUCCESS (status
))
2498 debug_printf ("ReadFile2 failed");
2499 if (status
!= STATUS_END_OF_FILE
)
2502 else if (*(PWCHAR
) srcbuf
== 0xfeff /* BOM */
2505 /* Add trailing 0 to Interix symlink target. Skip BOM in Cygwin
2507 if (interix_symlink
)
2508 ((PWCHAR
) srcbuf
)[io
.Information
/ sizeof (WCHAR
)] = L
'\0';
2511 char *tmpbuf
= tp
.c_get ();
2512 if (sys_wcstombs (tmpbuf
, NT_MAX_PATH
, (PWCHAR
) srcbuf
)
2514 debug_printf ("symlink string too long");
2516 res
= posixify (tmpbuf
);
2518 else if (io
.Information
> SYMLINK_MAX
+ 1)
2519 debug_printf ("symlink string too long");
2521 res
= posixify (srcbuf
);
2526 typedef struct _REPARSE_APPEXECLINK_BUFFER
2529 WORD ReparseDataLength
;
2532 DWORD Version
; /* Take member name with a grain of salt. */
2533 WCHAR Strings
[1]; /* Four serialized, NUL-terminated WCHAR strings:
2538 We're only interested in the Executable Path */
2539 } AppExecLinkReparseBuffer
;
2540 } REPARSE_APPEXECLINK_BUFFER
,*PREPARSE_APPEXECLINK_BUFFER
;
2543 check_reparse_point_string (PUNICODE_STRING subst
)
2545 /* Native mount points, or native non-relative symbolic links,
2546 can be treated as posix symlinks only if the SubstituteName
2547 can be converted from a native NT object namespace name to
2548 a win32 name. We only know how to convert names with two
2552 Other reparse points will be treated as files or
2553 directories, not as posix symlinks.
2555 if (RtlEqualUnicodePathPrefix (subst
, &ro_u_natp
, FALSE
))
2557 if (subst
->Length
>= 6 * sizeof(WCHAR
) && subst
->Buffer
[5] == L
':' &&
2558 (subst
->Length
== 6 * sizeof(WCHAR
) || subst
->Buffer
[6] == L
'\\'))
2560 else if (subst
->Length
>= 8 * sizeof(WCHAR
) &&
2561 wcsncmp (subst
->Buffer
+ 4, L
"UNC\\", 4) == 0)
2569 0: Not a reparse point recognized by us.
2570 >0: Path flags for a recognized reparse point, always including PATH_REP.
2573 check_reparse_point_target (HANDLE h
, bool remote
, PREPARSE_DATA_BUFFER rp
,
2574 PUNICODE_STRING psymbuf
)
2579 /* On remote drives or under heavy load, NtFsControlFile can return with
2580 STATUS_PENDING. If so, instead of creating an event object, just set
2581 io.Status to an invalid value and perform a minimal wait until io.Status
2583 memset (&io
, 0xff, sizeof io
);
2584 status
= NtFsControlFile (h
, NULL
, NULL
, NULL
, &io
,
2585 FSCTL_GET_REPARSE_POINT
, NULL
, 0, (LPVOID
) rp
,
2586 MAXIMUM_REPARSE_DATA_BUFFER_SIZE
);
2587 if (status
== STATUS_PENDING
)
2589 while (io
.Status
== (NTSTATUS
) 0xffffffff)
2593 if (!NT_SUCCESS (status
))
2595 debug_printf ("NtFsControlFile(FSCTL_GET_REPARSE_POINT) failed, %y",
2597 /* When accessing the root dir of some remote drives (observed with
2598 OS X shares), the FILE_ATTRIBUTE_REPARSE_POINT flag is set, but
2599 the followup call to NtFsControlFile(FSCTL_GET_REPARSE_POINT)
2600 returns with STATUS_NOT_A_REPARSE_POINT. That's quite buggy, but
2601 we cope here with this scenario by not setting an error code. */
2602 if (status
== STATUS_NOT_A_REPARSE_POINT
)
2606 if (rp
->ReparseTag
== IO_REPARSE_TAG_SYMLINK
)
2608 /* Windows evaluates native symlink literally. If a remote symlink
2609 points to, say, C:\foo, it will be handled as if the target is the
2610 local file C:\foo. That comes in handy since that's how symlinks
2611 are treated under POSIX as well. */
2612 RtlInitCountedUnicodeString (psymbuf
,
2613 (PWCHAR
)((PBYTE
) rp
->SymbolicLinkReparseBuffer
.PathBuffer
2614 + rp
->SymbolicLinkReparseBuffer
.SubstituteNameOffset
),
2615 rp
->SymbolicLinkReparseBuffer
.SubstituteNameLength
);
2616 if ((rp
->SymbolicLinkReparseBuffer
.Flags
& SYMLINK_FLAG_RELATIVE
) ||
2617 check_reparse_point_string (psymbuf
))
2618 return PATH_SYMLINK
| PATH_REP
;
2620 else if (!remote
&& rp
->ReparseTag
== IO_REPARSE_TAG_MOUNT_POINT
)
2622 /* Don't handle junctions on remote filesystems as symlinks. This type
2623 of reparse point is handled transparently by the OS so that the
2624 target of the junction is the remote directory it is supposed to
2625 point to. If we handle it as symlink, it will be mistreated as
2626 pointing to a dir on the local system. */
2627 RtlInitCountedUnicodeString (psymbuf
,
2628 (PWCHAR
)((PBYTE
) rp
->MountPointReparseBuffer
.PathBuffer
2629 + rp
->MountPointReparseBuffer
.SubstituteNameOffset
),
2630 rp
->MountPointReparseBuffer
.SubstituteNameLength
);
2631 if (RtlEqualUnicodePathPrefix (psymbuf
, &ro_u_volume
, TRUE
))
2633 /* Volume mount point. Not treated as symlink. The return
2634 value -EPERM is a hint for the caller to treat this as a
2635 volume mount point. */
2638 if (check_reparse_point_string (psymbuf
))
2639 return PATH_SYMLINK
| PATH_REP
;
2641 else if (!remote
&& rp
->ReparseTag
== IO_REPARSE_TAG_APPEXECLINK
)
2643 /* App execution aliases are commonly used by Windows Store apps. */
2644 PREPARSE_APPEXECLINK_BUFFER rpl
= (PREPARSE_APPEXECLINK_BUFFER
) rp
;
2645 WCHAR
*buf
= rpl
->AppExecLinkReparseBuffer
.Strings
;
2646 DWORD size
= rp
->ReparseDataLength
/ sizeof (WCHAR
), n
;
2648 /* It seems that app execution aliases have a payload of four
2649 NUL-separated wide string: package id, entry point, executable
2650 and application type. We're interested in the executable. */
2651 for (int i
= 0; i
< 3 && size
> 0; i
++)
2653 n
= wcsnlen (buf
, size
- 1);
2654 if (i
== 2 && n
> 0 && n
< size
)
2656 RtlInitCountedUnicodeString (psymbuf
, buf
, n
* sizeof (WCHAR
));
2657 return PATH_SYMLINK
| PATH_REP
;
2665 else if (rp
->ReparseTag
== IO_REPARSE_TAG_LX_SYMLINK
)
2667 /* WSL symlink. Problem: We have to convert the path to UTF-16 for
2668 the caller. Reparse points are 16K max. The buffer given to rp
2669 is 32K. So there's enough trailing space in the buffer to convert
2670 to UTF-16 and let psymbuf point to it. */
2671 PREPARSE_LX_SYMLINK_BUFFER rpl
= (PREPARSE_LX_SYMLINK_BUFFER
) rp
;
2672 char *path_buf
= rpl
->LxSymlinkReparseBuffer
.PathBuffer
;
2673 DWORD path_len
= rpl
->ReparseDataLength
- sizeof (DWORD
);
2674 bool full_path
= false;
2675 const size_t drv_prefix_len
= strlen ("/mnt");
2680 /* 0-terminate path_buf for easier testing. */
2681 path_buf
[path_len
] = '\0';
2682 if (path_prefix_p ("/mnt", path_buf
, drv_prefix_len
, false))
2684 size_t len
= strlen (path_buf
);
2686 if (len
<= drv_prefix_len
+ 1)
2688 /* /mnt or /mnt/. Replace with cygdrive prefix. */
2689 stpcpy (path_buf
, mount_table
->cygdrive
);
2690 path_len
= mount_table
->cygdrive_len
;
2691 if (len
== drv_prefix_len
)
2693 path_buf
[mount_table
->cygdrive_len
- 1] = '\0';
2696 rp
->ReparseDataLength
= path_len
+ sizeof (DWORD
);
2698 else if (islower (path_buf
[drv_prefix_len
+ 1])
2699 && (path_len
== drv_prefix_len
+ 2
2700 || path_buf
[drv_prefix_len
+ 2] == '/'))
2702 /* Skip forward to the slash leading the drive letter.
2703 That leaves room for adding the colon. */
2704 path_buf
+= drv_prefix_len
;
2705 path_len
-= drv_prefix_len
;
2709 /* Compute buffer for path converted to UTF-16. */
2710 utf16_ptr
= (PBYTE
) rpl
+ sizeof (REPARSE_LX_SYMLINK_BUFFER
)
2711 + rp
->ReparseDataLength
;
2712 /* Skip \0-termination added above. */
2714 /* Make sure pointer is aligned */
2715 while ((intptr_t) utf16_ptr
% sizeof (WCHAR
))
2717 utf16_buf
= (PWCHAR
) utf16_ptr
;
2718 utf16_bufsize
= NT_MAX_PATH
- (utf16_buf
- (PWCHAR
) rpl
);
2719 /* Now convert path to UTF-16. */
2720 utf16_bufsize
= MultiByteToWideChar (CP_UTF8
, 0, path_buf
, path_len
,
2721 utf16_buf
, utf16_bufsize
);
2726 utf16_buf
[0] = utf16_buf
[1]; /* Move drive letter to front */
2727 utf16_buf
[1] = L
':'; /* Add colon */
2729 RtlInitCountedUnicodeString (psymbuf
, utf16_buf
,
2730 utf16_bufsize
* sizeof (WCHAR
));
2731 return PATH_SYMLINK
| PATH_REP
| PATH_REP_NOAPI
;
2735 else if (rp
->ReparseTag
== IO_REPARSE_TAG_CYGUNIX
)
2737 PREPARSE_GUID_DATA_BUFFER rgp
= (PREPARSE_GUID_DATA_BUFFER
) rp
;
2739 if (memcmp (CYGWIN_SOCKET_GUID
, &rgp
->ReparseGuid
, sizeof (GUID
)) == 0)
2740 #ifdef __WITH_AF_UNIX
2741 return PATH_SOCKET
| PATH_REP
| PATH_REP_NOAPI
;
2743 /* Recognize this as a reparse point but not as a socket. */
2744 return PATH_REP
| PATH_REP_NOAPI
;
2747 else if (rp
->ReparseTag
== IO_REPARSE_TAG_AF_UNIX
)
2748 /* Native Windows AF_UNIX socket; recognize this as a reparse
2749 point but not as a socket. */
2755 symlink_info::check_reparse_point (HANDLE h
, bool remote
)
2758 PREPARSE_DATA_BUFFER rp
= (PREPARSE_DATA_BUFFER
) tp
.c_get ();
2759 UNICODE_STRING symbuf
;
2760 char srcbuf
[SYMLINK_MAX
+ 7];
2762 int ret
= check_reparse_point_target (h
, remote
, rp
, &symbuf
);
2770 /* Maybe it's a reparse point, but it's certainly not one we recognize.
2771 Drop REPARSE attribute so we don't try to use the flag accidentally.
2772 It's just some arbitrary file or directory for us. */
2773 fileattr (fileattr () & ~FILE_ATTRIBUTE_REPARSE_POINT
);
2776 /* ret is > 0, so it's a known reparse point, path in symbuf. */
2777 path_flags (path_flags () | ret
);
2778 if (ret
& PATH_SYMLINK
)
2780 sys_wcstombs (srcbuf
, SYMLINK_MAX
+ 7, symbuf
.Buffer
,
2781 symbuf
.Length
/ sizeof (WCHAR
));
2782 /* A symlink is never a directory. */
2783 fileattr (fileattr () & ~FILE_ATTRIBUTE_DIRECTORY
);
2784 return posixify (srcbuf
);
2791 symlink_info::check_nfs_symlink (HANDLE h
)
2797 FILE_GET_EA_INFORMATION fgei
;
2798 char buf
[sizeof (NFS_SYML_TARGET
)];
2800 PFILE_FULL_EA_INFORMATION pffei
;
2803 /* To find out if the file is a symlink and to get the symlink target,
2804 try to fetch the NfsSymlinkTargetName EA. */
2805 fgei_buf
.fgei
.NextEntryOffset
= 0;
2806 fgei_buf
.fgei
.EaNameLength
= sizeof (NFS_SYML_TARGET
) - 1;
2807 stpcpy (fgei_buf
.fgei
.EaName
, NFS_SYML_TARGET
);
2808 pffei
= (PFILE_FULL_EA_INFORMATION
) tp
.w_get ();
2809 status
= NtQueryEaFile (h
, &io
, pffei
, NT_MAX_PATH
* sizeof (WCHAR
), TRUE
,
2810 &fgei_buf
.fgei
, sizeof fgei_buf
, NULL
, TRUE
);
2811 if (NT_SUCCESS (status
) && pffei
->EaValueLength
> 0)
2813 PWCHAR spath
= (PWCHAR
)
2814 (pffei
->EaName
+ pffei
->EaNameLength
+ 1);
2815 res
= sys_wcstombs (contents
, SYMLINK_MAX
+ 1,
2816 spath
, pffei
->EaValueLength
);
2817 path_flags (path_flags () | PATH_SYMLINK
);
2823 symlink_info::posixify (char *srcbuf
)
2825 /* The definition for a path in a native symlink is a bit weird. The Flags
2826 value seem to contain 0 for absolute paths (stored as NT native path)
2827 and 1 for relative paths. Relative paths are paths not starting with a
2828 drive letter. These are not converted to NT native, but stored as
2829 given. A path starting with a single backslash is relative to the
2830 current drive thus a "relative" value (Flags == 1).
2831 Funny enough it's possible to store paths with slashes instead of
2832 backslashes, but they are evaluated incorrectly by subsequent Windows
2833 calls like CreateFile (ERROR_INVALID_NAME). So, what we do here is to
2834 take paths starting with slashes at face value, evaluating them as
2835 Cygwin specific POSIX paths.
2836 A path starting with two slashes(!) or backslashes is converted into an
2837 NT UNC path. Unfortunately, in contrast to POSIX rules, paths starting
2838 with three or more (back)slashes are also converted into UNC paths,
2839 just incorrectly sticking to one redundant leading backslash. We go
2840 along with this behaviour to avoid scenarios in which native tools access
2841 other files than Cygwin.
2842 The above rules are used exactly the same way on Cygwin specific symlinks
2843 (sysfiles and shortcuts) to eliminate non-POSIX paths in the output. */
2845 /* Eliminate native NT prefixes. */
2846 if (srcbuf
[0] == '\\' && !strncmp (srcbuf
+ 1, "??\\", 3))
2849 if (srcbuf
[1] != ':') /* native UNC path */
2850 *(srcbuf
+= 2) = '\\';
2852 if (isdrive (srcbuf
))
2853 mount_table
->conv_to_posix_path (srcbuf
, contents
, 0);
2854 else if (srcbuf
[0] == '\\')
2856 if (srcbuf
[1] == '\\') /* UNC path */
2857 slashify (srcbuf
, contents
, 0);
2858 else /* Paths starting with \ are current drive relative. */
2860 char cvtbuf
[SYMLINK_MAX
+ 1];
2862 stpcpy (cvtbuf
+ cygheap
->cwd
.get_drive (cvtbuf
), srcbuf
);
2863 mount_table
->conv_to_posix_path (cvtbuf
, contents
, 0);
2866 else /* Everything else is taken as is. */
2867 slashify (srcbuf
, contents
, 0);
2868 return strlen (contents
);
2877 SCAN_JUSTCHECKTHIS
, /* Never try to append a suffix. */
2884 const suffix_info
*suffixes
, *suffixes_start
;
2889 char *has (const char *, const suffix_info
*);
2891 int lnk_match () {return nextstate
>= SCAN_APPENDLNK
;}
2895 suffix_scan::has (const char *in_path
, const suffix_info
*in_suffixes
)
2897 nextstate
= SCAN_BEG
;
2898 suffixes
= suffixes_start
= in_suffixes
;
2900 const char *fname
= strrchr (in_path
, '\\');
2901 fname
= fname
? fname
+ 1 : in_path
;
2902 char *ext_here
= strrchr (fname
, '.');
2904 eopath
= strchr (path
, '\0');
2911 /* Check if the extension matches a known extension */
2912 for (const suffix_info
*ex
= in_suffixes
; ex
->name
!= NULL
; ex
++)
2913 if (ascii_strcasematch (ext_here
, ex
->name
))
2915 nextstate
= SCAN_JUSTCHECK
;
2916 suffixes
= NULL
; /* Has an extension so don't scan for one. */
2921 /* Didn't match. Use last resort -- .lnk. */
2922 if (ascii_strcasematch (ext_here
, ".lnk"))
2924 nextstate
= SCAN_HASLNK
;
2932 size_t namelen
= eopath
- fname
;
2933 /* Avoid attaching suffixes if the resulting filename would be invalid.
2934 For performance reasons we don't check the length of a suffix, since
2935 we know that all suffixes are 4 chars in length.
2937 FIXME: This is not really correct. A fully functional test should
2938 work on wide character paths. This would probably also speed
2939 up symlink_info::check. */
2940 if (namelen
> NAME_MAX
- 4)
2942 if (namelen
> NAME_MAX
)
2944 nextstate
= SCAN_JUSTCHECKTHIS
;
2951 suffix_scan::next ()
2959 suffixes
= suffixes_start
;
2962 nextstate
= SCAN_LNK
;
2965 nextstate
= SCAN_DONE
;
2969 nextstate
= SCAN_APPENDLNK
; /* Skip SCAN_BEG */
2971 case SCAN_JUSTCHECK
:
2972 nextstate
= SCAN_LNK
;
2974 case SCAN_JUSTCHECKTHIS
:
2975 nextstate
= SCAN_DONE
;
2978 case SCAN_APPENDLNK
:
2979 nextstate
= SCAN_DONE
;
2980 strcat (eopath
, ".lnk");
2987 if (suffixes
&& suffixes
->name
)
2989 strcpy (eopath
, suffixes
->name
);
2994 if (nextstate
== SCAN_BEG
)
2996 nextstate
= SCAN_LNK
;
3003 symlink_info::set_error (int in_errno
)
3006 if (!(pc_flags () & PC_NO_ACCESS_CHECK
)
3007 || in_errno
== ENAMETOOLONG
|| in_errno
== EIO
)
3012 else if (in_errno
== ENOENT
)
3016 fileattr (FILE_ATTRIBUTE_NORMAL
);
3023 symlink_info::parse_device (const char *contents
)
3030 mymajor
= strtol (contents
+= 2, &endptr
, 16);
3031 if (endptr
== contents
)
3035 myminor
= strtol (++contents
, &endptr
, 16);
3036 if (endptr
== contents
)
3040 mymode
= strtol (++contents
, &endptr
, 16);
3041 if (endptr
== contents
)
3044 if ((mymode
& S_IFMT
) == S_IFIFO
)
3047 dev (FHDEV (mymajor
, myminor
));
3052 /* Probably we have a virtual drive input path and the resulting full path
3053 starts with the substitution. Retrieve the target path of the virtual
3054 drive and try to revert what GetFinalPathNameByHandleW did to the
3057 revert_virtual_drive (PUNICODE_STRING upath
, PUNICODE_STRING fpath
,
3058 bool is_remote
, ULONG ci_flag
)
3060 /* Get the drive's target path. */
3061 WCHAR drive
[3] = {(WCHAR
) towupper (upath
->Buffer
[4]), L
':', L
'\0'};
3062 WCHAR target
[MAX_PATH
];
3063 UNICODE_STRING tpath
;
3066 DWORD remlen
= QueryDosDeviceW (drive
, target
, MAX_PATH
);
3069 remlen
-= 2; /* Two L'\0' */
3071 if (target
[remlen
- 1] == L
'\\')
3073 RtlInitCountedUnicodeString (&tpath
, target
, remlen
* sizeof (WCHAR
));
3075 const USHORT uncp_len
= is_remote
? ro_u_uncp
.Length
/ sizeof (WCHAR
) - 1 : 0;
3079 /* target path starts with \??\UNC\. */
3080 if (RtlEqualUnicodePathPrefix (&tpath
, &ro_u_uncp
, TRUE
))
3083 p
= target
+ uncp_len
;
3085 /* target path starts with \Device\<redirector>. */
3086 else if ((p
= wcschr (target
, L
';'))
3087 && p
+ 3 < target
+ remlen
3088 && wcsncmp (p
+ 1, drive
, 2) == 0
3089 && (p
= wcschr (p
+ 3, L
'\\')))
3090 remlen
-= p
- target
;
3093 if (wcsncasecmp (fpath
->Buffer
+ uncp_len
, p
, remlen
))
3096 else if (!RtlEqualUnicodePathPrefix (fpath
, &tpath
, TRUE
))
3098 /* Replace fpath with source drive letter and append reminder of
3099 final path after skipping target path */
3100 fpath
->Buffer
[4] = drive
[0]; /* Drive letter */
3101 fpath
->Buffer
[5] = L
':';
3102 WCHAR
*to
= fpath
->Buffer
+ 6; /* Next to L':' */
3103 WCHAR
*from
= fpath
->Buffer
+ uncp_len
+ remlen
;
3104 memmove (to
, from
, (wcslen (from
) + 1) * sizeof (WCHAR
));
3105 fpath
->Length
-= (from
- to
) * sizeof (WCHAR
);
3106 if (RtlEqualUnicodeString (upath
, fpath
, !!ci_flag
))
3111 /* Check if PATH is a symlink. PATH must be a valid Win32 path name.
3113 If PATH is a symlink, put the value of the symlink--the file to
3114 which it points--into CONTENTS.
3116 Set PATH_SYMLINK if PATH is a symlink.
3118 If PATH is a symlink, return the length stored into CONTENTS. If
3119 the inner components of PATH contain native symlinks or junctions,
3120 or if the drive is a virtual drive, compare PATH with the result
3121 returned by GetFinalPathNameByHandleA. If they differ, store the
3122 final path in CONTENTS and return the negative of its length. In
3123 all other cases, return 0. */
3126 symlink_info::check (char *path
, const suffix_info
*suffixes
, fs_info
&fs
,
3127 path_conv_handle
&conv_hdl
)
3132 UNICODE_STRING upath
;
3133 OBJECT_ATTRIBUTES attr
;
3138 const ULONG ci_flag
= cygwin_shared
->obcaseinsensitive
3139 || (mount_flags () & MOUNT_NOPOSIX
)
3140 ? OBJ_CASE_INSENSITIVE
: 0;
3141 /* TODO: Temporarily do all char->UNICODE conversion here. This should
3142 already be slightly faster than using Ascii functions. */
3145 InitializeObjectAttributes (&attr
, &upath
, ci_flag
, NULL
, NULL
);
3147 /* This label is used in case we encounter a FS which only handles
3148 DOS paths. See below. */
3149 bool restarted
= false;
3156 PVOID eabuf
= &nfs_aol_ffei
;
3157 ULONG easize
= sizeof nfs_aol_ffei
;
3159 ext_here
= suffix
.has (path
, suffixes
);
3160 /* If the filename is too long, don't even try. */
3163 set_error (ENAMETOOLONG
);
3164 goto file_not_symlink
;
3167 had_ext
= !!*ext_here
;
3168 path_len (ext_here
- path
);
3170 while (suffix
.next ())
3174 get_nt_native_path (suffix
.path
, upath
, mount_flags () & MOUNT_DOS
);
3180 /* The EA given to NtCreateFile allows to get a handle to a symlink on
3181 an NFS share, rather than getting a handle to the target of the
3182 symlink (which would spoil the task of this method quite a bit).
3183 Fortunately it's ignored on most other file systems so we don't have
3184 to special case NFS too much. */
3185 status
= NtCreateFile (&h
,
3186 READ_CONTROL
| FILE_READ_ATTRIBUTES
| FILE_READ_EA
,
3187 &attr
, &io
, NULL
, 0, FILE_SHARE_VALID_FLAGS
,
3189 FILE_OPEN_REPARSE_POINT
3190 | FILE_OPEN_FOR_BACKUP_INTENT
,
3192 debug_printf ("%y = NtCreateFile (%S)", status
, &upath
);
3193 /* No right to access EAs or EAs not supported? */
3194 if (!NT_SUCCESS (status
)
3195 && (status
== STATUS_ACCESS_DENIED
3196 || status
== STATUS_EAS_NOT_SUPPORTED
3197 || status
== STATUS_NOT_SUPPORTED
3198 || status
== STATUS_INVALID_NETWORK_RESPONSE
3199 /* Or a bug in Samba 3.2.x (x <= 7) when accessing a share's
3200 root dir which has EAs enabled? */
3201 || status
== STATUS_INVALID_PARAMETER
))
3203 /* If EAs are not supported, there's no sense to check them again
3204 with suffixes attached. So we set eabuf/easize to 0 here once. */
3205 if (status
== STATUS_EAS_NOT_SUPPORTED
3206 || status
== STATUS_NOT_SUPPORTED
)
3211 status
= NtOpenFile (&h
, READ_CONTROL
| FILE_READ_ATTRIBUTES
,
3212 &attr
, &io
, FILE_SHARE_VALID_FLAGS
,
3214 | FILE_OPEN_REPARSE_POINT
3215 | FILE_OPEN_FOR_BACKUP_INTENT
);
3216 debug_printf ("%y = NtOpenFile (no-EAs %S)", status
, &upath
);
3218 if (status
== STATUS_OBJECT_NAME_NOT_FOUND
)
3220 /* There are filesystems out in the wild (Netapp, NWFS, and others)
3221 which are uncapable of generating pathnames outside the Win32
3222 rules. That means, filenames on these FSes must not have a
3223 leading space or trailing dots and spaces. This code snippet
3224 manages them. I really hope it's streamlined enough not to
3225 slow down normal operation. This extra check only kicks in if
3226 we encountered a STATUS_OBJECT_NAME_NOT_FOUND *and* we didn't
3227 already attach a suffix. */
3228 if (!restarted
&& !*ext_here
&& ext_here
[-1] != '\\'
3229 && !(mount_flags () & MOUNT_DOS
))
3231 /* Check for trailing dot or space or leading space in
3233 char *p
= ext_here
- 1;
3234 if (*p
!= '.' && *p
!= ' ')
3236 while (*--p
!= '\\')
3243 /* If so, check if file resides on one of the known broken
3244 FSes only supporting filenames following DOS rules. */
3245 fs
.update (&upath
, NULL
);
3246 if (fs
.has_dos_filenames_only ())
3248 /* If so, try again. Since we now know the FS, the
3249 filenames will be tweaked to follow DOS rules via the
3250 third parameter in the call to get_nt_native_path. */
3251 mount_flags (mount_flags () | MOUNT_DOS
);
3258 else if (status
== STATUS_NETWORK_OPEN_RESTRICTION
3259 || status
== STATUS_SYMLINK_CLASS_DISABLED
)
3261 /* These status codes are returned if you try to open a native
3262 symlink and the usage of this kind of symlink is forbidden
3263 (see fsutil). Since we can't open them at all, not even for
3264 stat purposes, we have to return a POSIX error code which is
3265 at least a bit helpful.
3267 Additionally Windows 8 introduces a bug in NFS: If you have
3268 a symlink to a directory, with symlinks underneath, resolving
3269 the second level of symlinks fails if remote->remote symlinks
3270 are disabled in fsutil. Unfortunately that's the default. */
3275 if (NT_SUCCESS (status
)
3276 /* Check file system while we're having the file open anyway.
3277 This speeds up path_conv noticably (~10%). */
3278 && (fs
.inited () || fs
.update (&upath
, h
)))
3280 status
= conv_hdl
.get_finfo (h
, fs
.is_nfs ());
3281 if (NT_SUCCESS (status
))
3282 fileattr (conv_hdl
.get_dosattr (h
, fs
.is_nfs ()));
3284 if (!NT_SUCCESS (status
))
3286 debug_printf ("%y = NtQueryInformationFile (%S)", status
, &upath
);
3287 fileattr (INVALID_FILE_ATTRIBUTES
);
3289 /* One of the inner path components is invalid, or the path contains
3290 invalid characters. Bail out with ENOENT.
3292 STATUS_IO_REPARSE_TAG_NOT_HANDLED is returned when trying to
3293 traversing a WSL symlink. For all practical purposes it's
3294 equivalent to traversing SYSTEM- or LNK-type symlink returning
3295 STATUS_OBJECT_PATH_NOT_FOUND.
3297 Note that additional STATUS_OBJECT_PATH_INVALID and
3298 STATUS_OBJECT_PATH_SYNTAX_BAD status codes exist. The first one
3299 is seemingly not generated by NtQueryInformationFile, the latter
3300 is only generated if the path is no absolute path within the
3301 NT name space, which should not happen and would point to an
3302 error in get_nt_native_path. Both status codes are deliberately
3303 not tested here unless proved necessary. */
3304 if (status
== STATUS_OBJECT_PATH_NOT_FOUND
3305 || status
== STATUS_IO_REPARSE_TAG_NOT_HANDLED
3306 || status
== STATUS_OBJECT_NAME_INVALID
3307 || status
== STATUS_BAD_NETWORK_PATH
3308 || status
== STATUS_BAD_NETWORK_NAME
3309 || status
== STATUS_NO_MEDIA_IN_DEVICE
)
3312 if (ext_tacked_on () && !had_ext
)
3315 ext_tacked_on (false);
3319 goto file_not_symlink
;
3321 if (status
!= STATUS_OBJECT_NAME_NOT_FOUND
3322 && status
!= STATUS_NO_SUCH_FILE
) /* ENOENT on NFS or 9x share */
3324 /* The file exists, but the user can't access it for one reason
3325 or the other. To get the file attributes we try to access the
3326 information by opening the parent directory and getting the
3327 file attributes using a matching NtQueryDirectoryFile call. */
3328 UNICODE_STRING dirname
, basename
;
3329 OBJECT_ATTRIBUTES dattr
;
3332 FILE_ID_BOTH_DIR_INFORMATION fdi
;
3333 WCHAR dummy_buf
[NAME_MAX
+ 1];
3336 RtlSplitUnicodePath (&upath
, &dirname
, &basename
);
3337 InitializeObjectAttributes (&dattr
, &dirname
, ci_flag
,
3339 status
= NtOpenFile (&dir
, SYNCHRONIZE
| FILE_LIST_DIRECTORY
,
3340 &dattr
, &io
, FILE_SHARE_VALID_FLAGS
,
3341 FILE_SYNCHRONOUS_IO_NONALERT
3342 | FILE_OPEN_FOR_BACKUP_INTENT
3343 | FILE_DIRECTORY_FILE
);
3344 if (!NT_SUCCESS (status
))
3346 debug_printf ("%y = NtOpenFile(%S)", status
, &dirname
);
3347 /* There's a special case if the file is itself the root
3348 of a drive which is not accessible by the current user.
3349 This case is only recognized by the length of the
3350 basename part. If it's 0, the incoming file is the
3351 root of a drive. So we at least know it's a directory. */
3352 if (basename
.Length
)
3353 fileattr (FILE_ATTRIBUTE_DIRECTORY
);
3357 set_error (geterrno_from_nt_status (status
));
3362 status
= NtQueryDirectoryFile (dir
, NULL
, NULL
, NULL
, &io
,
3363 &fdi_buf
, sizeof fdi_buf
,
3364 FileIdBothDirectoryInformation
,
3365 TRUE
, &basename
, TRUE
);
3366 /* Take the opportunity to check file system while we're
3367 having the handle to the parent dir. */
3368 fs
.update (&upath
, dir
);
3370 if (!NT_SUCCESS (status
))
3372 debug_printf ("%y = NtQueryDirectoryFile(%S)",
3374 if (status
== STATUS_NO_SUCH_FILE
)
3376 /* This can happen when trying to access files
3377 which match DOS device names on SMB shares.
3378 NtOpenFile failed with STATUS_ACCESS_DENIED,
3379 but the NtQueryDirectoryFile tells us the
3380 file doesn't exist. We're suspicious in this
3381 case and retry with the next suffix instead of
3390 PFILE_ALL_INFORMATION pfai
= conv_hdl
.fai ();
3392 fileattr (fdi_buf
.fdi
.FileAttributes
);
3393 memcpy (&pfai
->BasicInformation
.CreationTime
,
3394 &fdi_buf
.fdi
.CreationTime
,
3395 4 * sizeof (LARGE_INTEGER
));
3396 pfai
->BasicInformation
.FileAttributes
= fileattr ();
3397 pfai
->StandardInformation
.AllocationSize
.QuadPart
3398 = fdi_buf
.fdi
.AllocationSize
.QuadPart
;
3399 pfai
->StandardInformation
.EndOfFile
.QuadPart
3400 = fdi_buf
.fdi
.EndOfFile
.QuadPart
;
3401 pfai
->StandardInformation
.NumberOfLinks
= 1;
3402 pfai
->InternalInformation
.IndexNumber
.QuadPart
3403 = fdi_buf
.fdi
.FileId
.QuadPart
;
3406 ext_tacked_on (!!*ext_here
);
3407 goto file_not_symlink
;
3413 ext_tacked_on (!!*ext_here
);
3414 /* Don't allow to returns directories with appended suffix. If we found
3415 a directory with a suffix which has been appended here, then this
3416 directory doesn't match the request. So, just do as usual if file
3417 hasn't been found. */
3418 if (ext_tacked_on () && !had_ext
3419 && (fileattr () & FILE_ATTRIBUTE_DIRECTORY
))
3421 fileattr (INVALID_FILE_ATTRIBUTES
);
3426 /* Consider the situation where a virtual drive points to a native
3427 symlink. Opening the virtual drive with FILE_OPEN_REPARSE_POINT
3428 actually opens the symlink. If this symlink points to another
3429 directory using a relative path, symlink evaluation goes totally
3430 awry. We never want a virtual drive evaluated as symlink. */
3431 if (upath
.Length
<= 14)
3432 goto file_not_symlink
;
3434 /* Offline files, even if reparse points, are not symlinks. */
3435 if (isoffline (fileattr ()))
3436 goto file_not_symlink
;
3438 /* Reparse points are potentially symlinks. This check must be
3439 performed before checking the SYSTEM attribute for sysfile
3440 symlinks, since reparse points can have this flag set, too. */
3441 if (fileattr () & FILE_ATTRIBUTE_REPARSE_POINT
)
3443 res
= check_reparse_point (h
, fs
.is_remote_drive ());
3446 /* A symlink is never a directory. */
3447 conv_hdl
.fai ()->BasicInformation
.FileAttributes
3448 &= ~FILE_ATTRIBUTE_DIRECTORY
;
3451 else if (res
== 0 && (path_flags () & PATH_REP
))
3452 /* Known reparse point but not a symlink. */
3453 goto file_not_symlink
;
3456 /* Volume moint point or unrecognized reparse point type.
3457 Make sure the open handle is not used in later stat calls.
3458 The handle has been opened with the FILE_OPEN_REPARSE_POINT
3459 flag, so it's a handle to the reparse point, not a handle
3460 to the volumes root dir. */
3461 pc_flags (pc_flags () & ~PC_KEEP_HANDLE
);
3462 /* Volume mount point: The filesystem information for the top
3463 level directory should be for the volume top level directory,
3464 rather than for the reparse point itself. So we fetch the
3465 filesystem information again, but with a NULL handle.
3466 This does what we want because fs_info::update opens the
3467 handle without FILE_OPEN_REPARSE_POINT. */
3469 fs
.update (&upath
, NULL
);
3473 /* Windows shortcuts are potentially treated as symlinks. Valid Cygwin
3474 & U/WIN shortcuts are R/O, but definitely not directories. */
3475 else if ((fileattr () & (FILE_ATTRIBUTE_READONLY
3476 | FILE_ATTRIBUTE_DIRECTORY
))
3477 == FILE_ATTRIBUTE_READONLY
3478 && suffix
.lnk_match ())
3482 status
= NtOpenFile (&sym_h
, SYNCHRONIZE
| GENERIC_READ
, &attr
, &io
,
3483 FILE_SHARE_VALID_FLAGS
,
3485 | FILE_OPEN_FOR_BACKUP_INTENT
3486 | FILE_SYNCHRONOUS_IO_NONALERT
);
3487 if (!NT_SUCCESS (status
))
3491 res
= check_shortcut (sym_h
);
3496 /* If searching for `foo' and then finding a `foo.lnk' which
3497 is no shortcut, return the same as if file not found. */
3498 if (ext_tacked_on ())
3500 fileattr (INVALID_FILE_ATTRIBUTES
);
3505 else if (contents
[0] != ':' || contents
[1] != '\\'
3506 || !parse_device (contents
))
3508 if (fs
.is_nfs () && dev () == FH_FIFO
)
3510 conv_hdl
.nfsattr ()->type
= NF3FIFO
;
3511 conv_hdl
.nfsattr ()->mode
= mode ();
3512 conv_hdl
.nfsattr ()->size
= 0;
3513 /* Marker for fhandler_base::fstat_by_nfs_ea not to override
3514 the cached fattr3 data with fresh data from the filesystem,
3515 even if the handle is used for other purposes than stat. */
3516 conv_hdl
.nfsattr ()->filler1
= NF3FIFO
;
3520 /* If searching for `foo' and then finding a `foo.lnk' which is
3521 no shortcut, return the same as if file not found. */
3522 else if (suffix
.lnk_match () && ext_tacked_on ())
3524 fileattr (INVALID_FILE_ATTRIBUTES
);
3529 /* This is the old Cygwin method creating symlinks. A symlink will
3530 have the `system' file attribute. Only files can be symlinks
3531 (which can be symlinks to directories). */
3532 else if ((fileattr () & (FILE_ATTRIBUTE_SYSTEM
3533 | FILE_ATTRIBUTE_DIRECTORY
))
3534 == FILE_ATTRIBUTE_SYSTEM
)
3538 status
= NtOpenFile (&sym_h
, SYNCHRONIZE
| GENERIC_READ
, &attr
, &io
,
3539 FILE_SHARE_VALID_FLAGS
,
3541 | FILE_OPEN_FOR_BACKUP_INTENT
3542 | FILE_SYNCHRONOUS_IO_NONALERT
);
3544 if (!NT_SUCCESS (status
))
3548 res
= check_sysfile (sym_h
);
3555 /* If the file is on an NFS share and could be opened with extended
3556 attributes, check if it's a symlink or FIFO. */
3557 else if (fs
.is_nfs ())
3559 /* Make sure filler1 is 0, so we can use it safely as a marker. */
3560 conv_hdl
.nfsattr ()->filler1
= 0;
3561 switch (conv_hdl
.nfsattr ()->type
& 7)
3564 res
= check_nfs_symlink (h
);
3567 /* Enable real FIFOs recognized as such. */
3569 mode (S_IFIFO
| (conv_hdl
.nfsattr ()->mode
& ~S_IFMT
));
3578 /* Check if the inner path components contain native symlinks or
3579 junctions, or if the drive is a virtual drive. Compare incoming
3580 path with path returned by GetFinalPathNameByHandleA. If they
3581 differ, return the final path as symlink content and set symlen
3582 to a negative value. This forces path_conv::check to restart
3583 symlink evaluation with the new path. */
3584 if ((pc_flags () & (PC_SYM_FOLLOW
| PC_SYM_NOFOLLOW_REP
))
3587 PWCHAR fpbuf
= tp
.w_get ();
3590 ret
= GetFinalPathNameByHandleW (h
, fpbuf
, NT_MAX_PATH
, 0);
3593 UNICODE_STRING fpath
;
3595 /* If incoming path has no trailing backslash, but final path
3596 has one, drop trailing backslash from final path so the
3597 below string comparison has a chance to succeed.
3598 On the contrary, if incoming path has trailing backslash,
3599 but final path does not have one, add trailing backslash
3600 to the final path. */
3601 if (upath
.Buffer
[(upath
.Length
- 1) / sizeof (WCHAR
)] != L
'\\'
3602 && fpbuf
[ret
- 1] == L
'\\')
3603 fpbuf
[--ret
] = L
'\0';
3604 if (upath
.Buffer
[(upath
.Length
- 1) / sizeof (WCHAR
)] == L
'\\'
3605 && fpbuf
[ret
- 1] != L
'\\' && ret
< NT_MAX_PATH
- 1)
3607 fpbuf
[ret
++] = L
'\\';
3610 fpbuf
[1] = L
'?'; /* \\?\ --> \??\ */
3611 RtlInitCountedUnicodeString (&fpath
, fpbuf
, ret
* sizeof (WCHAR
));
3612 if (!RtlEqualUnicodeString (&upath
, &fpath
, !!ci_flag
))
3614 /* If the incoming path is a local drive letter path... */
3615 if (!RtlEqualUnicodePathPrefix (&upath
, &ro_u_uncp
, TRUE
))
3617 /* ...and the final path is an UNC path, revert to the
3618 drive letter path syntax. */
3619 if (RtlEqualUnicodePathPrefix (&fpath
, &ro_u_uncp
, TRUE
))
3621 if (!revert_virtual_drive (&upath
, &fpath
, true,
3623 goto file_not_symlink
;
3625 /* ...otherwise, if the final path changes the drive
3626 letter, let revert_virtual_drive check for a
3627 virtual drive and revert that. */
3628 else if (upath
.Buffer
[5] == L
':'
3629 && (WCHAR
) towupper (upath
.Buffer
[4])
3630 != (WCHAR
) towupper (fpath
.Buffer
[4]))
3632 if (!revert_virtual_drive (&upath
, &fpath
, false,
3634 goto file_not_symlink
;
3637 /* upath.Buffer is big enough and unused from this point on.
3638 Reuse it here, avoiding yet another buffer allocation. */
3639 char *nfpath
= (char *) upath
.Buffer
;
3640 sys_wcstombs (nfpath
, NT_MAX_PATH
, fpbuf
);
3641 /* For final paths differing in inner path components return
3642 length as negative value. This informs path_conv::check
3643 to skip realpath handling on the last path component. */
3644 res
= -posixify (nfpath
);
3653 syscall_printf ("%s", isdevice () ? "is a device" : "not a symlink");
3660 if (pc_flags () & PC_KEEP_HANDLE
)
3666 syscall_printf ("%d = symlink.check(%s, %p) (mount_flags %y, path_flags %y)",
3667 res
, suffix
.path
, contents
, mount_flags (), path_flags ());
3671 /* "path" is the path in a virtual symlink. Set a symlink_info struct from
3672 that and proceed with further path checking afterwards. */
3674 symlink_info::set (char *path
)
3676 strcpy (contents
, path
);
3678 path_flags (PATH_SYMLINK
);
3679 fileattr (FILE_ATTRIBUTE_NORMAL
);
3682 ext_tacked_on (false);
3686 return strlen (path
);
3689 /* readlink system call */
3692 readlink (const char *__restrict path
, char *__restrict buf
, size_t buflen
)
3696 set_errno (ENAMETOOLONG
);
3700 path_conv
pathbuf (path
, PC_SYM_CONTENTS
, stat_suffixes
);
3704 set_errno (pathbuf
.error
);
3705 syscall_printf ("-1 = readlink (%s, %p, %lu)", path
, buf
, buflen
);
3709 if (!pathbuf
.exists ())
3715 if (!pathbuf
.issymlink ())
3717 if (pathbuf
.exists ())
3722 size_t pathbuf_len
= strlen (pathbuf
.get_win32 ());
3723 ssize_t len
= MIN (buflen
, pathbuf_len
);
3724 memcpy (buf
, pathbuf
.get_win32 (), len
);
3726 /* errno set by symlink.check if error */
3730 /* Some programs rely on st_dev/st_ino being unique for each file.
3731 Hash the path name and hope for the best. The hash arg is not
3732 always initialized to zero since readdir needs to compute the
3733 dirent ino_t based on a combination of the hash of the directory
3734 done during the opendir call and the hash or the filename within
3735 the directory. FIXME: Not bullet-proof. */
3736 /* Cygwin internal */
3738 hash_path_name (ino_t hash
, PUNICODE_STRING name
)
3740 if (name
->Length
== 0)
3743 /* Build up hash. Name is already normalized */
3744 USHORT len
= name
->Length
/ sizeof (WCHAR
);
3745 for (USHORT idx
= 0; idx
< len
; ++idx
)
3746 hash
= RtlUpcaseUnicodeChar (name
->Buffer
[idx
])
3747 + (hash
<< 6) + (hash
<< 16) - hash
;
3752 hash_path_name (ino_t hash
, PCWSTR name
)
3754 UNICODE_STRING uname
;
3755 RtlInitUnicodeString (&uname
, name
);
3756 return hash_path_name (hash
, &uname
);
3760 hash_path_name (ino_t hash
, const char *name
)
3762 UNICODE_STRING uname
;
3766 sys_mbstouni (&uname
, HEAP_NOTHEAP
, name
);
3767 ino_t ret
= hash_path_name (hash
, &uname
);
3772 getcwd (char *buf
, size_t ulen
)
3778 if (ulen
== 0 && buf
)
3781 res
= cygheap
->cwd
.get (buf
, 1, 1, ulen
);
3783 __except (EFAULT
) {}
3788 /* getwd: Legacy. */
3792 return getcwd (buf
, PATH_MAX
+ 1); /*Per SuSv3!*/
3796 get_current_dir_name (void)
3798 const char *pwd
= getenv ("PWD");
3799 char *cwd
= getcwd (NULL
, 0);
3800 struct stat pwdbuf
, cwdbuf
;
3802 if (pwd
&& strcmp (pwd
, cwd
) != 0
3803 && stat (pwd
, &pwdbuf
) == 0
3804 && stat (cwd
, &cwdbuf
) == 0
3805 && pwdbuf
.st_dev
== cwdbuf
.st_dev
3806 && pwdbuf
.st_ino
== cwdbuf
.st_ino
)
3808 cwd
= (char *) realloc (cwd
, strlen (pwd
) + 1);
3815 /* chdir: POSIX 5.2.1.1 */
3817 chdir (const char *in_dir
)
3829 syscall_printf ("dir '%s'", in_dir
);
3831 /* Convert path. PC_NONULLEMPTY ensures that we don't check for
3832 NULL/empty/invalid again. */
3833 path_conv
path (in_dir
, PC_SYM_FOLLOW
| PC_POSIX
| PC_NONULLEMPTY
);
3836 set_errno (path
.error
);
3837 syscall_printf ("-1 = chdir (%s)", in_dir
);
3841 const char *posix_cwd
= NULL
;
3842 dev_t devn
= path
.get_device ();
3843 if (!path
.exists ())
3845 else if (!path
.isdir ())
3846 set_errno (ENOTDIR
);
3847 else if (!isvirtual_dev (devn
))
3849 /* The sequence chdir("xx"); chdir(".."); must be a noop if xx
3850 is not a symlink. This is exploited by find.exe.
3851 The posix_cwd is just path.get_posix ().
3852 In other cases we let cwd.set obtain the Posix path through
3854 if (!isdrive (path
.get_posix ()))
3855 posix_cwd
= path
.get_posix ();
3860 posix_cwd
= path
.get_posix ();
3865 res
= cygheap
->cwd
.set (&path
, posix_cwd
);
3867 /* Note that we're accessing cwd.posix without a lock here.
3868 I didn't think it was worth locking just for strace. */
3869 syscall_printf ("%R = chdir() cygheap->cwd.posix '%s' native '%S'", res
,
3870 cygheap
->cwd
.get_posix (), path
.get_nt_native_path ());
3884 cygheap_fdget
cfd (fd
);
3886 res
= chdir (cfd
->get_name ());
3890 syscall_printf ("%R = fchdir(%d)", res
, fd
);
3894 /******************** Exported Path Routines *********************/
3896 /* Cover functions to the path conversion routines.
3897 These are exported to the world as cygwin_foo by cygwin.din. */
3899 #define return_with_errno(x) \
3909 cygwin_conv_path (cygwin_conv_path_t what
, const void *from
, void *to
,
3918 int how
= what
& CCP_CONVFLAGS_MASK
;
3919 what
&= CCP_CONVTYPE_MASK
;
3932 case CCP_POSIX_TO_WIN_A
:
3934 p
.check ((const char *) from
,
3935 PC_POSIX
| PC_SYM_FOLLOW
| PC_SYM_NOFOLLOW_REP
3936 | PC_NO_ACCESS_CHECK
3937 | ((how
& CCP_RELATIVE
) ? PC_NOFULL
: 0), stat_suffixes
);
3940 set_errno (p
.error
);
3943 PUNICODE_STRING up
= p
.get_nt_native_path ();
3945 sys_wcstombs (buf
, NT_MAX_PATH
,
3946 up
->Buffer
, up
->Length
/ sizeof (WCHAR
));
3947 /* Convert native path to standard DOS path. */
3948 if (!strncmp (buf
, "\\??\\", 4))
3951 if (buf
[1] != ':') /* native UNC path */
3954 else if (*buf
== '\\')
3956 /* Device name points to somewhere else in the NT namespace.
3957 Use GLOBALROOT prefix to convert to Win32 path. */
3958 char *p
= buf
+ sys_wcstombs (buf
, NT_MAX_PATH
,
3959 ro_u_globalroot
.Buffer
,
3960 ro_u_globalroot
.Length
3962 sys_wcstombs (p
, NT_MAX_PATH
- (p
- buf
),
3963 up
->Buffer
, up
->Length
/ sizeof (WCHAR
));
3965 lsiz
= strlen (buf
) + 1;
3966 /* TODO: Incoming "." is a special case which leads to a trailing
3967 backslash ".\\" in the Win32 path. That's a result of the
3968 conversion in normalize_posix_path. This should not occur
3969 so the below code is just a band-aid. */
3970 if ((how
& CCP_RELATIVE
) && !strcmp ((const char *) from
, ".")
3971 && !strcmp (buf
, ".\\"))
3978 case CCP_POSIX_TO_WIN_W
:
3979 p
.check ((const char *) from
,
3980 PC_POSIX
| PC_SYM_FOLLOW
| PC_SYM_NOFOLLOW_REP
3981 | PC_NO_ACCESS_CHECK
3982 | ((how
& CCP_RELATIVE
) ? PC_NOFULL
: 0), stat_suffixes
);
3985 set_errno (p
.error
);
3988 /* Relative Windows paths are always restricted to MAX_PATH chars. */
3989 if ((how
& CCP_RELATIVE
) && !isabspath (p
.get_win32 ())
3990 && sys_mbstowcs (NULL
, 0, p
.get_win32 ()) > MAX_PATH
)
3992 /* Recreate as absolute path. */
3993 p
.check ((const char *) from
, PC_POSIX
| PC_SYM_FOLLOW
3994 | PC_NO_ACCESS_CHECK
);
3997 set_errno (p
.error
);
4001 lsiz
= p
.get_wide_win32_path_len () + 1;
4002 path
= p
.get_nt_native_path ()->Buffer
;
4004 /* Convert native path to standard DOS path. */
4005 if (!wcsncmp (path
, L
"\\??\\", 4))
4009 /* Drop long path prefix for short pathnames. Unfortunately there's
4010 quite a bunch of Win32 functions, especially in user32.dll,
4011 apparently, which don't grok long path names at all, not even
4012 in the UNICODE API. */
4013 if ((path
[5] == L
':' && lsiz
<= MAX_PATH
+ 4)
4014 || (!wcsncmp (path
+ 4, L
"UNC\\", 4) && lsiz
<= MAX_PATH
+ 6))
4018 if (path
[1] != L
':')
4020 *(path
+= 2) = '\\';
4025 else if (*path
== L
'\\')
4027 /* Device name points to somewhere else in the NT namespace.
4028 Use GLOBALROOT prefix to convert to Win32 path. */
4029 to
= (void *) wcpcpy ((wchar_t *) to
, ro_u_globalroot
.Buffer
);
4030 lsiz
+= ro_u_globalroot
.Length
/ sizeof (WCHAR
);
4032 /* TODO: Same ".\\" band-aid as in CCP_POSIX_TO_WIN_A case. */
4033 if ((how
& CCP_RELATIVE
) && !strcmp ((const char *) from
, ".")
4034 && !wcscmp (path
, L
".\\"))
4039 lsiz
*= sizeof (WCHAR
);
4041 case CCP_WIN_A_TO_POSIX
:
4043 error
= mount_table
->conv_to_posix_path ((const char *) from
, buf
,
4044 how
| __CCP_APP_SLASH
);
4047 set_errno (p
.error
);
4050 lsiz
= strlen (buf
) + 1;
4052 case CCP_WIN_W_TO_POSIX
:
4054 error
= mount_table
->conv_to_posix_path ((const PWCHAR
) from
, buf
,
4055 how
| __CCP_APP_SLASH
);
4061 lsiz
= strlen (buf
) + 1;
4079 case CCP_POSIX_TO_WIN_A
:
4080 case CCP_WIN_A_TO_POSIX
:
4081 case CCP_WIN_W_TO_POSIX
:
4082 stpcpy ((char *) to
, buf
);
4084 case CCP_POSIX_TO_WIN_W
:
4085 wcpcpy ((PWCHAR
) to
, path
);
4090 __except (EFAULT
) {}
4096 cygwin_create_path (cygwin_conv_path_t what
, const void *from
)
4099 ssize_t size
= cygwin_conv_path (what
, from
, NULL
, 0);
4102 else if (!(to
= malloc (size
)))
4104 if (cygwin_conv_path (what
, from
, to
, size
) == -1)
4112 /* The realpath function is required by POSIX:2008. */
4115 realpath (const char *__restrict path
, char *__restrict resolved
)
4120 /* Make sure the right errno is returned if path is NULL. */
4127 /* Guard reading from a potentially invalid path and writing to a
4128 potentially invalid resolved. */
4131 /* Win32 drive letter paths and, generally, any path starting with a
4132 backslash, have to be converted to a POSIX path first, because
4133 path_conv leaves the incoming path untouched except for converting
4134 backslashes to forward slashes. This also covers '\\?\ and '\??\'
4136 if (isdrive (path
) || path
[0] == '\\')
4138 tpath
= tp
.c_get ();
4139 mount_table
->conv_to_posix_path (path
, tpath
, 0);
4142 tpath
= (char *) path
;
4144 path_conv
real_path (tpath
, PC_SYM_FOLLOW
| PC_POSIX
, stat_suffixes
);
4147 /* POSIX 2008 requires malloc'ing if resolved is NULL, and states
4148 that using non-NULL resolved is asking for portability
4151 if (!real_path
.error
&& real_path
.exists ())
4156 malloc (strlen (real_path
.get_posix ()) + 1);
4160 strcpy (resolved
, real_path
.get_posix ());
4164 /* FIXME: on error, Linux puts the name of the path
4165 component which could not be resolved into RESOLVED, but POSIX
4166 does not require this. */
4169 set_errno (real_path
.error
?: ENOENT
);
4171 __except (EFAULT
) {}
4176 /* Linux provides this extension. Since the only portable use of
4177 realpath requires a NULL second argument, we might as well have a
4178 one-argument wrapper. */
4180 canonicalize_file_name (const char *path
)
4182 return realpath (path
, NULL
);
4185 /* Return non-zero if path is a POSIX path list.
4186 This is exported to the world as cygwin_foo by cygwin.din.
4189 <sect1 id="add-func-cygwin-posix-path-list-p">
4190 <para>Rather than use a mode to say what the "proper" path list
4191 format is, we allow any, and give apps the tools they need to
4192 convert between the two. If a ';' is present in the path list it's
4193 a Win32 path list. Otherwise, if the first path begins with
4194 [letter]: (in which case it can be the only element since if it
4195 wasn't a ';' would be present) it's a Win32 path list. Otherwise,
4196 it's a POSIX path list.</para>
4202 cygwin_posix_path_list_p (const char *path
)
4204 int posix_p
= !(strchr (path
, ';') || isdrive (path
));
4208 /* These are used for apps that need to convert env vars like PATH back and
4209 forth. The conversion is a two step process. First, an upper bound on the
4210 size of the buffer needed is computed. Then the conversion is done. This
4211 allows the caller to use alloca if it wants. */
4214 conv_path_list_buf_size (const char *path_list
, bool to_posix
)
4216 int i
, num_elms
, max_mount_path_len
, size
;
4219 path_conv
pc(".", PC_POSIX
);
4220 /* The theory is that an upper bound is
4221 current_size + (num_elms * max_mount_path_len) */
4222 /* FIXME: This method is questionable in the long run. */
4225 char delim
= to_posix
? ';' : ':';
4226 for (p
= path_list
, num_elms
= nrel
= 0; p
; num_elms
++)
4230 p
= strchr (++p
, delim
);
4233 /* 7: strlen ("//c") + slop, a conservative initial value */
4234 for (max_mount_path_len
= sizeof ("/cygdrive/X"), i
= 0;
4235 i
< mount_table
->nmounts
; i
++)
4237 int mount_len
= (to_posix
4238 ? mount_table
->mount
[i
].posix_pathlen
4239 : mount_table
->mount
[i
].native_pathlen
);
4240 if (max_mount_path_len
< mount_len
)
4241 max_mount_path_len
= mount_len
;
4245 size
= strlen (path_list
)
4246 + (num_elms
* max_mount_path_len
)
4247 + (nrel
* strlen (to_posix
? pc
.get_posix () : pc
.get_win32 ()))
4254 env_PATH_to_posix (const void *win32
, void *posix
, size_t size
)
4256 return_with_errno (conv_path_list ((const char *) win32
, (char *) posix
,
4261 cygwin_conv_path_list (cygwin_conv_path_t what
, const void *from
, void *to
,
4266 void *orig_to
= NULL
;
4269 switch (what
& CCP_CONVTYPE_MASK
)
4271 case CCP_WIN_W_TO_POSIX
:
4272 if (!sys_wcstombs_alloc (&winp
, HEAP_NOTHEAP
, (const wchar_t *) from
,
4275 what
= (what
& ~CCP_CONVTYPE_MASK
) | CCP_WIN_A_TO_POSIX
;
4276 from
= (const void *) winp
;
4278 case CCP_POSIX_TO_WIN_W
:
4280 return conv_path_list_buf_size ((const char *) from
, 0)
4282 what
= (what
& ~CCP_CONVTYPE_MASK
) | CCP_POSIX_TO_WIN_A
;
4284 to
= (void *) tp
.w_get ();
4288 switch (what
& CCP_CONVTYPE_MASK
)
4290 case CCP_WIN_A_TO_POSIX
:
4291 case CCP_POSIX_TO_WIN_A
:
4293 return conv_path_list_buf_size ((const char *) from
,
4294 what
== CCP_WIN_A_TO_POSIX
);
4295 ret
= conv_path_list ((const char *) from
, (char *) to
, size
, what
);
4296 /* Free winp buffer in case of CCP_WIN_W_TO_POSIX. */
4299 /* Convert to WCHAR in case of CCP_POSIX_TO_WIN_W. */
4301 sys_mbstowcs ((wchar_t *) orig_to
, size
/ sizeof (WCHAR
),
4302 (const char *) to
, (size_t) -1);
4303 return_with_errno (ret
);
4312 /* cygwin_split_path: Split a path into directory and file name parts.
4313 Buffers DIR and FILE are assumed to be big enough.
4315 Examples (path -> `dir' / `file'):
4318 . -> `.' / `.' (FIXME: should this be `.' / `'?)
4319 .. -> `.' / `..' (FIXME: should this be `..' / `'?)
4321 foo/bar -> `foo' / `bar'
4322 foo/bar/ -> `foo' / `bar'
4324 /foo/bar -> `/foo' / `bar'
4327 c:foo -> `c:/' / `foo'
4328 c:/foo -> `c:/' / `foo'
4332 cygwin_split_path (const char *path
, char *dir
, char *file
)
4334 int dir_started_p
= 0;
4336 /* Deal with drives.
4337 Remember that c:foo <==> c:/foo. */
4349 if (isdirsep (*path
))
4354 /* Determine if there are trailing slashes and "delete" them if present.
4355 We pretend as if they don't exist. */
4356 const char *end
= path
+ strlen (path
);
4357 /* path + 1: keep leading slash. */
4358 while (end
> path
+ 1 && isdirsep (end
[-1]))
4361 /* At this point, END points to one beyond the last character
4362 (with trailing slashes "deleted"). */
4364 /* Point LAST_SLASH at the last slash (duh...). */
4365 const char *last_slash
;
4366 for (last_slash
= end
- 1; last_slash
>= path
; --last_slash
)
4367 if (isdirsep (*last_slash
))
4370 if (last_slash
== path
)
4375 else if (last_slash
> path
)
4377 memcpy (dir
, path
, last_slash
- path
);
4378 dir
[last_slash
- path
] = 0;
4383 ; /* nothing to do */
4389 memcpy (file
, last_slash
+ 1, end
- last_slash
- 1);
4390 file
[end
- last_slash
- 1] = 0;
4393 /*****************************************************************************/
4395 /* The find_fast_cwd_pointer function and parts of the
4396 cwdstuff::override_win32_cwd method are based on code using the
4399 Copyright 2010 John Carey. All rights reserved.
4401 Redistribution and use in source and binary forms, with or without
4402 modification, are permitted provided that the following conditions
4405 1. Redistributions of source code must retain the above
4406 copyright notice, this list of conditions and the following
4409 2. Redistributions in binary form must reproduce the above
4410 copyright notice, this list of conditions and the following
4411 disclaimer in the documentation and/or other materials provided
4412 with the distribution.
4414 THIS SOFTWARE IS PROVIDED BY JOHN CAREY ``AS IS'' AND ANY EXPRESS
4415 OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
4416 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
4417 ARE DISCLAIMED. IN NO EVENT SHALL JOHN CAREY OR CONTRIBUTORS BE
4418 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
4419 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
4420 OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
4421 BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
4422 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
4423 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
4424 USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
4428 fcwd_access_t::CopyPath (UNICODE_STRING
&target
)
4430 /* Copy the Path contents over into the UNICODE_STRING referenced by
4431 target. This is used to set the CurrentDirectoryName in the
4432 user parameter block. */
4437 fcwd_access_t::Free (PVOID heap
)
4439 /* Decrement the reference count. If it's down to 0, free
4440 structure from heap. */
4441 if (InterlockedDecrement (&ReferenceCount
) == 0)
4443 /* The handle on init is always a fresh one, not the handle inherited
4444 from the parent process. We always have to close it here.
4445 Note: The handle could be NULL, if we cd'ed into a virtual dir. */
4446 HANDLE h
= DirectoryHandle
;
4449 RtlFreeHeap (heap
, 0, this);
4454 fcwd_access_t::FillIn (HANDLE dir
, PUNICODE_STRING name
,
4455 ULONG old_dismount_count
)
4457 /* Fill in all values into this FAST_CWD structure. */
4458 DirectoryHandle
= dir
;
4460 OldDismountCount
= old_dismount_count
;
4461 /* The fcwd structure stores the device characteristics of the
4462 volume holding the dir. RtlGetCurrentDirectory_U checks
4463 if the FILE_REMOVABLE_MEDIA flag is set and, if so, checks if
4464 the volume is still the same as the one used when opening
4465 the directory handle.
4466 We don't call NtQueryVolumeInformationFile for the \\?\PIPE,
4467 though. It just returns STATUS_INVALID_HANDLE anyway. */
4468 FSCharacteristics
= 0;
4469 if (name
!= &ro_u_pipedir
)
4472 FILE_FS_DEVICE_INFORMATION ffdi
;
4473 if (NT_SUCCESS (NtQueryVolumeInformationFile (dir
, &io
, &ffdi
,
4474 sizeof ffdi
, FileFsDeviceInformation
)))
4475 FSCharacteristics
= ffdi
.Characteristics
;
4477 RtlInitEmptyUnicodeString (&Path
, Buffer
, name
->MaximumLength
);
4478 RtlCopyUnicodeString (&Path
, name
);
4479 if (Path
.Buffer
[Path
.Length
/ sizeof (WCHAR
) - 1] != L
'\\')
4481 Path
.Buffer
[Path
.Length
/ sizeof (WCHAR
)] = L
'\\';
4482 Path
.Length
+= sizeof (WCHAR
);
4487 fcwd_access_t::SetDirHandleFromBufferPointer (PWCHAR buf_p
, HANDLE dir
)
4489 /* Input: The buffer pointer as it's stored in the user parameter block
4490 and a directory handle.
4491 This function computes the address to the FAST_CWD structure based
4492 on the version and overwrites the directory handle. It is only
4493 used if we couldn't figure out the address of fast_cwd_ptr. */
4494 fcwd_access_t
*f_cwd
;
4495 f_cwd
= (fcwd_access_t
*)
4496 ((PBYTE
) buf_p
- __builtin_offsetof (fcwd_access_t
, Buffer
));
4497 f_cwd
->DirectoryHandle
= dir
;
4500 /* This function scans the code in ntdll.dll to find the address of the
4501 global variable used to access the CWD. While the pointer is global,
4502 it's not exported from the DLL, unfortunately. Therefore we have to
4503 use some knowledge to figure out the address. */
4505 #define peek32(x) (*(int32_t *)(x))
4507 static fcwd_access_t
**
4508 find_fast_cwd_pointer ()
4510 /* Fetch entry points of relevant functions in ntdll.dll. */
4511 HMODULE ntdll
= GetModuleHandle ("ntdll.dll");
4514 const uint8_t *get_dir
= (const uint8_t *)
4515 GetProcAddress (ntdll
, "RtlGetCurrentDirectory_U");
4516 const uint8_t *ent_crit
= (const uint8_t *)
4517 GetProcAddress (ntdll
, "RtlEnterCriticalSection");
4518 if (!get_dir
|| !ent_crit
)
4520 /* Search first relative call instruction in RtlGetCurrentDirectory_U. */
4521 const uint8_t *rcall
= (const uint8_t *) memchr (get_dir
, 0xe8, 80);
4524 /* Fetch offset from instruction and compute address of called function.
4525 This function actually fetches the current FAST_CWD instance and
4526 performs some other actions, not important to us. */
4527 const uint8_t *use_cwd
= rcall
+ 5 + peek32 (rcall
+ 1);
4528 /* Next we search for the locking mechanism and perform a sanity check.
4529 On Pre-Windows 8 we basically look for the RtlEnterCriticalSection call.
4530 Windows 8 does not call RtlEnterCriticalSection. The code manipulates
4531 the FastPebLock manually, probably because RtlEnterCriticalSection has
4532 been converted to an inline function. Either way, we test if the code
4533 uses the FastPebLock. */
4534 const uint8_t *movrbx
;
4535 const uint8_t *lock
= (const uint8_t *)
4536 memmem ((const char *) use_cwd
, 80,
4537 "\xf0\x0f\xba\x35", 4);
4540 /* The lock instruction tweaks the LockCount member, which is not at
4541 the start of the PRTL_CRITICAL_SECTION structure. So we have to
4542 subtract the offset of LockCount to get the real address. */
4543 PRTL_CRITICAL_SECTION lockaddr
=
4544 (PRTL_CRITICAL_SECTION
) (lock
+ 9 + peek32 (lock
+ 4)
4545 - offsetof (RTL_CRITICAL_SECTION
, LockCount
));
4546 /* Test if lock address is FastPebLock. */
4547 if (lockaddr
!= NtCurrentTeb ()->Peb
->FastPebLock
)
4549 /* Search `mov rel(%rip),%rbx'. This is the instruction fetching the
4550 address of the current fcwd_access_t pointer, and it should be pretty
4551 near to the locking stuff. */
4552 movrbx
= (const uint8_t *) memmem ((const char *) lock
, 40,
4557 /* Usually the callq RtlEnterCriticalSection follows right after
4558 fetching the lock address. */
4559 int call_rtl_offset
= 7;
4560 /* Search `lea rel(%rip),%rcx'. This loads the address of the lock into
4561 %rcx for the subsequent RtlEnterCriticalSection call. */
4562 lock
= (const uint8_t *) memmem ((const char *) use_cwd
, 80,
4566 /* Windows 8.1 Preview calls `lea rel(rip),%r12' then some unrelated
4567 ops, then `mov %r12,%rcx', then `callq RtlEnterCriticalSection'. */
4568 lock
= (const uint8_t *) memmem ((const char *) use_cwd
, 80,
4570 call_rtl_offset
= 14;
4575 /* A recent Windows 11 Preview calls `lea rel(rip),%r13' then
4576 some unrelated instructions, then `callq RtlEnterCriticalSection'.
4578 lock
= (const uint8_t *) memmem ((const char *) use_cwd
, 80,
4580 call_rtl_offset
= 24;
4588 PRTL_CRITICAL_SECTION lockaddr
=
4589 (PRTL_CRITICAL_SECTION
) (lock
+ 7 + peek32 (lock
+ 3));
4590 /* Test if lock address is FastPebLock. */
4591 if (lockaddr
!= NtCurrentTeb ()->Peb
->FastPebLock
)
4593 /* Next is the `callq RtlEnterCriticalSection'. */
4594 lock
+= call_rtl_offset
;
4595 if (lock
[0] != 0xe8)
4597 const uint8_t *call_addr
= (const uint8_t *)
4598 (lock
+ 5 + peek32 (lock
+ 1));
4599 if (call_addr
!= ent_crit
)
4601 /* In contrast to the above Windows 8 code, we don't have to search
4602 for the `mov rel(%rip),%rbx' instruction. It follows right after
4603 the call to RtlEnterCriticalSection. */
4608 /* Check that the next instruction tests if the fetched value is NULL. */
4609 const uint8_t *testrbx
= (const uint8_t *)
4610 memmem (movrbx
+ 7, 3, "\x48\x85\xdb", 3);
4613 /* Compute address of the fcwd_access_t ** pointer. */
4614 return (fcwd_access_t
**) (testrbx
+ peek32 (movrbx
+ 3));
4617 static fcwd_access_t
**
4620 USHORT emulated
, hosted
;
4621 fcwd_access_t
**f_cwd_ptr
;
4623 /* First check if we're running in WOW64 on ARM64 emulating AMD64. Skip
4624 fetching FAST_CWD pointer as long as there's no solution for finding
4625 it on that system. */
4626 if (IsWow64Process2 (GetCurrentProcess (), &emulated
, &hosted
)
4627 && hosted
== IMAGE_FILE_MACHINE_ARM64
)
4630 /* Fetch the pointer but don't set the global fast_cwd_ptr yet. First
4631 we have to make sure we know the version of the FAST_CWD structure
4632 used on the system. */
4633 f_cwd_ptr
= find_fast_cwd_pointer ();
4635 small_printf ("Cygwin WARNING:\n"
4636 " Couldn't compute FAST_CWD pointer. This typically occurs if you're using\n"
4637 " an older Cygwin version on a newer Windows. Please update to the latest\n"
4638 " available Cygwin version from https://cygwin.com/. If the problem persists,\n"
4639 " please see https://cygwin.com/problems.html\n\n");
4641 /* Eventually, after we set the version as well, set fast_cwd_ptr. */
4646 cwdstuff::override_win32_cwd (bool init
, ULONG old_dismount_count
)
4650 PEB
&peb
= *NtCurrentTeb ()->Peb
;
4651 UNICODE_STRING
&upp_cwd_str
= peb
.ProcessParameters
->CurrentDirectoryName
;
4652 HANDLE
&upp_cwd_hdl
= peb
.ProcessParameters
->CurrentDirectoryHandle
;
4653 PUNICODE_STRING win32_cwd_ptr
= error
? &ro_u_pipedir
: &win32
;
4655 if (fast_cwd_ptr
== (fcwd_access_t
**) -1)
4656 fast_cwd_ptr
= find_fast_cwd ();
4659 /* If we got a valid value for fast_cwd_ptr, we can simply replace
4660 the RtlSetCurrentDirectory_U function entirely. */
4661 PVOID heap
= peb
.ProcessHeap
;
4662 /* First allocate a new fcwd_access_t structure on the heap. */
4663 fcwd_access_t
*f_cwd
= (fcwd_access_t
*)
4664 RtlAllocateHeap (heap
, 0,
4665 sizeof (fcwd_access_t
)
4666 + win32_cwd_ptr
->MaximumLength
);
4669 debug_printf ("RtlAllocateHeap failed");
4672 /* Fill in the values. */
4673 f_cwd
->FillIn (dir
, win32_cwd_ptr
, old_dismount_count
);
4674 /* Use PEB lock when switching fast_cwd_ptr to the new FAST_CWD
4675 structure and writing the CWD to the user process parameter
4676 block. This is equivalent to calling RtlAcquirePebLock/
4677 RtlReleasePebLock, but without having to go through the FS
4679 RtlEnterCriticalSection (peb
.FastPebLock
);
4680 fcwd_access_t
*old_cwd
= *fast_cwd_ptr
;
4681 *fast_cwd_ptr
= f_cwd
;
4682 f_cwd
->CopyPath (upp_cwd_str
);
4684 RtlLeaveCriticalSection (peb
.FastPebLock
);
4686 old_cwd
->Free (heap
);
4690 /* Fallback if we failed to find the fast_cwd_ptr value:
4692 - Call RtlSetCurrentDirectory_U.
4693 - Compute new FAST_CWD struct address from buffer pointer in the
4694 user process parameter block.
4695 - Replace the directory handle in the struct with our own handle.
4696 - Close the original handle. RtlSetCurrentDirectory_U already
4697 closed our former dir handle -> no handle leak.
4699 Guard the entire operation with FastPebLock to avoid races
4700 accessing the PEB and FAST_CWD struct.
4702 Unfortunately this method is still prone to a directory usage
4705 - The directory is locked against deletion or renaming between the
4706 RtlSetCurrentDirectory_U and the subsequent NtClose call. */
4707 if (unlikely (upp_cwd_hdl
== NULL
) && init
)
4709 RtlEnterCriticalSection (peb
.FastPebLock
);
4713 RtlSetCurrentDirectory_U (win32_cwd_ptr
);
4714 if (!NT_SUCCESS (status
))
4716 RtlLeaveCriticalSection (peb
.FastPebLock
);
4717 debug_printf ("RtlSetCurrentDirectory_U(%S) failed, %y",
4722 fcwd_access_t::SetDirHandleFromBufferPointer(upp_cwd_str
.Buffer
, dir
);
4725 RtlLeaveCriticalSection (peb
.FastPebLock
);
4726 /* The handle on init is always a fresh one, not the handle inherited
4727 from the parent process. We always have to close it here. */
4732 /* Initialize cwdstuff */
4736 /* Cygwin processes inherit the cwd from their parent. If the win32 path
4737 buffer is not NULL, the cwd struct is already set up, and we only
4738 have to override the Win32 CWD with ours. */
4740 override_win32_cwd (true, SharedUserData
.DismountCount
);
4743 /* Initialize fast_cwd stuff. */
4744 fast_cwd_ptr
= (fcwd_access_t
**) -1;
4745 /* Initially re-open the cwd to allow POSIX semantics. */
4750 /* Chdir and fill out the elements of a cwdstuff struct. */
4752 cwdstuff::set (path_conv
*nat_cwd
, const char *posix_cwd
)
4755 UNICODE_STRING upath
;
4756 OBJECT_ATTRIBUTES attr
;
4757 PEB
&peb
= *NtCurrentTeb ()->Peb
;
4758 bool virtual_path
= false;
4759 bool unc_path
= false;
4760 bool inaccessible_path
= false;
4762 /* Here are the problems with using SetCurrentDirectory. Just skip this
4763 comment if you don't like whining.
4765 - SetCurrentDirectory only supports paths of up to MAX_PATH - 1 chars,
4766 including a trailing backslash. That's an absolute restriction, even
4769 - SetCurrentDirectory fails for directories with strict permissions even
4770 for processes with the SE_BACKUP_NAME privilege enabled. The reason
4771 is apparently that SetCurrentDirectory calls NtOpenFile without the
4772 FILE_OPEN_FOR_BACKUP_INTENT flag set.
4774 - SetCurrentDirectory does not support case-sensitivity.
4776 - Unlinking a cwd fails because SetCurrentDirectory seems to open
4777 directories so that deleting the directory is disallowed.
4779 - SetCurrentDirectory can naturally not work on virtual Cygwin paths
4780 like /proc or /cygdrive.
4782 Nevertheless, doing entirely without SetCurrentDirectory is not really
4783 feasible, because it breaks too many mixed applications using the Win32
4786 Therefore we handle the CWD all by ourselves and just keep the Win32
4787 CWD in sync. However, to avoid surprising behaviour in the Win32 API
4788 when we are in a CWD which is inaccessible as Win32 CWD, we set the
4789 Win32 CWD to a "weird" directory in which all relative filesystem-related
4794 upath
= *nat_cwd
->get_nt_native_path ();
4795 if (nat_cwd
->isspecial ())
4797 virtual_path
= true;
4798 /* But allow starting of native apps from /dev if /dev actually
4800 if (isdev_dev (nat_cwd
->dev
))
4802 FILE_BASIC_INFORMATION fbi
;
4804 InitializeObjectAttributes (&attr
, &upath
,
4805 OBJ_CASE_INSENSITIVE
| OBJ_INHERIT
,
4807 status
= NtQueryAttributesFile (&attr
, &fbi
);
4808 if (status
!= STATUS_OBJECT_NAME_NOT_FOUND
4809 && status
!= STATUS_OBJECT_PATH_NOT_FOUND
)
4810 virtual_path
= false;
4817 /* Memorize old DismountCount before opening the dir. This value is
4818 stored in the FAST_CWD structure. It would be simpler to fetch the
4819 old DismountCount in override_win32_cwd, but Windows also fetches
4820 it before opening the directory handle. It's not quite clear if
4821 that's really required, but since we don't know the side effects of
4822 this action, we better follow Windows' lead. */
4823 ULONG old_dismount_count
= SharedUserData
.DismountCount
;
4824 /* Open a directory handle with FILE_OPEN_FOR_BACKUP_INTENT and with all
4825 sharing flags set. The handle is right now used in exceptions.cc only,
4826 but that might change in future. */
4834 /* On init, just reopen Win32 CWD with desired access flags.
4835 We can access the PEB without lock, because no other thread
4836 can change the CWD. However, there's a chance that the handle
4837 is NULL, even though CurrentDirectoryName isn't so we have to
4839 if (!peb
.ProcessParameters
->CurrentDirectoryHandle
)
4841 InitializeObjectAttributes (&attr
,
4842 &peb
.ProcessParameters
->CurrentDirectoryName
,
4843 OBJ_CASE_INSENSITIVE
| OBJ_INHERIT
, NULL
, NULL
);
4847 RtlInitUnicodeString (&upath
, L
"");
4848 InitializeObjectAttributes (&attr
,
4849 &upath
, OBJ_CASE_INSENSITIVE
| OBJ_INHERIT
,
4850 peb
.ProcessParameters
->CurrentDirectoryHandle
,
4855 InitializeObjectAttributes (&attr
, &upath
,
4856 nat_cwd
->objcaseinsensitive () | OBJ_INHERIT
,
4858 /* First try without FILE_OPEN_FOR_BACKUP_INTENT, to find out if the
4859 directory is valid for Win32 apps. And, no, we can't just call
4860 SetCurrentDirectory here, since that would potentially break
4861 case-sensitivity. */
4862 status
= NtOpenFile (&h
, SYNCHRONIZE
| FILE_TRAVERSE
, &attr
, &io
,
4863 FILE_SHARE_VALID_FLAGS
,
4865 | FILE_SYNCHRONOUS_IO_NONALERT
);
4866 if (status
== STATUS_ACCESS_DENIED
)
4868 status
= NtOpenFile (&h
, SYNCHRONIZE
| FILE_TRAVERSE
, &attr
, &io
,
4869 FILE_SHARE_VALID_FLAGS
,
4871 | FILE_SYNCHRONOUS_IO_NONALERT
4872 | FILE_OPEN_FOR_BACKUP_INTENT
);
4873 inaccessible_path
= true;
4875 if (!NT_SUCCESS (status
))
4877 /* Called from chdir? Just fail. */
4881 __seterrno_from_nt_status (status
);
4884 /* Otherwise we're in init and posix hasn't been set yet. Try to
4885 duplicate the handle instead. If that fails, too, set dir to NULL
4886 and carry on. This will at least set posix to some valid path at
4887 process startup, and subsequent getcwd calls don't EFAULT. */
4888 debug_printf ("WARNING: Can't reopen CWD %y '%S', status %y",
4889 peb
.ProcessParameters
->CurrentDirectoryHandle
,
4890 &peb
.ProcessParameters
->CurrentDirectoryName
,
4892 if (!peb
.ProcessParameters
->CurrentDirectoryHandle
4893 || !DuplicateHandle (GetCurrentProcess (),
4894 peb
.ProcessParameters
->CurrentDirectoryHandle
,
4895 GetCurrentProcess (), &h
, 0, TRUE
, 0))
4897 if (peb
.ProcessParameters
->CurrentDirectoryHandle
)
4898 debug_printf ("...and DuplicateHandle failed with %E.");
4903 /* Set new handle. Note that we simply overwrite the old handle here
4904 without closing it. The handle is also used as Win32 CWD handle in
4905 the user parameter block, and it will be closed in override_win32_cwd,
4911 /* On init, just fetch the Win32 dir from the PEB. We can access
4912 the PEB without lock, because no other thread can change the CWD
4914 PUNICODE_STRING pdir
= &peb
.ProcessParameters
->CurrentDirectoryName
;
4915 RtlInitEmptyUnicodeString (&win32
,
4916 (PWCHAR
) crealloc_abort (win32
.Buffer
,
4919 pdir
->Length
+ sizeof (WCHAR
));
4920 RtlCopyUnicodeString (&win32
, pdir
);
4922 PWSTR eoBuffer
= win32
.Buffer
+ (win32
.Length
/ sizeof (WCHAR
));
4923 /* Remove trailing slash if one exists. */
4924 if ((eoBuffer
- win32
.Buffer
) > 3 && eoBuffer
[-1] == L
'\\')
4925 win32
.Length
-= sizeof (WCHAR
);
4926 if (eoBuffer
[0] == L
'\\')
4933 if (!virtual_path
) /* don't mangle virtual path. */
4935 /* Convert into Win32 path and compute length. */
4936 if (upath
.Buffer
[1] == L
'?')
4939 upath
.Length
-= 4 * sizeof (WCHAR
);
4940 if (upath
.Buffer
[1] != L
':')
4944 upath
.Length
-= 2 * sizeof (WCHAR
);
4950 /* Path via native NT namespace. Prepend GLOBALROOT prefix
4951 to create a valid Win32 path. */
4952 PWCHAR buf
= (PWCHAR
) alloca (upath
.Length
4953 + ro_u_globalroot
.Length
4955 wcpcpy (wcpcpy (buf
, ro_u_globalroot
.Buffer
), upath
.Buffer
);
4957 upath
.Length
+= ro_u_globalroot
.Length
;
4959 PWSTR eoBuffer
= upath
.Buffer
+ (upath
.Length
/ sizeof (WCHAR
));
4960 /* Remove trailing slash if one exists. */
4961 if ((eoBuffer
- upath
.Buffer
) > 3 && eoBuffer
[-1] == L
'\\')
4962 upath
.Length
-= sizeof (WCHAR
);
4964 RtlInitEmptyUnicodeString (&win32
,
4965 (PWCHAR
) crealloc_abort (win32
.Buffer
,
4968 upath
.Length
+ sizeof (WCHAR
));
4969 RtlCopyUnicodeString (&win32
, &upath
);
4971 win32
.Buffer
[0] = L
'\\';
4973 /* Make sure it's NUL-terminated. */
4974 win32
.Buffer
[win32
.Length
/ sizeof (WCHAR
)] = L
'\0';
4976 /* Set drive_length, used in path conversion, and error code, used in
4977 spawn_guts to decide whether a native Win32 app can be started or not. */
4989 PWCHAR ptr
= wcschr (win32
.Buffer
+ 2, L
'\\');
4991 ptr
= wcschr (ptr
+ 1, L
'\\');
4993 drive_length
= ptr
- win32
.Buffer
;
4995 drive_length
= win32
.Length
/ sizeof (WCHAR
);
4997 if (inaccessible_path
)
4999 else if (win32
.Length
> (MAX_PATH
- 2) * sizeof (WCHAR
))
5000 error
= ENAMETOOLONG
;
5004 /* Keep the Win32 CWD in sync. Don't check for error, other than for
5005 strace output. Try to keep overhead low. */
5006 override_win32_cwd (!nat_cwd
, old_dismount_count
);
5008 /* Eventually, create POSIX path if it's not set on entry. */
5012 posix_cwd
= (const char *) tp
.c_get ();
5013 mount_table
->conv_to_posix_path (win32
.Buffer
, (char *) posix_cwd
, 0);
5015 posix
= (char *) crealloc_abort (posix
, strlen (posix_cwd
) + 1);
5016 stpcpy (posix
, posix_cwd
);
5023 cwdstuff::get_error_desc () const
5025 switch (cygheap
->cwd
.get_error ())
5028 return "has restricted permissions which render it\n"
5029 "inaccessible as Win32 working directory";
5031 return "is a virtual Cygwin directory which does\n"
5032 "not exist for a native Windows application";
5034 return "has a path longer than allowed for a\n"
5035 "Win32 working directory";
5039 /* That shouldn't occur, unless we defined a new error code
5040 in cwdstuff::set. */
5041 return "is not accessible for some unknown reason";
5044 /* Store incoming wchar_t path as current posix cwd. This is called from
5045 setlocale so that the cwd is always stored in the right charset. */
5047 cwdstuff::reset_posix (wchar_t *w_cwd
)
5049 size_t len
= sys_wcstombs (NULL
, (size_t) -1, w_cwd
);
5050 posix
= (char *) crealloc_abort (posix
, len
+ 1);
5051 sys_wcstombs (posix
, len
+ 1, w_cwd
);
5055 cwdstuff::get (char *buf
, int need_posix
, int with_chroot
, unsigned ulen
)
5062 else if (buf
== NULL
)
5063 ulen
= (unsigned) -1;
5075 tocopy
= tp
.c_get ();
5076 sys_wcstombs (tocopy
, NT_MAX_PATH
, win32
.Buffer
,
5077 win32
.Length
/ sizeof (WCHAR
));
5082 debug_printf ("posix %s", posix
);
5083 if (strlen (tocopy
) >= ulen
)
5091 buf
= (char *) malloc (strlen (tocopy
) + 1);
5092 strcpy (buf
, tocopy
);
5093 if (!buf
[0]) /* Should only happen when chroot */
5100 syscall_printf ("(%s) = cwdstuff::get (%p, %u, %d, %d), errno %d",
5101 buf
, buf
, ulen
, need_posix
, with_chroot
, errno
);
5105 /* No need to be reentrant or thread-safe according to SUSv3.
5106 / and \\ are treated equally. Leading drive specifiers are
5107 kept intact as far as it makes sense. Everything else is
5108 POSIX compatible. */
5110 basename (char *path
)
5113 char *c
, *d
, *bs
= path
;
5115 if (!path
|| !*path
)
5116 return strcpy (buf
, ".");
5117 if (isalpha (path
[0]) && path
[1] == ':')
5119 else if (strspn (path
, "/\\") > 1)
5121 c
= strrchr (bs
, '/');
5122 if ((d
= strrchr (c
?: bs
, '\\')) > c
)
5126 /* Trailing (back)slashes are eliminated. */
5127 while (c
&& c
> bs
&& c
[1] == '\0')
5130 c
= strrchr (bs
, '/');
5131 if ((d
= strrchr (c
?: bs
, '\\')) > c
)
5134 if (c
&& (c
> bs
|| c
[1]))
5139 stpncpy (buf
, path
, bs
- path
);
5140 stpcpy (buf
+ (bs
- path
), ".");
5146 /* The differences with the POSIX version above:
5147 - declared in <string.h> (instead of <libgen.h>);
5148 - the argument is never modified, and therefore is marked const;
5149 - the empty string is returned if path is an empty string, "/", or ends
5150 with a trailing slash. */
5152 __gnu_basename (const char *path
)
5155 char *c
, *d
, *bs
= (char *)path
;
5157 if (!path
|| !*path
)
5158 return strcpy (buf
, "");
5159 if (isalpha (path
[0]) && path
[1] == ':')
5161 else if (strspn (path
, "/\\") > 1)
5163 c
= strrchr (bs
, '/');
5164 if ((d
= strrchr (c
?: bs
, '\\')) > c
)
5169 return strcpy (buf
, "");
5170 return (char *)path
;
5173 /* No need to be reentrant or thread-safe according to SUSv3.
5174 / and \\ are treated equally. Leading drive specifiers and
5175 leading double (back)slashes are kept intact as far as it
5176 makes sense. Everything else is POSIX compatible. */
5178 dirname (char *path
)
5181 char *c
, *d
, *bs
= path
;
5183 if (!path
|| !*path
)
5184 return strcpy (buf
, ".");
5185 if (isalpha (path
[0]) && path
[1] == ':')
5187 else if (strspn (path
, "/\\") == 2)
5189 c
= strrchr (bs
, '/');
5190 if ((d
= strrchr (c
?: bs
, '\\')) > c
)
5194 /* Trailing (back)slashes are eliminated. */
5195 while (c
&& c
> bs
&& c
[1] == '\0')
5198 c
= strrchr (bs
, '/');
5199 if ((d
= strrchr (c
?: bs
, '\\')) > c
)
5206 /* More trailing (back)slashes are eliminated. */
5207 while (c
> bs
&& (*c
== '/' || *c
== '\\'))
5215 stpncpy (buf
, path
, bs
- path
);
5216 stpcpy (buf
+ (bs
- path
), ".");