source3/smbd/filename.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    filename handling routines
   4    Copyright (C) Andrew Tridgell 1992-1998
   5    Copyright (C) Jeremy Allison 1999-2004
   6    Copyright (C) Ying Chen 2000
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 /*
  24  * New hash table stat cache code added by Ying Chen.
  25  */
  26
  27 #include "includes.h"
  28
  29 static BOOL scan_directory(const char *path, char *name,size_t maxlength,
  30                            connection_struct *conn,BOOL docache);
  31
  32 /****************************************************************************
  33  Check if two filenames are equal.
  34  This needs to be careful about whether we are case sensitive.
  35 ****************************************************************************/
  36
  37 static BOOL fname_equal(const char *name1, const char *name2, BOOL case_sensitive)
  38 {
  39         /* Normal filename handling */
  40         if (case_sensitive)
  41                 return(strcmp(name1,name2) == 0);
  42
  43         return(strequal(name1,name2));
  44 }
  45
  46 /****************************************************************************
  47  Mangle the 2nd name and check if it is then equal to the first name.
  48 ****************************************************************************/
  49
  50 static BOOL mangled_equal(const char *name1, const char *name2, int snum)
  51 {
  52         pstring tmpname;
  53
  54         pstrcpy(tmpname, name2);
  55         mangle_map(tmpname, True, False, snum);
  56         return strequal(name1, tmpname);
  57 }
  58
  59 /****************************************************************************
  60 This routine is called to convert names from the dos namespace to unix
  61 namespace. It needs to handle any case conversions, mangling, format
  62 changes etc.
  63
  64 We assume that we have already done a chdir() to the right "root" directory
  65 for this service.
  66
  67 The function will return False if some part of the name except for the last
  68 part cannot be resolved
  69
  70 If the saved_last_component != 0, then the unmodified last component
  71 of the pathname is returned there. This is used in an exceptional
  72 case in reply_mv (so far). If saved_last_component == 0 then nothing
  73 is returned there.
  74
  75 The bad_path arg is set to True if the filename walk failed. This is
  76 used to pick the correct error code to return between ENOENT and ENOTDIR
  77 as Windows applications depend on ERRbadpath being returned if a component
  78 of a pathname does not exist.
  79
  80 On exit from unix_convert, if *pst was not null, then the file stat
  81 struct will be returned if the file exists and was found, if not this
  82 stat struct will be filled with zeros (and this can be detected by checking
  83 for nlinks = 0, which can never be true for any file).
  84 ****************************************************************************/
  85
  86 BOOL unix_convert(pstring name,connection_struct *conn,char *saved_last_component,
  87                   BOOL *bad_path, SMB_STRUCT_STAT *pst)
  88 {
  89         SMB_STRUCT_STAT st;
  90         char *start, *end;
  91         pstring dirpath;
  92         pstring orig_path;
  93         BOOL component_was_mangled = False;
  94         BOOL name_has_wildcard = False;
  95
  96         ZERO_STRUCTP(pst);
  97
  98         *dirpath = 0;
  99         *bad_path = False;
 100         if(saved_last_component)
 101                 *saved_last_component = 0;
 102
 103         if (conn->printer) {
 104                 /* we don't ever use the filenames on a printer share as a
 105                         filename - so don't convert them */
 106                 return True;
 107         }
 108
 109         DEBUG(5, ("unix_convert called on file \"%s\"\n", name));
 110
 111         /*
 112          * Conversion to basic unix format is already done in check_path_syntax().
 113          */
 114
 115         /*
 116          * Names must be relative to the root of the service - any leading /.
 117          * and trailing /'s should have been trimmed by check_path_syntax().
 118          */
 119
 120 #ifdef DEVELOPER
 121         SMB_ASSERT(*name != '/');
 122 #endif
 123
 124         /*
 125          * If we trimmed down to a single '\0' character
 126          * then we should use the "." directory to avoid
 127          * searching the cache, but not if we are in a
 128          * printing share.
 129          * As we know this is valid we can return true here.
 130          */
 131
 132         if (!*name) {
 133                 name[0] = '.';
 134                 name[1] = '\0';
 135                 if (SMB_VFS_STAT(conn,name,&st) == 0) {
 136                         *pst = st;
 137                 }
 138                 DEBUG(5,("conversion finished \"\" -> %s\n",name));
 139                 return(True);
 140         }
 141
 142         /*
 143          * Ensure saved_last_component is valid even if file exists.
 144          */
 145
 146         if(saved_last_component) {
 147                 end = strrchr_m(name, '/');
 148                 if(end)
 149                         pstrcpy(saved_last_component, end + 1);
 150                 else
 151                         pstrcpy(saved_last_component, name);
 152         }
 153
 154 #if 1
 155         if (!conn->case_preserve || (mangle_is_8_3(name, False) && !conn->short_case_preserve))
 156 #else
 157         if (!conn->case_sensitive && (!conn->case_preserve || (mangle_is_8_3(name, False) && !conn->short_case_preserve)))
 158 #endif
 159                 strnorm(name, lp_defaultcase(SNUM(conn)));
 160
 161         start = name;
 162         pstrcpy(orig_path, name);
 163
 164         if(!conn->case_sensitive && stat_cache_lookup(conn, name, dirpath, &start, &st)) {
 165                 *pst = st;
 166                 return True;
 167         }
 168
 169         /*
 170          * stat the name - if it exists then we are all done!
 171          */
 172
 173         if (SMB_VFS_STAT(conn,name,&st) == 0) {
 174                 stat_cache_add(orig_path, name, conn->case_sensitive);
 175                 DEBUG(5,("conversion finished %s -> %s\n",orig_path, name));
 176                 *pst = st;
 177                 return(True);
 178         }
 179
 180         DEBUG(5,("unix_convert begin: name = %s, dirpath = %s, start = %s\n", name, dirpath, start));
 181
 182         /*
 183          * A special case - if we don't have any mangling chars and are case
 184          * sensitive then searching won't help.
 185          */
 186
 187         if (conn->case_sensitive && !mangle_is_mangled(name) && !*lp_mangled_map(SNUM(conn)))
 188                 return(False);
 189
 190         name_has_wildcard = ms_has_wild(start);
 191
 192         /*
 193          * is_mangled() was changed to look at an entire pathname, not
 194          * just a component. JRA.
 195          */
 196
 197         if (mangle_is_mangled(start))
 198                 component_was_mangled = True;
 199
 200         /*
 201          * Now we need to recursively match the name against the real
 202          * directory structure.
 203          */
 204
 205         /*
 206          * Match each part of the path name separately, trying the names
 207          * as is first, then trying to scan the directory for matching names.
 208          */
 209
 210         for (; start ; start = (end?end+1:(char *)NULL)) {
 211                 /*
 212                  * Pinpoint the end of this section of the filename.
 213                  */
 214                 end = strchr_m(start, '/');
 215
 216                 /*
 217                  * Chop the name at this point.
 218                  */
 219                 if (end)
 220                         *end = 0;
 221
 222                 if(saved_last_component != 0)
 223                         pstrcpy(saved_last_component, end ? end + 1 : start);
 224
 225                 /*
 226                  * Check if the name exists up to this point.
 227                  */
 228
 229                 if (SMB_VFS_STAT(conn,name, &st) == 0) {
 230                         /*
 231                          * It exists. it must either be a directory or this must be
 232                          * the last part of the path for it to be OK.
 233                          */
 234                         if (end && !(st.st_mode & S_IFDIR)) {
 235                                 /*
 236                                  * An intermediate part of the name isn't a directory.
 237                                  */
 238                                 DEBUG(5,("Not a dir %s\n",start));
 239                                 *end = '/';
 240                                 return(False);
 241                         }
 242
 243                         if (!end) {
 244                                 /*
 245                                  * We just scanned for, and found the end of the path.
 246                                  * We must return the valid stat struct.
 247                                  * JRA.
 248                                  */
 249
 250                                 *pst = st;
 251                         }
 252
 253                 } else {
 254                         pstring rest;
 255
 256                         /* Stat failed - ensure we don't use it. */
 257                         ZERO_STRUCT(st);
 258                         *rest = 0;
 259
 260                         /*
 261                          * Remember the rest of the pathname so it can be restored
 262                          * later.
 263                          */
 264
 265                         if (end)
 266                                 pstrcpy(rest,end+1);
 267
 268                         /*
 269                          * Try to find this part of the path in the directory.
 270                          */
 271
 272                         if (ms_has_wild(start) ||
 273                             !scan_directory(dirpath, start,
 274                                             sizeof(pstring) - 1 - (start - name),
 275                                             conn,
 276                                             end?True:False)) {
 277                                 if (end) {
 278                                         /*
 279                                          * An intermediate part of the name can't be found.
 280                                          */
 281                                         DEBUG(5,("Intermediate not found %s\n",start));
 282                                         *end = '/';
 283
 284                                         /*
 285                                          * We need to return the fact that the intermediate
 286                                          * name resolution failed. This is used to return an
 287                                          * error of ERRbadpath rather than ERRbadfile. Some
 288                                          * Windows applications depend on the difference between
 289                                          * these two errors.
 290                                          */
 291                                         *bad_path = True;
 292                                         return(False);
 293                                 }
 294
 295                                 /*
 296                                  * Just the last part of the name doesn't exist.
 297                                  * We may need to strupper() or strlower() it in case
 298                                  * this conversion is being used for file creation
 299                                  * purposes. If the filename is of mixed case then
 300                                  * don't normalise it.
 301                                  */
 302
 303                                 if (!conn->case_preserve && (!strhasupper(start) || !strhaslower(start)))
 304                                         strnorm(start, lp_defaultcase(SNUM(conn)));
 305
 306                                 /*
 307                                  * check on the mangled stack to see if we can recover the
 308                                  * base of the filename.
 309                                  */
 310
 311                                 if (mangle_is_mangled(start)) {
 312                                         mangle_check_cache( start );
 313                                 }
 314
 315                                 DEBUG(5,("New file %s\n",start));
 316                                 return(True);
 317                         }
 318
 319                         /*
 320                          * Restore the rest of the string. If the string was mangled the size
 321                          * may have changed.
 322                          */
 323                         if (end) {
 324                                 end = start + strlen(start);
 325                                 if (!safe_strcat(start, "/", sizeof(pstring) - 1 - (start - name)) ||
 326                                     !safe_strcat(start, rest, sizeof(pstring) - 1 - (start - name))) {
 327                                         return False;
 328                                 }
 329                                 *end = '\0';
 330                         } else {
 331                                 /*
 332                                  * We just scanned for, and found the end of the path.
 333                                  * We must return a valid stat struct if it exists.
 334                                  * JRA.
 335                                  */
 336
 337                                 if (SMB_VFS_STAT(conn,name, &st) == 0) {
 338                                         *pst = st;
 339                                 } else {
 340                                         ZERO_STRUCT(st);
 341                                 }
 342                         }
 343                 } /* end else */
 344
 345                 /*
 346                  * Add to the dirpath that we have resolved so far.
 347                  */
 348                 if (*dirpath)
 349                         pstrcat(dirpath,"/");
 350
 351                 pstrcat(dirpath,start);
 352
 353                 /*
 354                  * Don't cache a name with mangled or wildcard components
 355                  * as this can change the size.
 356                  */
 357
 358                 if(!component_was_mangled && !name_has_wildcard)
 359                         stat_cache_add(orig_path, dirpath, conn->case_sensitive);
 360
 361                 /*
 362                  * Restore the / that we wiped out earlier.
 363                  */
 364                 if (end)
 365                         *end = '/';
 366         }
 367
 368         /*
 369          * Don't cache a name with mangled or wildcard components
 370          * as this can change the size.
 371          */
 372
 373         if(!component_was_mangled && !name_has_wildcard)
 374                 stat_cache_add(orig_path, name, conn->case_sensitive);
 375
 376         /*
 377          * The name has been resolved.
 378          */
 379
 380         DEBUG(5,("conversion finished %s -> %s\n",orig_path, name));
 381         return(True);
 382 }
 383
 384 /****************************************************************************
 385  Check a filename - possibly caling reducename.
 386  This is called by every routine before it allows an operation on a filename.
 387  It does any final confirmation necessary to ensure that the filename is
 388  a valid one for the user to access.
 389 ****************************************************************************/
 390
 391 BOOL check_name(pstring name,connection_struct *conn)
 392 {
 393         BOOL ret = True;
 394
 395         errno = 0;
 396
 397         if (IS_VETO_PATH(conn, name))  {
 398                 /* Is it not dot or dot dot. */
 399                 if (!((name[0] == '.') && (!name[1] || (name[1] == '.' && !name[2])))) {
 400                         DEBUG(5,("file path name %s vetoed\n",name));
 401                         return False;
 402                 }
 403         }
 404
 405         if (!lp_widelinks(SNUM(conn))) {
 406                 ret = reduce_name(conn,name);
 407         }
 408
 409         /* Check if we are allowing users to follow symlinks */
 410         /* Patch from David Clerc <David.Clerc@cui.unige.ch>
 411                 University of Geneva */
 412
 413 #ifdef S_ISLNK
 414         if (!lp_symlinks(SNUM(conn))) {
 415                 SMB_STRUCT_STAT statbuf;
 416                 if ( (SMB_VFS_LSTAT(conn,name,&statbuf) != -1) &&
 417                                 (S_ISLNK(statbuf.st_mode)) ) {
 418                         DEBUG(3,("check_name: denied: file path name %s is a symlink\n",name));
 419                         ret = False;
 420                 }
 421         }
 422 #endif
 423
 424         if (!ret)
 425                 DEBUG(5,("check_name on %s failed\n",name));
 426
 427         return(ret);
 428 }
 429
 430 /****************************************************************************
 431  Scan a directory to find a filename, matching without case sensitivity.
 432  If the name looks like a mangled name then try via the mangling functions
 433 ****************************************************************************/
 434
 435 static BOOL scan_directory(const char *path, char *name, size_t maxlength,
 436                            connection_struct *conn,BOOL docache)
 437 {
 438         void *cur_dir;
 439         const char *dname;
 440         BOOL mangled;
 441
 442         mangled = mangle_is_mangled(name);
 443
 444         /* handle null paths */
 445         if (*path == 0)
 446                 path = ".";
 447
 448         if (docache && (dname = DirCacheCheck(path,name,SNUM(conn)))) {
 449                 safe_strcpy(name, dname, maxlength);
 450                 return(True);
 451         }
 452
 453         /*
 454          * The incoming name can be mangled, and if we de-mangle it
 455          * here it will not compare correctly against the filename (name2)
 456          * read from the directory and then mangled by the mangle_map()
 457          * call. We need to mangle both names or neither.
 458          * (JRA).
 459          */
 460         if (mangled)
 461                 mangled = !mangle_check_cache( name );
 462
 463         /* open the directory */
 464         if (!(cur_dir = OpenDir(conn, path, True))) {
 465                 DEBUG(3,("scan dir didn't open dir [%s]\n",path));
 466                 return(False);
 467         }
 468
 469         /* now scan for matching names */
 470         while ((dname = ReadDirName(cur_dir))) {
 471
 472                 /* Is it dot or dot dot. */
 473                 if ((dname[0] == '.') && (!dname[1] || (dname[1] == '.' && !dname[2]))) {
 474                         continue;
 475                 }
 476
 477                 /*
 478                  * At this point dname is the unmangled name.
 479                  * name is either mangled or not, depending on the state of the "mangled"
 480                  * variable. JRA.
 481                  */
 482
 483                 /*
 484                  * Check mangled name against mangled name, or unmangled name
 485                  * against unmangled name.
 486                  */
 487
 488                 if ((mangled && mangled_equal(name,dname,SNUM(conn))) || fname_equal(name, dname, conn->case_sensitive)) {
 489                         /* we've found the file, change it's name and return */
 490                         if (docache)
 491                                 DirCacheAdd(path,name,dname,SNUM(conn));
 492                         safe_strcpy(name, dname, maxlength);
 493                         CloseDir(cur_dir);
 494                         return(True);
 495                 }
 496         }
 497
 498         CloseDir(cur_dir);
 499         return(False);
 500 }