2 Unix SMB/CIFS implementation.
3 filename handling routines
4 Copyright (C) Andrew Tridgell 1992-1998
5 Copyright (C) Jeremy Allison 1999-2007
6 Copyright (C) Ying Chen 2000
7 Copyright (C) Volker Lendecke 2007
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * New hash table stat cache code added by Ying Chen.
28 #include "system/filesys.h"
29 #include "fake_file.h"
30 #include "smbd/smbd.h"
32 static NTSTATUS build_stream_path(TALLOC_CTX *mem_ctx,
33 connection_struct *conn,
34 const char *orig_path,
35 struct smb_filename *smb_fname);
37 /****************************************************************************
38 Mangle the 2nd name and check if it is then equal to the first name.
39 ****************************************************************************/
41 static bool mangled_equal(const char *name1,
43 const struct share_params *p)
47 if (!name_to_8_3(name2, mname, False, p)) {
50 return strequal(name1, mname);
53 /****************************************************************************
54 Cope with the differing wildcard and non-wildcard error cases.
55 ****************************************************************************/
57 static NTSTATUS determine_path_error(const char *name,
58 bool allow_wcard_last_component)
62 if (!allow_wcard_last_component) {
63 /* Error code within a pathname. */
64 return NT_STATUS_OBJECT_PATH_NOT_FOUND;
67 /* We're terminating here so we
68 * can be a little slower and get
69 * the error code right. Windows
70 * treats the last part of the pathname
71 * separately I think, so if the last
72 * component is a wildcard then we treat
73 * this ./ as "end of component" */
75 p = strchr(name, '/');
77 if (!p && (ms_has_wild(name) || ISDOT(name))) {
78 /* Error code at the end of a pathname. */
79 return NT_STATUS_OBJECT_NAME_INVALID;
81 /* Error code within a pathname. */
82 return NT_STATUS_OBJECT_PATH_NOT_FOUND;
86 static NTSTATUS check_for_dot_component(const struct smb_filename *smb_fname)
88 /* Ensure we catch all names with in "/."
89 this is disallowed under Windows and
90 in POSIX they've already been removed. */
91 const char *p = strstr(smb_fname->base_name, "/."); /*mb safe*/
94 /* Error code within a pathname. */
95 return NT_STATUS_OBJECT_PATH_NOT_FOUND;
96 } else if (p[2] == '\0') {
97 /* Error code at the end of a pathname. */
98 return NT_STATUS_OBJECT_NAME_INVALID;
104 /****************************************************************************
105 Optimization for common case where the missing part
106 is in the last component and the client already
107 sent the correct case.
108 Returns NT_STATUS_OK to mean continue the tree walk
109 (possibly with modified start pointer).
110 Any other NT_STATUS_XXX error means terminate the path
112 ****************************************************************************/
114 static NTSTATUS check_parent_exists(TALLOC_CTX *ctx,
115 connection_struct *conn,
116 bool posix_pathnames,
117 const struct smb_filename *smb_fname,
121 struct smb_filename parent_fname;
122 const char *last_component = NULL;
126 ZERO_STRUCT(parent_fname);
127 if (!parent_dirname(ctx, smb_fname->base_name,
128 &parent_fname.base_name,
130 return NT_STATUS_NO_MEMORY;
134 * If there was no parent component in
135 * smb_fname->base_name of the parent name
136 * contained a wildcard then don't do this
139 if ((smb_fname->base_name == last_component) ||
140 ms_has_wild(parent_fname.base_name)) {
144 if (posix_pathnames) {
145 ret = SMB_VFS_LSTAT(conn, &parent_fname);
147 ret = SMB_VFS_STAT(conn, &parent_fname);
150 /* If the parent stat failed, just continue
151 with the normal tree walk. */
157 status = check_for_dot_component(&parent_fname);
158 if (!NT_STATUS_IS_OK(status)) {
162 /* Parent exists - set "start" to be the
163 * last compnent to shorten the tree walk. */
166 * Safe to use CONST_DISCARD
167 * here as last_component points
168 * into our smb_fname->base_name.
170 *pp_start = CONST_DISCARD(char *,last_component);
172 /* Update dirpath. */
173 TALLOC_FREE(*pp_dirpath);
174 *pp_dirpath = talloc_strdup(ctx, parent_fname.base_name);
176 return NT_STATUS_NO_MEMORY;
179 DEBUG(5,("check_parent_exists: name "
180 "= %s, dirpath = %s, "
182 smb_fname->base_name,
189 /****************************************************************************
190 This routine is called to convert names from the dos namespace to unix
191 namespace. It needs to handle any case conversions, mangling, format changes,
194 We assume that we have already done a chdir() to the right "root" directory
197 The function will return an NTSTATUS error if some part of the name except for
198 the last part cannot be resolved, else NT_STATUS_OK.
200 Note NT_STATUS_OK doesn't mean the name exists or is valid, just that we
201 didn't get any fatal errors that should immediately terminate the calling SMB
202 processing whilst resolving.
204 If the UCF_SAVE_LCOMP flag is passed in, then the unmodified last component
205 of the pathname is set in smb_filename->original_lcomp.
207 If UCF_ALWAYS_ALLOW_WCARD_LCOMP is passed in, then a MS wildcard was detected
208 and should be allowed in the last component of the path only.
210 If the orig_path was a stream, smb_filename->base_name will point to the base
211 filename, and smb_filename->stream_name will point to the stream name. If
212 orig_path was not a stream, then smb_filename->stream_name will be NULL.
214 On exit from unix_convert, the smb_filename->st stat struct will be populated
215 if the file exists and was found, if not this stat struct will be filled with
216 zeros (and this can be detected by checking for nlinks = 0, which can never be
218 ****************************************************************************/
220 NTSTATUS unix_convert(TALLOC_CTX *ctx,
221 connection_struct *conn,
222 const char *orig_path,
223 struct smb_filename **smb_fname_out,
226 struct smb_filename *smb_fname = NULL;
228 char *dirpath = NULL;
230 bool component_was_mangled = False;
231 bool name_has_wildcard = False;
232 bool posix_pathnames = false;
233 bool allow_wcard_last_component =
234 (ucf_flags & UCF_ALWAYS_ALLOW_WCARD_LCOMP);
235 bool save_last_component = ucf_flags & UCF_SAVE_LCOMP;
239 *smb_fname_out = NULL;
241 smb_fname = talloc_zero(ctx, struct smb_filename);
242 if (smb_fname == NULL) {
243 return NT_STATUS_NO_MEMORY;
247 /* we don't ever use the filenames on a printer share as a
248 filename - so don't convert them */
249 if (!(smb_fname->base_name = talloc_strdup(smb_fname,
251 status = NT_STATUS_NO_MEMORY;
257 DEBUG(5, ("unix_convert called on file \"%s\"\n", orig_path));
260 * Conversion to basic unix format is already done in
261 * check_path_syntax().
265 * Names must be relative to the root of the service - any leading /.
266 * and trailing /'s should have been trimmed by check_path_syntax().
270 SMB_ASSERT(*orig_path != '/');
274 * If we trimmed down to a single '\0' character
275 * then we should use the "." directory to avoid
276 * searching the cache, but not if we are in a
278 * As we know this is valid we can return true here.
282 if (!(smb_fname->base_name = talloc_strdup(smb_fname, "."))) {
283 status = NT_STATUS_NO_MEMORY;
286 if (SMB_VFS_STAT(conn, smb_fname) != 0) {
287 status = map_nt_error_from_unix(errno);
290 DEBUG(5, ("conversion finished \"\" -> %s\n",
291 smb_fname->base_name));
295 if (orig_path[0] == '.' && (orig_path[1] == '/' ||
296 orig_path[1] == '\0')) {
297 /* Start of pathname can't be "." only. */
298 if (orig_path[1] == '\0' || orig_path[2] == '\0') {
299 status = NT_STATUS_OBJECT_NAME_INVALID;
301 status =determine_path_error(&orig_path[2],
302 allow_wcard_last_component);
307 /* Start with the full orig_path as given by the caller. */
308 if (!(smb_fname->base_name = talloc_strdup(smb_fname, orig_path))) {
309 DEBUG(0, ("talloc_strdup failed\n"));
310 status = NT_STATUS_NO_MEMORY;
315 * Large directory fix normalization. If we're case sensitive, and
316 * the case preserving parameters are set to "no", normalize the case of
317 * the incoming filename from the client WHETHER IT EXISTS OR NOT !
318 * This is in conflict with the current (3.0.20) man page, but is
319 * what people expect from the "large directory howto". I'll update
320 * the man page. Thanks to jht@samba.org for finding this. JRA.
323 if (conn->case_sensitive && !conn->case_preserve &&
324 !conn->short_case_preserve) {
325 strnorm(smb_fname->base_name, lp_defaultcase(SNUM(conn)));
329 * Ensure saved_last_component is valid even if file exists.
332 if(save_last_component) {
333 end = strrchr_m(smb_fname->base_name, '/');
335 smb_fname->original_lcomp = talloc_strdup(smb_fname,
338 smb_fname->original_lcomp =
339 talloc_strdup(smb_fname, smb_fname->base_name);
341 if (smb_fname->original_lcomp == NULL) {
342 status = NT_STATUS_NO_MEMORY;
347 posix_pathnames = (lp_posix_pathnames() ||
348 (ucf_flags & UCF_POSIX_PATHNAMES));
351 * Strip off the stream, and add it back when we're done with the
354 if (!posix_pathnames) {
355 stream = strchr_m(smb_fname->base_name, ':');
357 if (stream != NULL) {
358 char *tmp = talloc_strdup(smb_fname, stream);
360 status = NT_STATUS_NO_MEMORY;
364 * Since this is actually pointing into
365 * smb_fname->base_name this truncates base_name.
372 start = smb_fname->base_name;
375 * If we're providing case insensitive semantics or
376 * the underlying filesystem is case insensitive,
377 * then a case-normalized hit in the stat-cache is
378 * authoratitive. JRA.
380 * Note: We're only checking base_name. The stream_name will be
381 * added and verified in build_stream_path().
384 if((!conn->case_sensitive || !(conn->fs_capabilities &
385 FILE_CASE_SENSITIVE_SEARCH)) &&
386 stat_cache_lookup(conn, posix_pathnames, &smb_fname->base_name, &dirpath, &start,
392 * Make sure "dirpath" is an allocated string, we use this for
393 * building the directories with talloc_asprintf and free it.
396 if ((dirpath == NULL) && (!(dirpath = talloc_strdup(ctx,"")))) {
397 DEBUG(0, ("talloc_strdup failed\n"));
398 status = NT_STATUS_NO_MEMORY;
403 * If we have a wildcard we must walk the path to
404 * find where the error is, even if case sensitive
408 name_has_wildcard = ms_has_wild(smb_fname->base_name);
409 if (name_has_wildcard && !allow_wcard_last_component) {
410 /* Wildcard not valid anywhere. */
411 status = NT_STATUS_OBJECT_NAME_INVALID;
415 DEBUG(5,("unix_convert begin: name = %s, dirpath = %s, start = %s\n",
416 smb_fname->base_name, dirpath, start));
418 if (!name_has_wildcard) {
420 * stat the name - if it exists then we can add the stream back (if
421 * there was one) and be done!
424 if (posix_pathnames) {
425 ret = SMB_VFS_LSTAT(conn, smb_fname);
427 ret = SMB_VFS_STAT(conn, smb_fname);
431 status = check_for_dot_component(smb_fname);
432 if (!NT_STATUS_IS_OK(status)) {
435 /* Add the path (not including the stream) to the cache. */
436 stat_cache_add(orig_path, smb_fname->base_name,
437 conn->case_sensitive);
438 DEBUG(5,("conversion of base_name finished %s -> %s\n",
439 orig_path, smb_fname->base_name));
443 /* Stat failed - ensure we don't use it. */
444 SET_STAT_INVALID(smb_fname->st);
446 if (errno == ENOENT) {
447 /* Optimization when creating a new file - only
448 the last component doesn't exist.
449 NOTE : check_parent_exists() doesn't preserve errno.
451 int saved_errno = errno;
452 status = check_parent_exists(ctx,
459 if (!NT_STATUS_IS_OK(status)) {
465 * A special case - if we don't have any wildcards or mangling chars and are case
466 * sensitive or the underlying filesystem is case insensitive then searching
470 if ((conn->case_sensitive || !(conn->fs_capabilities &
471 FILE_CASE_SENSITIVE_SEARCH)) &&
472 !mangle_is_mangled(smb_fname->base_name, conn->params)) {
474 status = check_for_dot_component(smb_fname);
475 if (!NT_STATUS_IS_OK(status)) {
480 * The stat failed. Could be ok as it could be
484 if (errno == ENOTDIR || errno == ELOOP) {
485 status = NT_STATUS_OBJECT_PATH_NOT_FOUND;
487 } else if (errno == ENOENT) {
489 * Was it a missing last component ?
490 * or a missing intermediate component ?
492 struct smb_filename parent_fname;
493 const char *last_component = NULL;
495 ZERO_STRUCT(parent_fname);
496 if (!parent_dirname(ctx, smb_fname->base_name,
497 &parent_fname.base_name,
499 status = NT_STATUS_NO_MEMORY;
502 if (posix_pathnames) {
503 ret = SMB_VFS_LSTAT(conn, &parent_fname);
505 ret = SMB_VFS_STAT(conn, &parent_fname);
508 if (errno == ENOTDIR ||
511 status = NT_STATUS_OBJECT_PATH_NOT_FOUND;
517 * Missing last component is ok - new file.
518 * Also deal with permission denied elsewhere.
519 * Just drop out to done.
526 * We have a wildcard in the pathname.
528 * Optimization for common case where the wildcard
529 * is in the last component and the client already
530 * sent the correct case.
531 * NOTE : check_parent_exists() doesn't preserve errno.
533 int saved_errno = errno;
534 status = check_parent_exists(ctx,
541 if (!NT_STATUS_IS_OK(status)) {
547 * is_mangled() was changed to look at an entire pathname, not
548 * just a component. JRA.
551 if (mangle_is_mangled(start, conn->params)) {
552 component_was_mangled = True;
556 * Now we need to recursively match the name against the real
557 * directory structure.
561 * Match each part of the path name separately, trying the names
562 * as is first, then trying to scan the directory for matching names.
565 for (; start ; start = (end?end+1:(char *)NULL)) {
567 * Pinpoint the end of this section of the filename.
569 /* mb safe. '/' can't be in any encoded char. */
570 end = strchr(start, '/');
573 * Chop the name at this point.
579 if (save_last_component) {
580 TALLOC_FREE(smb_fname->original_lcomp);
581 smb_fname->original_lcomp = talloc_strdup(smb_fname,
582 end ? end + 1 : start);
583 if (!smb_fname->original_lcomp) {
584 DEBUG(0, ("talloc failed\n"));
585 status = NT_STATUS_NO_MEMORY;
590 /* The name cannot have a component of "." */
594 /* Error code at the end of a pathname. */
595 status = NT_STATUS_OBJECT_NAME_INVALID;
597 status = determine_path_error(end+1,
598 allow_wcard_last_component);
603 /* The name cannot have a wildcard if it's not
604 the last component. */
606 name_has_wildcard = ms_has_wild(start);
608 /* Wildcards never valid within a pathname. */
609 if (name_has_wildcard && end) {
610 status = NT_STATUS_OBJECT_NAME_INVALID;
614 /* Skip the stat call if it's a wildcard end. */
615 if (name_has_wildcard) {
616 DEBUG(5,("Wildcard %s\n",start));
621 * Check if the name exists up to this point.
624 if (posix_pathnames) {
625 ret = SMB_VFS_LSTAT(conn, smb_fname);
627 ret = SMB_VFS_STAT(conn, smb_fname);
632 * It exists. it must either be a directory or this must
633 * be the last part of the path for it to be OK.
635 if (end && !S_ISDIR(smb_fname->st.st_ex_mode)) {
637 * An intermediate part of the name isn't
640 DEBUG(5,("Not a dir %s\n",start));
643 * We need to return the fact that the
644 * intermediate name resolution failed. This
645 * is used to return an error of ERRbadpath
646 * rather than ERRbadfile. Some Windows
647 * applications depend on the difference between
650 status = NT_STATUS_OBJECT_PATH_NOT_FOUND;
655 char *found_name = NULL;
657 /* Stat failed - ensure we don't use it. */
658 SET_STAT_INVALID(smb_fname->st);
661 * Reset errno so we can detect
662 * directory open errors.
667 * Try to find this part of the path in the directory.
670 if (name_has_wildcard ||
671 (get_real_filename(conn, dirpath, start,
673 &found_name) == -1)) {
678 * An intermediate part of the name
681 DEBUG(5,("Intermediate not found %s\n",
686 * We need to return the fact that the
687 * intermediate name resolution failed.
688 * This is used to return an error of
689 * ERRbadpath rather than ERRbadfile.
690 * Some Windows applications depend on
691 * the difference between these two
696 * ENOENT, ENOTDIR and ELOOP all map
697 * to NT_STATUS_OBJECT_PATH_NOT_FOUND
698 * in the filename walk.
701 if (errno == ENOENT ||
705 NT_STATUS_OBJECT_PATH_NOT_FOUND;
709 map_nt_error_from_unix(errno);
715 * ENOENT/EACCESS are the only valid errors
716 * here. EACCESS needs handling here for
717 * "dropboxes", i.e. directories where users
718 * can only put stuff with permission -wx.
720 if ((errno != 0) && (errno != ENOENT)
721 && (errno != EACCES)) {
723 * ENOTDIR and ELOOP both map to
724 * NT_STATUS_OBJECT_PATH_NOT_FOUND
725 * in the filename walk.
727 if (errno == ENOTDIR ||
730 NT_STATUS_OBJECT_PATH_NOT_FOUND;
733 map_nt_error_from_unix(errno);
739 * Just the last part of the name doesn't exist.
740 * We need to strupper() or strlower() it as
741 * this conversion may be used for file creation
742 * purposes. Fix inspired by
743 * Thomas Neumann <t.neumann@iku-ag.de>.
745 if (!conn->case_preserve ||
746 (mangle_is_8_3(start, False,
748 !conn->short_case_preserve)) {
750 lp_defaultcase(SNUM(conn)));
754 * check on the mangled stack to see if we can
755 * recover the base of the filename.
758 if (mangle_is_mangled(start, conn->params)
759 && mangle_lookup_name_from_8_3(ctx,
765 start - smb_fname->base_name;
767 if (*dirpath != '\0') {
768 tmp = talloc_asprintf(
771 TALLOC_FREE(unmangled);
777 DEBUG(0, ("talloc failed\n"));
778 status = NT_STATUS_NO_MEMORY;
781 TALLOC_FREE(smb_fname->base_name);
782 smb_fname->base_name = tmp;
784 smb_fname->base_name + start_ofs;
785 end = start + strlen(start);
788 DEBUG(5,("New file %s\n",start));
794 * Restore the rest of the string. If the string was
795 * mangled the size may have changed.
800 start - smb_fname->base_name;
802 if (*dirpath != '\0') {
803 tmp = talloc_asprintf(smb_fname,
808 tmp = talloc_asprintf(smb_fname,
813 DEBUG(0, ("talloc_asprintf failed\n"));
814 status = NT_STATUS_NO_MEMORY;
817 TALLOC_FREE(smb_fname->base_name);
818 smb_fname->base_name = tmp;
819 start = smb_fname->base_name + start_ofs;
820 end = start + strlen(found_name);
825 start - smb_fname->base_name;
827 if (*dirpath != '\0') {
828 tmp = talloc_asprintf(smb_fname,
832 tmp = talloc_strdup(smb_fname,
836 DEBUG(0, ("talloc failed\n"));
837 status = NT_STATUS_NO_MEMORY;
840 TALLOC_FREE(smb_fname->base_name);
841 smb_fname->base_name = tmp;
842 start = smb_fname->base_name + start_ofs;
845 * We just scanned for, and found the end of
846 * the path. We must return a valid stat struct
850 if (posix_pathnames) {
851 ret = SMB_VFS_LSTAT(conn, smb_fname);
853 ret = SMB_VFS_STAT(conn, smb_fname);
857 SET_STAT_INVALID(smb_fname->st);
861 TALLOC_FREE(found_name);
867 * We should never provide different behaviors
868 * depending on DEVELOPER!!!
870 if (VALID_STAT(smb_fname->st)) {
874 status = file_name_hash(conn,
875 smb_fname_str_dbg(smb_fname),
877 if (!NT_STATUS_IS_OK(status)) {
881 get_file_infos(vfs_file_id_from_sbuf(conn,
884 &delete_pending, NULL);
885 if (delete_pending) {
886 status = NT_STATUS_DELETE_PENDING;
893 * Add to the dirpath that we have resolved so far.
896 if (*dirpath != '\0') {
897 char *tmp = talloc_asprintf(ctx,
898 "%s/%s", dirpath, start);
900 DEBUG(0, ("talloc_asprintf failed\n"));
901 status = NT_STATUS_NO_MEMORY;
904 TALLOC_FREE(dirpath);
908 TALLOC_FREE(dirpath);
909 if (!(dirpath = talloc_strdup(ctx,start))) {
910 DEBUG(0, ("talloc_strdup failed\n"));
911 status = NT_STATUS_NO_MEMORY;
917 * Cache the dirpath thus far. Don't cache a name with mangled
918 * or wildcard components as this can change the size.
920 if(!component_was_mangled && !name_has_wildcard) {
921 stat_cache_add(orig_path, dirpath,
922 conn->case_sensitive);
926 * Restore the / that we wiped out earlier.
934 * Cache the full path. Don't cache a name with mangled or wildcard
935 * components as this can change the size.
938 if(!component_was_mangled && !name_has_wildcard) {
939 stat_cache_add(orig_path, smb_fname->base_name,
940 conn->case_sensitive);
944 * The name has been resolved.
947 DEBUG(5,("conversion finished %s -> %s\n", orig_path,
948 smb_fname->base_name));
951 /* Add back the stream if one was stripped off originally. */
952 if (stream != NULL) {
953 smb_fname->stream_name = stream;
955 /* Check path now that the base_name has been converted. */
956 status = build_stream_path(ctx, conn, orig_path, smb_fname);
957 if (!NT_STATUS_IS_OK(status)) {
961 TALLOC_FREE(dirpath);
962 *smb_fname_out = smb_fname;
965 DEBUG(10, ("dirpath = [%s] start = [%s]\n", dirpath, start));
966 if (*dirpath != '\0') {
967 smb_fname->base_name = talloc_asprintf(smb_fname, "%s/%s",
970 smb_fname->base_name = talloc_strdup(smb_fname, start);
972 if (!smb_fname->base_name) {
973 DEBUG(0, ("talloc_asprintf failed\n"));
974 status = NT_STATUS_NO_MEMORY;
978 *smb_fname_out = smb_fname;
979 TALLOC_FREE(dirpath);
982 TALLOC_FREE(smb_fname);
986 /****************************************************************************
987 Ensure a path is not vetod.
988 ****************************************************************************/
990 NTSTATUS check_veto_path(connection_struct *conn, const char *name)
992 if (IS_VETO_PATH(conn, name)) {
993 /* Is it not dot or dot dot. */
994 if (!(ISDOT(name) || ISDOTDOT(name))) {
995 DEBUG(5,("check_veto_path: file path name %s vetoed\n",
997 return map_nt_error_from_unix(ENOENT);
1000 return NT_STATUS_OK;
1003 /****************************************************************************
1004 Check a filename - possibly calling check_reduced_name.
1005 This is called by every routine before it allows an operation on a filename.
1006 It does any final confirmation necessary to ensure that the filename is
1007 a valid one for the user to access.
1008 ****************************************************************************/
1010 NTSTATUS check_name(connection_struct *conn, const char *name)
1012 NTSTATUS status = check_veto_path(conn, name);
1014 if (!NT_STATUS_IS_OK(status)) {
1018 if (!lp_widelinks(SNUM(conn)) || !lp_symlinks(SNUM(conn))) {
1019 status = check_reduced_name(conn,name);
1020 if (!NT_STATUS_IS_OK(status)) {
1021 DEBUG(5,("check_name: name %s failed with %s\n",name,
1022 nt_errstr(status)));
1027 return NT_STATUS_OK;
1030 /****************************************************************************
1031 Check if two filenames are equal.
1032 This needs to be careful about whether we are case sensitive.
1033 ****************************************************************************/
1035 static bool fname_equal(const char *name1, const char *name2,
1036 bool case_sensitive)
1038 /* Normal filename handling */
1039 if (case_sensitive) {
1040 return(strcmp(name1,name2) == 0);
1043 return(strequal(name1,name2));
1046 /****************************************************************************
1047 Scan a directory to find a filename, matching without case sensitivity.
1048 If the name looks like a mangled name then try via the mangling functions
1049 ****************************************************************************/
1051 static int get_real_filename_full_scan(connection_struct *conn,
1052 const char *path, const char *name,
1054 TALLOC_CTX *mem_ctx, char **found_name)
1056 struct smb_Dir *cur_dir;
1057 const char *dname = NULL;
1058 char *talloced = NULL;
1059 char *unmangled_name = NULL;
1062 /* handle null paths */
1063 if ((path == NULL) || (*path == 0)) {
1067 /* If we have a case-sensitive filesystem, it doesn't do us any
1068 * good to search for a name. If a case variation of the name was
1069 * there, then the original stat(2) would have found it.
1071 if (!mangled && !(conn->fs_capabilities & FILE_CASE_SENSITIVE_SEARCH)) {
1077 * The incoming name can be mangled, and if we de-mangle it
1078 * here it will not compare correctly against the filename (name2)
1079 * read from the directory and then mangled by the name_to_8_3()
1080 * call. We need to mangle both names or neither.
1083 * Fix for bug found by Dina Fine. If in case sensitive mode then
1084 * the mangle cache is no good (3 letter extension could be wrong
1085 * case - so don't demangle in this case - leave as mangled and
1086 * allow the mangling of the directory entry read (which is done
1087 * case insensitively) to match instead. This will lead to more
1088 * false positive matches but we fail completely without it. JRA.
1091 if (mangled && !conn->case_sensitive) {
1092 mangled = !mangle_lookup_name_from_8_3(talloc_tos(), name,
1096 /* Name is now unmangled. */
1097 name = unmangled_name;
1101 /* open the directory */
1102 if (!(cur_dir = OpenDir(talloc_tos(), conn, path, NULL, 0))) {
1103 DEBUG(3,("scan dir didn't open dir [%s]\n",path));
1104 TALLOC_FREE(unmangled_name);
1108 /* now scan for matching names */
1110 while ((dname = ReadDirName(cur_dir, &curpos, NULL, &talloced))) {
1112 /* Is it dot or dot dot. */
1113 if (ISDOT(dname) || ISDOTDOT(dname)) {
1114 TALLOC_FREE(talloced);
1119 * At this point dname is the unmangled name.
1120 * name is either mangled or not, depending on the state
1121 * of the "mangled" variable. JRA.
1125 * Check mangled name against mangled name, or unmangled name
1126 * against unmangled name.
1129 if ((mangled && mangled_equal(name,dname,conn->params)) ||
1130 fname_equal(name, dname, conn->case_sensitive)) {
1131 /* we've found the file, change it's name and return */
1132 *found_name = talloc_strdup(mem_ctx, dname);
1133 TALLOC_FREE(unmangled_name);
1134 TALLOC_FREE(cur_dir);
1137 TALLOC_FREE(talloced);
1140 TALLOC_FREE(talloced);
1143 TALLOC_FREE(talloced);
1146 TALLOC_FREE(unmangled_name);
1147 TALLOC_FREE(cur_dir);
1152 /****************************************************************************
1153 Wrapper around the vfs get_real_filename and the full directory scan
1155 ****************************************************************************/
1157 int get_real_filename(connection_struct *conn, const char *path,
1158 const char *name, TALLOC_CTX *mem_ctx,
1164 mangled = mangle_is_mangled(name, conn->params);
1167 return get_real_filename_full_scan(conn, path, name, mangled,
1168 mem_ctx, found_name);
1171 /* Try the vfs first to take advantage of case-insensitive stat. */
1172 ret = SMB_VFS_GET_REAL_FILENAME(conn, path, name, mem_ctx, found_name);
1175 * If the case-insensitive stat was successful, or returned an error
1176 * other than EOPNOTSUPP then there is no need to fall back on the
1177 * full directory scan.
1179 if (ret == 0 || (ret == -1 && errno != EOPNOTSUPP)) {
1183 return get_real_filename_full_scan(conn, path, name, mangled, mem_ctx,
1187 static NTSTATUS build_stream_path(TALLOC_CTX *mem_ctx,
1188 connection_struct *conn,
1189 const char *orig_path,
1190 struct smb_filename *smb_fname)
1193 unsigned int i, num_streams = 0;
1194 struct stream_struct *streams = NULL;
1196 if (SMB_VFS_STAT(conn, smb_fname) == 0) {
1197 DEBUG(10, ("'%s' exists\n", smb_fname_str_dbg(smb_fname)));
1198 return NT_STATUS_OK;
1201 if (errno != ENOENT) {
1202 DEBUG(10, ("vfs_stat failed: %s\n", strerror(errno)));
1203 status = map_nt_error_from_unix(errno);
1207 /* Fall back to a case-insensitive scan of all streams on the file. */
1208 status = vfs_streaminfo(conn, NULL, smb_fname->base_name, mem_ctx,
1209 &num_streams, &streams);
1211 if (NT_STATUS_EQUAL(status, NT_STATUS_OBJECT_NAME_NOT_FOUND)) {
1212 SET_STAT_INVALID(smb_fname->st);
1213 return NT_STATUS_OK;
1216 if (!NT_STATUS_IS_OK(status)) {
1217 DEBUG(10, ("vfs_streaminfo failed: %s\n", nt_errstr(status)));
1221 for (i=0; i<num_streams; i++) {
1222 DEBUG(10, ("comparing [%s] and [%s]: ",
1223 smb_fname->stream_name, streams[i].name));
1224 if (fname_equal(smb_fname->stream_name, streams[i].name,
1225 conn->case_sensitive)) {
1226 DEBUGADD(10, ("equal\n"));
1229 DEBUGADD(10, ("not equal\n"));
1232 /* Couldn't find the stream. */
1233 if (i == num_streams) {
1234 SET_STAT_INVALID(smb_fname->st);
1235 TALLOC_FREE(streams);
1236 return NT_STATUS_OK;
1239 DEBUG(10, ("case insensitive stream. requested: %s, actual: %s\n",
1240 smb_fname->stream_name, streams[i].name));
1243 TALLOC_FREE(smb_fname->stream_name);
1244 smb_fname->stream_name = talloc_strdup(smb_fname, streams[i].name);
1245 if (smb_fname->stream_name == NULL) {
1246 status = NT_STATUS_NO_MEMORY;
1250 SET_STAT_INVALID(smb_fname->st);
1252 if (SMB_VFS_STAT(conn, smb_fname) == 0) {
1253 DEBUG(10, ("'%s' exists\n", smb_fname_str_dbg(smb_fname)));
1255 status = NT_STATUS_OK;
1257 TALLOC_FREE(streams);
1262 * Go through all the steps to validate a filename.
1264 * @param ctx talloc_ctx to allocate memory with.
1265 * @param conn connection struct for vfs calls.
1266 * @param dfs_path Whether this path requires dfs resolution.
1267 * @param name_in The unconverted name.
1268 * @param ucf_flags flags to pass through to unix_convert().
1269 * UCF_ALWAYS_ALLOW_WCARD_LCOMP will be OR'd in if
1270 * p_cont_wcard != NULL and is true and
1271 * UCF_COND_ALLOW_WCARD_LCOMP.
1272 * @param p_cont_wcard If not NULL, will be set to true if the dfs path
1273 * resolution detects a wildcard.
1274 * @param pp_smb_fname The final converted name will be allocated if the
1275 * return is NT_STATUS_OK.
1277 * @return NT_STATUS_OK if all operations completed succesfully, appropriate
1280 NTSTATUS filename_convert(TALLOC_CTX *ctx,
1281 connection_struct *conn,
1283 const char *name_in,
1285 bool *ppath_contains_wcard,
1286 struct smb_filename **pp_smb_fname)
1289 bool allow_wcards = (ucf_flags & (UCF_COND_ALLOW_WCARD_LCOMP|UCF_ALWAYS_ALLOW_WCARD_LCOMP));
1292 *pp_smb_fname = NULL;
1294 status = resolve_dfspath_wcard(ctx, conn,
1299 ppath_contains_wcard);
1300 if (!NT_STATUS_IS_OK(status)) {
1301 DEBUG(10,("filename_convert: resolve_dfspath failed "
1302 "for name %s with %s\n",
1304 nt_errstr(status) ));
1308 if (is_fake_file_path(name_in)) {
1312 status = create_synthetic_smb_fname_split(ctx,
1320 * If the caller conditionally allows wildcard lookups, only add the
1321 * always allow if the path actually does contain a wildcard.
1323 if (ucf_flags & UCF_COND_ALLOW_WCARD_LCOMP &&
1324 ppath_contains_wcard != NULL && *ppath_contains_wcard) {
1325 ucf_flags |= UCF_ALWAYS_ALLOW_WCARD_LCOMP;
1328 status = unix_convert(ctx, conn, fname, pp_smb_fname, ucf_flags);
1329 if (!NT_STATUS_IS_OK(status)) {
1330 DEBUG(10,("filename_convert: unix_convert failed "
1331 "for name %s with %s\n",
1333 nt_errstr(status) ));
1337 if ((ucf_flags & UCF_UNIX_NAME_LOOKUP) &&
1338 VALID_STAT((*pp_smb_fname)->st) &&
1339 S_ISLNK((*pp_smb_fname)->st.st_ex_mode)) {
1340 return check_veto_path(conn, (*pp_smb_fname)->base_name);
1343 status = check_name(conn, (*pp_smb_fname)->base_name);
1344 if (!NT_STATUS_IS_OK(status)) {
1345 DEBUG(3,("filename_convert: check_name failed "
1346 "for name %s with %s\n",
1347 smb_fname_str_dbg(*pp_smb_fname),
1348 nt_errstr(status) ));
1349 TALLOC_FREE(*pp_smb_fname);