source3/smbd/vfs.c

   1 /*
   2    Unix SMB/Netbios implementation.
   3    Version 1.9.
   4    VFS initialisation and support functions
   5    Copyright (C) Tim Potter 1999
   6    Copyright (C) Alexander Bokovoy 2002
   7    Copyright (C) James Peach 2006
   8    Copyright (C) Volker Lendecke 2009
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22
  23    This work was sponsored by Optifacio Software Services, Inc.
  24 */
  25
  26 #include "includes.h"
  27 #include "smbd/globals.h"
  28
  29 #undef DBGC_CLASS
  30 #define DBGC_CLASS DBGC_VFS
  31
  32 static_decl_vfs;
  33
  34 struct vfs_init_function_entry {
  35         char *name;
  36         struct vfs_init_function_entry *prev, *next;
  37         const struct vfs_fn_pointers *fns;
  38 };
  39
  40 /****************************************************************************
  41     maintain the list of available backends
  42 ****************************************************************************/
  43
  44 static struct vfs_init_function_entry *vfs_find_backend_entry(const char *name)
  45 {
  46         struct vfs_init_function_entry *entry = backends;
  47
  48         DEBUG(10, ("vfs_find_backend_entry called for %s\n", name));
  49
  50         while(entry) {
  51                 if (strcmp(entry->name, name)==0) return entry;
  52                 entry = entry->next;
  53         }
  54
  55         return NULL;
  56 }
  57
  58 NTSTATUS smb_register_vfs(int version, const char *name,
  59                           const struct vfs_fn_pointers *fns)
  60 {
  61         struct vfs_init_function_entry *entry = backends;
  62
  63         if ((version != SMB_VFS_INTERFACE_VERSION)) {
  64                 DEBUG(0, ("Failed to register vfs module.\n"
  65                           "The module was compiled against SMB_VFS_INTERFACE_VERSION %d,\n"
  66                           "current SMB_VFS_INTERFACE_VERSION is %d.\n"
  67                           "Please recompile against the current Samba Version!\n",
  68                           version, SMB_VFS_INTERFACE_VERSION));
  69                 return NT_STATUS_OBJECT_TYPE_MISMATCH;
  70         }
  71
  72         if (!name || !name[0]) {
  73                 DEBUG(0,("smb_register_vfs() called with NULL pointer or empty name!\n"));
  74                 return NT_STATUS_INVALID_PARAMETER;
  75         }
  76
  77         if (vfs_find_backend_entry(name)) {
  78                 DEBUG(0,("VFS module %s already loaded!\n", name));
  79                 return NT_STATUS_OBJECT_NAME_COLLISION;
  80         }
  81
  82         entry = SMB_XMALLOC_P(struct vfs_init_function_entry);
  83         entry->name = smb_xstrdup(name);
  84         entry->fns = fns;
  85
  86         DLIST_ADD(backends, entry);
  87         DEBUG(5, ("Successfully added vfs backend '%s'\n", name));
  88         return NT_STATUS_OK;
  89 }
  90
  91 /****************************************************************************
  92   initialise default vfs hooks
  93 ****************************************************************************/
  94
  95 static void vfs_init_default(connection_struct *conn)
  96 {
  97         DEBUG(3, ("Initialising default vfs hooks\n"));
  98         vfs_init_custom(conn, DEFAULT_VFS_MODULE_NAME);
  99 }
 100
 101 /****************************************************************************
 102   initialise custom vfs hooks
 103  ****************************************************************************/
 104
 105 bool vfs_init_custom(connection_struct *conn, const char *vfs_object)
 106 {
 107         char *module_path = NULL;
 108         char *module_name = NULL;
 109         char *module_param = NULL, *p;
 110         vfs_handle_struct *handle;
 111         const struct vfs_init_function_entry *entry;
 112
 113         if (!conn||!vfs_object||!vfs_object[0]) {
 114                 DEBUG(0,("vfs_init_custon() called with NULL pointer or emtpy vfs_object!\n"));
 115                 return False;
 116         }
 117
 118         if(!backends) {
 119                 static_init_vfs;
 120         }
 121
 122         DEBUG(3, ("Initialising custom vfs hooks from [%s]\n", vfs_object));
 123
 124         module_path = smb_xstrdup(vfs_object);
 125
 126         p = strchr_m(module_path, ':');
 127
 128         if (p) {
 129                 *p = 0;
 130                 module_param = p+1;
 131                 trim_char(module_param, ' ', ' ');
 132         }
 133
 134         trim_char(module_path, ' ', ' ');
 135
 136         module_name = smb_xstrdup(module_path);
 137
 138         if ((module_name[0] == '/') &&
 139             (strcmp(module_path, DEFAULT_VFS_MODULE_NAME) != 0)) {
 140
 141                 /*
 142                  * Extract the module name from the path. Just use the base
 143                  * name of the last path component.
 144                  */
 145
 146                 SAFE_FREE(module_name);
 147                 module_name = smb_xstrdup(strrchr_m(module_path, '/')+1);
 148
 149                 p = strchr_m(module_name, '.');
 150
 151                 if (p != NULL) {
 152                         *p = '\0';
 153                 }
 154         }
 155
 156         /* First, try to load the module with the new module system */
 157         entry = vfs_find_backend_entry(module_name);
 158         if (!entry) {
 159                 NTSTATUS status;
 160
 161                 DEBUG(5, ("vfs module [%s] not loaded - trying to load...\n",
 162                           vfs_object));
 163
 164                 status = smb_probe_module("vfs", module_path);
 165                 if (!NT_STATUS_IS_OK(status)) {
 166                         DEBUG(0, ("error probing vfs module '%s': %s\n",
 167                                   module_path, nt_errstr(status)));
 168                         goto fail;
 169                 }
 170
 171                 entry = vfs_find_backend_entry(module_name);
 172                 if (!entry) {
 173                         DEBUG(0,("Can't find a vfs module [%s]\n",vfs_object));
 174                         goto fail;
 175                 }
 176         }
 177
 178         DEBUGADD(5,("Successfully loaded vfs module [%s] with the new modules system\n", vfs_object));
 179
 180         handle = TALLOC_ZERO_P(conn, vfs_handle_struct);
 181         if (!handle) {
 182                 DEBUG(0,("TALLOC_ZERO() failed!\n"));
 183                 goto fail;
 184         }
 185         handle->conn = conn;
 186         handle->fns = entry->fns;
 187         if (module_param) {
 188                 handle->param = talloc_strdup(conn, module_param);
 189         }
 190         DLIST_ADD(conn->vfs_handles, handle);
 191
 192         SAFE_FREE(module_path);
 193         SAFE_FREE(module_name);
 194         return True;
 195
 196  fail:
 197         SAFE_FREE(module_path);
 198         SAFE_FREE(module_name);
 199         return False;
 200 }
 201
 202 /*****************************************************************
 203  Allow VFS modules to extend files_struct with VFS-specific state.
 204  This will be ok for small numbers of extensions, but might need to
 205  be refactored if it becomes more widely used.
 206 ******************************************************************/
 207
 208 #define EXT_DATA_AREA(e) ((uint8 *)(e) + sizeof(struct vfs_fsp_data))
 209
 210 void *vfs_add_fsp_extension_notype(vfs_handle_struct *handle,
 211                                    files_struct *fsp, size_t ext_size,
 212                                    void (*destroy_fn)(void *p_data))
 213 {
 214         struct vfs_fsp_data *ext;
 215         void * ext_data;
 216
 217         /* Prevent VFS modules adding multiple extensions. */
 218         if ((ext_data = vfs_fetch_fsp_extension(handle, fsp))) {
 219                 return ext_data;
 220         }
 221
 222         ext = (struct vfs_fsp_data *)TALLOC_ZERO(
 223                 handle->conn, sizeof(struct vfs_fsp_data) + ext_size);
 224         if (ext == NULL) {
 225                 return NULL;
 226         }
 227
 228         ext->owner = handle;
 229         ext->next = fsp->vfs_extension;
 230         ext->destroy = destroy_fn;
 231         fsp->vfs_extension = ext;
 232         return EXT_DATA_AREA(ext);
 233 }
 234
 235 void vfs_remove_fsp_extension(vfs_handle_struct *handle, files_struct *fsp)
 236 {
 237         struct vfs_fsp_data *curr;
 238         struct vfs_fsp_data *prev;
 239
 240         for (curr = fsp->vfs_extension, prev = NULL;
 241              curr;
 242              prev = curr, curr = curr->next) {
 243                 if (curr->owner == handle) {
 244                     if (prev) {
 245                             prev->next = curr->next;
 246                     } else {
 247                             fsp->vfs_extension = curr->next;
 248                     }
 249                     if (curr->destroy) {
 250                             curr->destroy(EXT_DATA_AREA(curr));
 251                     }
 252                     TALLOC_FREE(curr);
 253                     return;
 254                 }
 255         }
 256 }
 257
 258 void *vfs_memctx_fsp_extension(vfs_handle_struct *handle, files_struct *fsp)
 259 {
 260         struct vfs_fsp_data *head;
 261
 262         for (head = fsp->vfs_extension; head; head = head->next) {
 263                 if (head->owner == handle) {
 264                         return head;
 265                 }
 266         }
 267
 268         return NULL;
 269 }
 270
 271 void *vfs_fetch_fsp_extension(vfs_handle_struct *handle, files_struct *fsp)
 272 {
 273         struct vfs_fsp_data *head;
 274
 275         head = (struct vfs_fsp_data *)vfs_memctx_fsp_extension(handle, fsp);
 276         if (head != NULL) {
 277                 return EXT_DATA_AREA(head);
 278         }
 279
 280         return NULL;
 281 }
 282
 283 #undef EXT_DATA_AREA
 284
 285 /*****************************************************************
 286  Generic VFS init.
 287 ******************************************************************/
 288
 289 bool smbd_vfs_init(connection_struct *conn)
 290 {
 291         const char **vfs_objects;
 292         unsigned int i = 0;
 293         int j = 0;
 294
 295         /* Normal share - initialise with disk access functions */
 296         vfs_init_default(conn);
 297         vfs_objects = lp_vfs_objects(SNUM(conn));
 298
 299         /* Override VFS functions if 'vfs object' was not specified*/
 300         if (!vfs_objects || !vfs_objects[0])
 301                 return True;
 302
 303         for (i=0; vfs_objects[i] ;) {
 304                 i++;
 305         }
 306
 307         for (j=i-1; j >= 0; j--) {
 308                 if (!vfs_init_custom(conn, vfs_objects[j])) {
 309                         DEBUG(0, ("smbd_vfs_init: vfs_init_custom failed for %s\n", vfs_objects[j]));
 310                         return False;
 311                 }
 312         }
 313         return True;
 314 }
 315
 316 /*******************************************************************
 317  Check if a file exists in the vfs.
 318 ********************************************************************/
 319
 320 NTSTATUS vfs_file_exist(connection_struct *conn, struct smb_filename *smb_fname)
 321 {
 322         /* Only return OK if stat was successful and S_ISREG */
 323         if ((SMB_VFS_STAT(conn, smb_fname) != -1) &&
 324             S_ISREG(smb_fname->st.st_ex_mode)) {
 325                 return NT_STATUS_OK;
 326         }
 327
 328         return NT_STATUS_OBJECT_NAME_NOT_FOUND;
 329 }
 330
 331 /****************************************************************************
 332  Read data from fsp on the vfs. (note: EINTR re-read differs from vfs_write_data)
 333 ****************************************************************************/
 334
 335 ssize_t vfs_read_data(files_struct *fsp, char *buf, size_t byte_count)
 336 {
 337         size_t total=0;
 338
 339         while (total < byte_count)
 340         {
 341                 ssize_t ret = SMB_VFS_READ(fsp, buf + total,
 342                                            byte_count - total);
 343
 344                 if (ret == 0) return total;
 345                 if (ret == -1) {
 346                         if (errno == EINTR)
 347                                 continue;
 348                         else
 349                                 return -1;
 350                 }
 351                 total += ret;
 352         }
 353         return (ssize_t)total;
 354 }
 355
 356 ssize_t vfs_pread_data(files_struct *fsp, char *buf,
 357                 size_t byte_count, SMB_OFF_T offset)
 358 {
 359         size_t total=0;
 360
 361         while (total < byte_count)
 362         {
 363                 ssize_t ret = SMB_VFS_PREAD(fsp, buf + total,
 364                                         byte_count - total, offset + total);
 365
 366                 if (ret == 0) return total;
 367                 if (ret == -1) {
 368                         if (errno == EINTR)
 369                                 continue;
 370                         else
 371                                 return -1;
 372                 }
 373                 total += ret;
 374         }
 375         return (ssize_t)total;
 376 }
 377
 378 /****************************************************************************
 379  Write data to a fd on the vfs.
 380 ****************************************************************************/
 381
 382 ssize_t vfs_write_data(struct smb_request *req,
 383                         files_struct *fsp,
 384                         const char *buffer,
 385                         size_t N)
 386 {
 387         size_t total=0;
 388         ssize_t ret;
 389
 390         if (req && req->unread_bytes) {
 391                 SMB_ASSERT(req->unread_bytes == N);
 392                 /* VFS_RECVFILE must drain the socket
 393                  * before returning. */
 394                 req->unread_bytes = 0;
 395                 return SMB_VFS_RECVFILE(smbd_server_fd(),
 396                                         fsp,
 397                                         (SMB_OFF_T)-1,
 398                                         N);
 399         }
 400
 401         while (total < N) {
 402                 ret = SMB_VFS_WRITE(fsp, buffer + total, N - total);
 403
 404                 if (ret == -1)
 405                         return -1;
 406                 if (ret == 0)
 407                         return total;
 408
 409                 total += ret;
 410         }
 411         return (ssize_t)total;
 412 }
 413
 414 ssize_t vfs_pwrite_data(struct smb_request *req,
 415                         files_struct *fsp,
 416                         const char *buffer,
 417                         size_t N,
 418                         SMB_OFF_T offset)
 419 {
 420         size_t total=0;
 421         ssize_t ret;
 422
 423         if (req && req->unread_bytes) {
 424                 SMB_ASSERT(req->unread_bytes == N);
 425                 /* VFS_RECVFILE must drain the socket
 426                  * before returning. */
 427                 req->unread_bytes = 0;
 428                 return SMB_VFS_RECVFILE(smbd_server_fd(),
 429                                         fsp,
 430                                         offset,
 431                                         N);
 432         }
 433
 434         while (total < N) {
 435                 ret = SMB_VFS_PWRITE(fsp, buffer + total, N - total,
 436                                      offset + total);
 437
 438                 if (ret == -1)
 439                         return -1;
 440                 if (ret == 0)
 441                         return total;
 442
 443                 total += ret;
 444         }
 445         return (ssize_t)total;
 446 }
 447 /****************************************************************************
 448  An allocate file space call using the vfs interface.
 449  Allocates space for a file from a filedescriptor.
 450  Returns 0 on success, -1 on failure.
 451 ****************************************************************************/
 452
 453 int vfs_allocate_file_space(files_struct *fsp, uint64_t len)
 454 {
 455         int ret;
 456         SMB_STRUCT_STAT st;
 457         connection_struct *conn = fsp->conn;
 458         uint64_t space_avail;
 459         uint64_t bsize,dfree,dsize;
 460
 461         /*
 462          * Actually try and commit the space on disk....
 463          */
 464
 465         DEBUG(10,("vfs_allocate_file_space: file %s, len %.0f\n",
 466                   fsp_str_dbg(fsp), (double)len));
 467
 468         if (((SMB_OFF_T)len) < 0) {
 469                 DEBUG(0,("vfs_allocate_file_space: %s negative len "
 470                          "requested.\n", fsp_str_dbg(fsp)));
 471                 errno = EINVAL;
 472                 return -1;
 473         }
 474
 475         ret = SMB_VFS_FSTAT(fsp, &st);
 476         if (ret == -1)
 477                 return ret;
 478
 479         if (len == (uint64_t)st.st_ex_size)
 480                 return 0;
 481
 482         if (len < (uint64_t)st.st_ex_size) {
 483                 /* Shrink - use ftruncate. */
 484
 485                 DEBUG(10,("vfs_allocate_file_space: file %s, shrink. Current "
 486                           "size %.0f\n", fsp_str_dbg(fsp),
 487                           (double)st.st_ex_size));
 488
 489                 contend_level2_oplocks_begin(fsp, LEVEL2_CONTEND_ALLOC_SHRINK);
 490
 491                 flush_write_cache(fsp, SIZECHANGE_FLUSH);
 492                 if ((ret = SMB_VFS_FTRUNCATE(fsp, (SMB_OFF_T)len)) != -1) {
 493                         set_filelen_write_cache(fsp, len);
 494                 }
 495
 496                 contend_level2_oplocks_end(fsp, LEVEL2_CONTEND_ALLOC_SHRINK);
 497
 498                 return ret;
 499         }
 500
 501         /* Grow - we need to test if we have enough space. */
 502
 503         contend_level2_oplocks_begin(fsp, LEVEL2_CONTEND_ALLOC_GROW);
 504         contend_level2_oplocks_end(fsp, LEVEL2_CONTEND_ALLOC_GROW);
 505
 506         if (!lp_strict_allocate(SNUM(fsp->conn)))
 507                 return 0;
 508
 509         len -= st.st_ex_size;
 510         len /= 1024; /* Len is now number of 1k blocks needed. */
 511         space_avail = get_dfree_info(conn, fsp->fsp_name->base_name, false,
 512                                      &bsize, &dfree, &dsize);
 513         if (space_avail == (uint64_t)-1) {
 514                 return -1;
 515         }
 516
 517         DEBUG(10,("vfs_allocate_file_space: file %s, grow. Current size %.0f, "
 518                   "needed blocks = %.0f, space avail = %.0f\n",
 519                   fsp_str_dbg(fsp), (double)st.st_ex_size, (double)len,
 520                   (double)space_avail));
 521
 522         if (len > space_avail) {
 523                 errno = ENOSPC;
 524                 return -1;
 525         }
 526
 527         return 0;
 528 }
 529
 530 /****************************************************************************
 531  A vfs set_filelen call.
 532  set the length of a file from a filedescriptor.
 533  Returns 0 on success, -1 on failure.
 534 ****************************************************************************/
 535
 536 int vfs_set_filelen(files_struct *fsp, SMB_OFF_T len)
 537 {
 538         int ret;
 539
 540         contend_level2_oplocks_begin(fsp, LEVEL2_CONTEND_SET_FILE_LEN);
 541
 542         DEBUG(10,("vfs_set_filelen: ftruncate %s to len %.0f\n",
 543                   fsp_str_dbg(fsp), (double)len));
 544         flush_write_cache(fsp, SIZECHANGE_FLUSH);
 545         if ((ret = SMB_VFS_FTRUNCATE(fsp, len)) != -1) {
 546                 set_filelen_write_cache(fsp, len);
 547                 notify_fname(fsp->conn, NOTIFY_ACTION_MODIFIED,
 548                              FILE_NOTIFY_CHANGE_SIZE
 549                              | FILE_NOTIFY_CHANGE_ATTRIBUTES,
 550                              fsp->fsp_name->base_name);
 551         }
 552
 553         contend_level2_oplocks_end(fsp, LEVEL2_CONTEND_SET_FILE_LEN);
 554
 555         return ret;
 556 }
 557
 558 /****************************************************************************
 559  A vfs fill sparse call.
 560  Writes zeros from the end of file to len, if len is greater than EOF.
 561  Used only by strict_sync.
 562  Returns 0 on success, -1 on failure.
 563 ****************************************************************************/
 564
 565 #define SPARSE_BUF_WRITE_SIZE (32*1024)
 566
 567 int vfs_fill_sparse(files_struct *fsp, SMB_OFF_T len)
 568 {
 569         int ret;
 570         SMB_STRUCT_STAT st;
 571         SMB_OFF_T offset;
 572         size_t total;
 573         size_t num_to_write;
 574         ssize_t pwrite_ret;
 575
 576         ret = SMB_VFS_FSTAT(fsp, &st);
 577         if (ret == -1) {
 578                 return ret;
 579         }
 580
 581         if (len <= st.st_ex_size) {
 582                 return 0;
 583         }
 584
 585         DEBUG(10,("vfs_fill_sparse: write zeros in file %s from len %.0f to "
 586                   "len %.0f (%.0f bytes)\n", fsp_str_dbg(fsp),
 587                   (double)st.st_ex_size, (double)len,
 588                   (double)(len - st.st_ex_size)));
 589
 590         contend_level2_oplocks_begin(fsp, LEVEL2_CONTEND_FILL_SPARSE);
 591
 592         flush_write_cache(fsp, SIZECHANGE_FLUSH);
 593
 594         if (!sparse_buf) {
 595                 sparse_buf = SMB_CALLOC_ARRAY(char, SPARSE_BUF_WRITE_SIZE);
 596                 if (!sparse_buf) {
 597                         errno = ENOMEM;
 598                         ret = -1;
 599                         goto out;
 600                 }
 601         }
 602
 603         offset = st.st_ex_size;
 604         num_to_write = len - st.st_ex_size;
 605         total = 0;
 606
 607         while (total < num_to_write) {
 608                 size_t curr_write_size = MIN(SPARSE_BUF_WRITE_SIZE, (num_to_write - total));
 609
 610                 pwrite_ret = SMB_VFS_PWRITE(fsp, sparse_buf, curr_write_size, offset + total);
 611                 if (pwrite_ret == -1) {
 612                         DEBUG(10,("vfs_fill_sparse: SMB_VFS_PWRITE for file "
 613                                   "%s failed with error %s\n",
 614                                   fsp_str_dbg(fsp), strerror(errno)));
 615                         ret = -1;
 616                         goto out;
 617                 }
 618                 if (pwrite_ret == 0) {
 619                         ret = 0;
 620                         goto out;
 621                 }
 622
 623                 total += pwrite_ret;
 624         }
 625
 626         set_filelen_write_cache(fsp, len);
 627
 628         ret = 0;
 629  out:
 630         contend_level2_oplocks_end(fsp, LEVEL2_CONTEND_FILL_SPARSE);
 631         return ret;
 632 }
 633
 634 /****************************************************************************
 635  Transfer some data (n bytes) between two file_struct's.
 636 ****************************************************************************/
 637
 638 static ssize_t vfs_read_fn(void *file, void *buf, size_t len)
 639 {
 640         struct files_struct *fsp = (struct files_struct *)file;
 641
 642         return SMB_VFS_READ(fsp, buf, len);
 643 }
 644
 645 static ssize_t vfs_write_fn(void *file, const void *buf, size_t len)
 646 {
 647         struct files_struct *fsp = (struct files_struct *)file;
 648
 649         return SMB_VFS_WRITE(fsp, buf, len);
 650 }
 651
 652 SMB_OFF_T vfs_transfer_file(files_struct *in, files_struct *out, SMB_OFF_T n)
 653 {
 654         return transfer_file_internal((void *)in, (void *)out, n,
 655                                       vfs_read_fn, vfs_write_fn);
 656 }
 657
 658 /*******************************************************************
 659  A vfs_readdir wrapper which just returns the file name.
 660 ********************************************************************/
 661
 662 char *vfs_readdirname(connection_struct *conn, void *p, SMB_STRUCT_STAT *sbuf)
 663 {
 664         SMB_STRUCT_DIRENT *ptr= NULL;
 665         char *dname = NULL;
 666         NTSTATUS result;
 667
 668         if (!p)
 669                 return(NULL);
 670
 671         ptr = SMB_VFS_READDIR(conn, (DIR *)p, sbuf);
 672         if (!ptr)
 673                 return(NULL);
 674
 675         dname = talloc_strdup(talloc_tos(), ptr->d_name);
 676         if (dname == NULL) {
 677                 errno = ENOMEM;
 678                 return NULL;
 679         }
 680         result = SMB_VFS_TRANSLATE_NAME(conn, &dname,
 681                                         vfs_translate_to_windows);
 682         if (!NT_STATUS_IS_OK(result)) {
 683                 TALLOC_FREE(dname);
 684                 return NULL;
 685         }
 686
 687 #ifdef NEXT2
 688         if (telldir(p) < 0)
 689                 return(NULL);
 690 #endif
 691
 692 #ifdef HAVE_BROKEN_READDIR_NAME
 693         /* using /usr/ucb/cc is BAD */
 694         dname = dname - 2;
 695 #endif
 696
 697         return(dname);
 698 }
 699
 700 /*******************************************************************
 701  A wrapper for vfs_chdir().
 702 ********************************************************************/
 703
 704 int vfs_ChDir(connection_struct *conn, const char *path)
 705 {
 706         int res;
 707
 708         if (!LastDir) {
 709                 LastDir = SMB_STRDUP("");
 710         }
 711
 712         if (strcsequal(path,"."))
 713                 return(0);
 714
 715         if (*path == '/' && strcsequal(LastDir,path))
 716                 return(0);
 717
 718         DEBUG(4,("vfs_ChDir to %s\n",path));
 719
 720         res = SMB_VFS_CHDIR(conn,path);
 721         if (!res) {
 722                 SAFE_FREE(LastDir);
 723                 LastDir = SMB_STRDUP(path);
 724         }
 725         return(res);
 726 }
 727
 728 /*******************************************************************
 729  Return the absolute current directory path - given a UNIX pathname.
 730  Note that this path is returned in DOS format, not UNIX
 731  format. Note this can be called with conn == NULL.
 732 ********************************************************************/
 733
 734 char *vfs_GetWd(TALLOC_CTX *ctx, connection_struct *conn)
 735 {
 736         char s[PATH_MAX+1];
 737         char *result = NULL;
 738         DATA_BLOB cache_value;
 739         struct file_id key;
 740         struct smb_filename *smb_fname_dot = NULL;
 741         struct smb_filename *smb_fname_full = NULL;
 742         NTSTATUS status;
 743
 744         *s = 0;
 745
 746         if (!lp_getwd_cache()) {
 747                 goto nocache;
 748         }
 749
 750         status = create_synthetic_smb_fname(ctx, ".", NULL, NULL,
 751                                             &smb_fname_dot);
 752         if (!NT_STATUS_IS_OK(status)) {
 753                 errno = map_errno_from_nt_status(status);
 754                 goto out;
 755         }
 756
 757         if (SMB_VFS_STAT(conn, smb_fname_dot) == -1) {
 758                 /*
 759                  * Known to fail for root: the directory may be NFS-mounted
 760                  * and exported with root_squash (so has no root access).
 761                  */
 762                 DEBUG(1,("vfs_GetWd: couldn't stat \".\" error %s "
 763                          "(NFS problem ?)\n", strerror(errno) ));
 764                 goto nocache;
 765         }
 766
 767         key = vfs_file_id_from_sbuf(conn, &smb_fname_dot->st);
 768
 769         if (!memcache_lookup(smbd_memcache(), GETWD_CACHE,
 770                              data_blob_const(&key, sizeof(key)),
 771                              &cache_value)) {
 772                 goto nocache;
 773         }
 774
 775         SMB_ASSERT((cache_value.length > 0)
 776                    && (cache_value.data[cache_value.length-1] == '\0'));
 777
 778         status = create_synthetic_smb_fname(ctx, (char *)cache_value.data,
 779                                             NULL, NULL, &smb_fname_full);
 780         if (!NT_STATUS_IS_OK(status)) {
 781                 errno = map_errno_from_nt_status(status);
 782                 goto out;
 783         }
 784
 785         if ((SMB_VFS_STAT(conn, smb_fname_full) == 0) &&
 786             (smb_fname_dot->st.st_ex_dev == smb_fname_full->st.st_ex_dev) &&
 787             (smb_fname_dot->st.st_ex_ino == smb_fname_full->st.st_ex_ino) &&
 788             (S_ISDIR(smb_fname_dot->st.st_ex_mode))) {
 789                 /*
 790                  * Ok, we're done
 791                  */
 792                 result = talloc_strdup(ctx, smb_fname_full->base_name);
 793                 if (result == NULL) {
 794                         errno = ENOMEM;
 795                 }
 796                 goto out;
 797         }
 798
 799  nocache:
 800
 801         /*
 802          * We don't have the information to hand so rely on traditional
 803          * methods. The very slow getcwd, which spawns a process on some
 804          * systems, or the not quite so bad getwd.
 805          */
 806
 807         if (!SMB_VFS_GETWD(conn,s)) {
 808                 DEBUG(0, ("vfs_GetWd: SMB_VFS_GETWD call failed: %s\n",
 809                           strerror(errno)));
 810                 goto out;
 811         }
 812
 813         if (lp_getwd_cache() && VALID_STAT(smb_fname_dot->st)) {
 814                 key = vfs_file_id_from_sbuf(conn, &smb_fname_dot->st);
 815
 816                 memcache_add(smbd_memcache(), GETWD_CACHE,
 817                              data_blob_const(&key, sizeof(key)),
 818                              data_blob_const(s, strlen(s)+1));
 819         }
 820
 821         result = talloc_strdup(ctx, s);
 822         if (result == NULL) {
 823                 errno = ENOMEM;
 824         }
 825
 826  out:
 827         TALLOC_FREE(smb_fname_dot);
 828         TALLOC_FREE(smb_fname_full);
 829         return result;
 830 }
 831
 832 /*******************************************************************
 833  Reduce a file name, removing .. elements and checking that
 834  it is below dir in the heirachy. This uses realpath.
 835 ********************************************************************/
 836
 837 NTSTATUS check_reduced_name(connection_struct *conn, const char *fname)
 838 {
 839 #ifdef REALPATH_TAKES_NULL
 840         bool free_resolved_name = True;
 841 #else
 842         char resolved_name_buf[PATH_MAX+1];
 843         bool free_resolved_name = False;
 844 #endif
 845         char *resolved_name = NULL;
 846         char *p = NULL;
 847
 848         DEBUG(3,("check_reduced_name [%s] [%s]\n", fname, conn->connectpath));
 849
 850 #ifdef REALPATH_TAKES_NULL
 851         resolved_name = SMB_VFS_REALPATH(conn,fname,NULL);
 852 #else
 853         resolved_name = SMB_VFS_REALPATH(conn,fname,resolved_name_buf);
 854 #endif
 855
 856         if (!resolved_name) {
 857                 switch (errno) {
 858                         case ENOTDIR:
 859                                 DEBUG(3,("check_reduced_name: Component not a "
 860                                          "directory in getting realpath for "
 861                                          "%s\n", fname));
 862                                 return map_nt_error_from_unix(errno);
 863                         case ENOENT:
 864                         {
 865                                 TALLOC_CTX *ctx = talloc_tos();
 866                                 char *tmp_fname = NULL;
 867                                 char *last_component = NULL;
 868                                 /* Last component didn't exist. Remove it and try and canonicalise the directory. */
 869
 870                                 tmp_fname = talloc_strdup(ctx, fname);
 871                                 if (!tmp_fname) {
 872                                         return NT_STATUS_NO_MEMORY;
 873                                 }
 874                                 p = strrchr_m(tmp_fname, '/');
 875                                 if (p) {
 876                                         *p++ = '\0';
 877                                         last_component = p;
 878                                 } else {
 879                                         last_component = tmp_fname;
 880                                         tmp_fname = talloc_strdup(ctx,
 881                                                         ".");
 882                                         if (!tmp_fname) {
 883                                                 return NT_STATUS_NO_MEMORY;
 884                                         }
 885                                 }
 886
 887 #ifdef REALPATH_TAKES_NULL
 888                                 resolved_name = SMB_VFS_REALPATH(conn,tmp_fname,NULL);
 889 #else
 890                                 resolved_name = SMB_VFS_REALPATH(conn,tmp_fname,resolved_name_buf);
 891 #endif
 892                                 if (!resolved_name) {
 893                                         DEBUG(3,("check_reduce_named: "
 894                                                  "couldn't get realpath for "
 895                                                  "%s\n", fname));
 896                                         return map_nt_error_from_unix(errno);
 897                                 }
 898                                 tmp_fname = talloc_asprintf(ctx,
 899                                                 "%s/%s",
 900                                                 resolved_name,
 901                                                 last_component);
 902                                 if (!tmp_fname) {
 903                                         return NT_STATUS_NO_MEMORY;
 904                                 }
 905 #ifdef REALPATH_TAKES_NULL
 906                                 SAFE_FREE(resolved_name);
 907                                 resolved_name = SMB_STRDUP(tmp_fname);
 908                                 if (!resolved_name) {
 909                                         DEBUG(0, ("check_reduced_name: malloc "
 910                                                   "fail for %s\n", tmp_fname));
 911                                         return NT_STATUS_NO_MEMORY;
 912                                 }
 913 #else
 914                                 safe_strcpy(resolved_name_buf, tmp_fname, PATH_MAX);
 915                                 resolved_name = resolved_name_buf;
 916 #endif
 917                                 break;
 918                         }
 919                         default:
 920                                 DEBUG(1,("check_reduced_name: couldn't get "
 921                                          "realpath for %s\n", fname));
 922                                 return map_nt_error_from_unix(errno);
 923                 }
 924         }
 925
 926         DEBUG(10,("check_reduced_name realpath [%s] -> [%s]\n", fname,
 927                   resolved_name));
 928
 929         if (*resolved_name != '/') {
 930                 DEBUG(0,("check_reduced_name: realpath doesn't return "
 931                          "absolute paths !\n"));
 932                 if (free_resolved_name) {
 933                         SAFE_FREE(resolved_name);
 934                 }
 935                 return NT_STATUS_OBJECT_NAME_INVALID;
 936         }
 937
 938         /* Check for widelinks allowed. */
 939         if (!lp_widelinks(SNUM(conn))) {
 940                     const char *conn_rootdir;
 941
 942                     conn_rootdir = SMB_VFS_CONNECTPATH(conn, fname);
 943                     if (conn_rootdir == NULL) {
 944                             DEBUG(2, ("check_reduced_name: Could not get "
 945                                       "conn_rootdir\n"));
 946                             if (free_resolved_name) {
 947                                     SAFE_FREE(resolved_name);
 948                             }
 949                             return NT_STATUS_ACCESS_DENIED;
 950                     }
 951
 952                     if (strncmp(conn_rootdir, resolved_name,
 953                                 strlen(conn_rootdir)) != 0) {
 954                             DEBUG(2, ("check_reduced_name: Bad access "
 955                                       "attempt: %s is a symlink outside the "
 956                                       "share path", fname));
 957                             if (free_resolved_name) {
 958                                     SAFE_FREE(resolved_name);
 959                             }
 960                             return NT_STATUS_ACCESS_DENIED;
 961                     }
 962         }
 963
 964         /* Check if we are allowing users to follow symlinks */
 965         /* Patch from David Clerc <David.Clerc@cui.unige.ch>
 966                 University of Geneva */
 967
 968 #ifdef S_ISLNK
 969         if (!lp_symlinks(SNUM(conn))) {
 970                 struct smb_filename *smb_fname = NULL;
 971                 NTSTATUS status;
 972
 973                 status = create_synthetic_smb_fname(talloc_tos(), fname, NULL,
 974                                                     NULL, &smb_fname);
 975                 if (!NT_STATUS_IS_OK(status)) {
 976                         if (free_resolved_name) {
 977                                 SAFE_FREE(resolved_name);
 978                         }
 979                         return status;
 980                 }
 981
 982                 if ( (SMB_VFS_LSTAT(conn, smb_fname) != -1) &&
 983                                 (S_ISLNK(smb_fname->st.st_ex_mode)) ) {
 984                         if (free_resolved_name) {
 985                                 SAFE_FREE(resolved_name);
 986                         }
 987                         DEBUG(3,("check_reduced_name: denied: file path name "
 988                                  "%s is a symlink\n",resolved_name));
 989                         TALLOC_FREE(smb_fname);
 990                         return NT_STATUS_ACCESS_DENIED;
 991                 }
 992                 TALLOC_FREE(smb_fname);
 993         }
 994 #endif
 995
 996         DEBUG(3,("check_reduced_name: %s reduced to %s\n", fname,
 997                  resolved_name));
 998         if (free_resolved_name) {
 999                 SAFE_FREE(resolved_name);
1000         }
1001         return NT_STATUS_OK;
1002 }
1003
1004 /**
1005  * XXX: This is temporary and there should be no callers of this once
1006  * smb_filename is plumbed through all path based operations.
1007  */
1008 int vfs_stat_smb_fname(struct connection_struct *conn, const char *fname,
1009                        SMB_STRUCT_STAT *psbuf)
1010 {
1011         struct smb_filename *smb_fname = NULL;
1012         NTSTATUS status;
1013         int ret;
1014
1015         status = create_synthetic_smb_fname_split(talloc_tos(), fname, NULL,
1016                                                   &smb_fname);
1017         if (!NT_STATUS_IS_OK(status)) {
1018                 errno = map_errno_from_nt_status(status);
1019                 return -1;
1020         }
1021
1022         if (lp_posix_pathnames()) {
1023                 ret = SMB_VFS_LSTAT(conn, smb_fname);
1024         } else {
1025                 ret = SMB_VFS_STAT(conn, smb_fname);
1026         }
1027
1028         if (ret != -1) {
1029                 *psbuf = smb_fname->st;
1030         }
1031
1032         TALLOC_FREE(smb_fname);
1033         return ret;
1034 }
1035
1036 /**
1037  * XXX: This is temporary and there should be no callers of this once
1038  * smb_filename is plumbed through all path based operations.
1039  */
1040 int vfs_lstat_smb_fname(struct connection_struct *conn, const char *fname,
1041                         SMB_STRUCT_STAT *psbuf)
1042 {
1043         struct smb_filename *smb_fname = NULL;
1044         NTSTATUS status;
1045         int ret;
1046
1047         status = create_synthetic_smb_fname_split(talloc_tos(), fname, NULL,
1048                                                   &smb_fname);
1049         if (!NT_STATUS_IS_OK(status)) {
1050                 errno = map_errno_from_nt_status(status);
1051                 return -1;
1052         }
1053
1054         ret = SMB_VFS_LSTAT(conn, smb_fname);
1055         if (ret != -1) {
1056                 *psbuf = smb_fname->st;
1057         }
1058
1059         TALLOC_FREE(smb_fname);
1060         return ret;
1061 }
1062
1063 /**
1064  * Ensure LSTAT is called for POSIX paths.
1065  */
1066
1067 NTSTATUS vfs_stat_fsp(files_struct *fsp)
1068 {
1069         int ret;
1070
1071         if(fsp->is_directory || fsp->fh->fd == -1) {
1072                 if (fsp->posix_open) {
1073                         ret = SMB_VFS_LSTAT(fsp->conn, fsp->fsp_name);
1074                 } else {
1075                         ret = SMB_VFS_STAT(fsp->conn, fsp->fsp_name);
1076                 }
1077                 if (ret == -1) {
1078                         return map_nt_error_from_unix(errno);
1079                 }
1080         } else {
1081                 if(SMB_VFS_FSTAT(fsp, &fsp->fsp_name->st) != 0) {
1082                         return map_nt_error_from_unix(errno);
1083                 }
1084         }
1085         return NT_STATUS_OK;
1086 }
1087
1088 /*
1089   generate a file_id from a stat structure
1090  */
1091 struct file_id vfs_file_id_from_sbuf(connection_struct *conn, const SMB_STRUCT_STAT *sbuf)
1092 {
1093         return SMB_VFS_FILE_ID_CREATE(conn, sbuf);
1094 }
1095
1096 int smb_vfs_call_connect(struct vfs_handle_struct *handle,
1097                          const char *service, const char *user)
1098 {
1099         VFS_FIND(connect_fn);
1100         return handle->fns->connect_fn(handle, service, user);
1101 }
1102
1103 void smb_vfs_call_disconnect(struct vfs_handle_struct *handle)
1104 {
1105         VFS_FIND(disconnect);
1106         handle->fns->disconnect(handle);
1107 }
1108
1109 uint64_t smb_vfs_call_disk_free(struct vfs_handle_struct *handle,
1110                                 const char *path, bool small_query,
1111                                 uint64_t *bsize, uint64_t *dfree,
1112                                 uint64_t *dsize)
1113 {
1114         VFS_FIND(disk_free);
1115         return handle->fns->disk_free(handle, path, small_query, bsize, dfree,
1116                                       dsize);
1117 }
1118
1119 int smb_vfs_call_get_quota(struct vfs_handle_struct *handle,
1120                            enum SMB_QUOTA_TYPE qtype, unid_t id,
1121                            SMB_DISK_QUOTA *qt)
1122 {
1123         VFS_FIND(get_quota);
1124         return handle->fns->get_quota(handle, qtype, id, qt);
1125 }
1126
1127 int smb_vfs_call_set_quota(struct vfs_handle_struct *handle,
1128                            enum SMB_QUOTA_TYPE qtype, unid_t id,
1129                            SMB_DISK_QUOTA *qt)
1130 {
1131         VFS_FIND(set_quota);
1132         return handle->fns->set_quota(handle, qtype, id, qt);
1133 }
1134
1135 int smb_vfs_call_get_shadow_copy_data(struct vfs_handle_struct *handle,
1136                                       struct files_struct *fsp,
1137                                       SHADOW_COPY_DATA *shadow_copy_data,
1138                                       bool labels)
1139 {
1140         VFS_FIND(get_shadow_copy_data);
1141         return handle->fns->get_shadow_copy_data(handle, fsp, shadow_copy_data,
1142                                                  labels);
1143 }
1144 int smb_vfs_call_statvfs(struct vfs_handle_struct *handle, const char *path,
1145                          struct vfs_statvfs_struct *statbuf)
1146 {
1147         VFS_FIND(statvfs);
1148         return handle->fns->statvfs(handle, path, statbuf);
1149 }
1150
1151 uint32_t smb_vfs_call_fs_capabilities(struct vfs_handle_struct *handle,
1152                         enum timestamp_set_resolution *p_ts_res)
1153 {
1154         VFS_FIND(fs_capabilities);
1155         return handle->fns->fs_capabilities(handle, p_ts_res);
1156 }
1157
1158 SMB_STRUCT_DIR *smb_vfs_call_opendir(struct vfs_handle_struct *handle,
1159                                      const char *fname, const char *mask,
1160                                      uint32 attributes)
1161 {
1162         VFS_FIND(opendir);
1163         return handle->fns->opendir(handle, fname, mask, attributes);
1164 }
1165
1166 SMB_STRUCT_DIRENT *smb_vfs_call_readdir(struct vfs_handle_struct *handle,
1167                                               SMB_STRUCT_DIR *dirp,
1168                                               SMB_STRUCT_STAT *sbuf)
1169 {
1170         VFS_FIND(readdir);
1171         return handle->fns->readdir(handle, dirp, sbuf);
1172 }
1173
1174 void smb_vfs_call_seekdir(struct vfs_handle_struct *handle,
1175                           SMB_STRUCT_DIR *dirp, long offset)
1176 {
1177         VFS_FIND(seekdir);
1178         handle->fns->seekdir(handle, dirp, offset);
1179 }
1180
1181 long smb_vfs_call_telldir(struct vfs_handle_struct *handle,
1182                           SMB_STRUCT_DIR *dirp)
1183 {
1184         VFS_FIND(telldir);
1185         return handle->fns->telldir(handle, dirp);
1186 }
1187
1188 void smb_vfs_call_rewind_dir(struct vfs_handle_struct *handle,
1189                              SMB_STRUCT_DIR *dirp)
1190 {
1191         VFS_FIND(rewind_dir);
1192         handle->fns->rewind_dir(handle, dirp);
1193 }
1194
1195 int smb_vfs_call_mkdir(struct vfs_handle_struct *handle, const char *path,
1196                        mode_t mode)
1197 {
1198         VFS_FIND(mkdir);
1199         return handle->fns->mkdir(handle, path, mode);
1200 }
1201
1202 int smb_vfs_call_rmdir(struct vfs_handle_struct *handle, const char *path)
1203 {
1204         VFS_FIND(rmdir);
1205         return handle->fns->rmdir(handle, path);
1206 }
1207
1208 int smb_vfs_call_closedir(struct vfs_handle_struct *handle,
1209                           SMB_STRUCT_DIR *dir)
1210 {
1211         VFS_FIND(closedir);
1212         return handle->fns->closedir(handle, dir);
1213 }
1214
1215 void smb_vfs_call_init_search_op(struct vfs_handle_struct *handle,
1216                                  SMB_STRUCT_DIR *dirp)
1217 {
1218         VFS_FIND(init_search_op);
1219         handle->fns->init_search_op(handle, dirp);
1220 }
1221
1222 int smb_vfs_call_open(struct vfs_handle_struct *handle,
1223                       struct smb_filename *smb_fname, struct files_struct *fsp,
1224                       int flags, mode_t mode)
1225 {
1226         VFS_FIND(open);
1227         return handle->fns->open(handle, smb_fname, fsp, flags, mode);
1228 }
1229
1230 NTSTATUS smb_vfs_call_create_file(struct vfs_handle_struct *handle,
1231                                   struct smb_request *req,
1232                                   uint16_t root_dir_fid,
1233                                   struct smb_filename *smb_fname,
1234                                   uint32_t access_mask,
1235                                   uint32_t share_access,
1236                                   uint32_t create_disposition,
1237                                   uint32_t create_options,
1238                                   uint32_t file_attributes,
1239                                   uint32_t oplock_request,
1240                                   uint64_t allocation_size,
1241                                   struct security_descriptor *sd,
1242                                   struct ea_list *ea_list,
1243                                   files_struct **result,
1244                                   int *pinfo)
1245 {
1246         VFS_FIND(create_file);
1247         return handle->fns->create_file(
1248                 handle, req, root_dir_fid, smb_fname, access_mask,
1249                 share_access, create_disposition, create_options,
1250                 file_attributes, oplock_request, allocation_size, sd, ea_list,
1251                 result, pinfo);
1252 }
1253
1254 int smb_vfs_call_close_fn(struct vfs_handle_struct *handle,
1255                           struct files_struct *fsp)
1256 {
1257         VFS_FIND(close_fn);
1258         return handle->fns->close_fn(handle, fsp);
1259 }
1260
1261 ssize_t smb_vfs_call_vfs_read(struct vfs_handle_struct *handle,
1262                               struct files_struct *fsp, void *data, size_t n)
1263 {
1264         VFS_FIND(vfs_read);
1265         return handle->fns->vfs_read(handle, fsp, data, n);
1266 }
1267
1268 ssize_t smb_vfs_call_pread(struct vfs_handle_struct *handle,
1269                            struct files_struct *fsp, void *data, size_t n,
1270                            SMB_OFF_T offset)
1271 {
1272         VFS_FIND(pread);
1273         return handle->fns->pread(handle, fsp, data, n, offset);
1274 }
1275
1276 ssize_t smb_vfs_call_write(struct vfs_handle_struct *handle,
1277                            struct files_struct *fsp, const void *data,
1278                            size_t n)
1279 {
1280         VFS_FIND(write);
1281         return handle->fns->write(handle, fsp, data, n);
1282 }
1283
1284 ssize_t smb_vfs_call_pwrite(struct vfs_handle_struct *handle,
1285                             struct files_struct *fsp, const void *data,
1286                             size_t n, SMB_OFF_T offset)
1287 {
1288         VFS_FIND(pwrite);
1289         return handle->fns->pwrite(handle, fsp, data, n, offset);
1290 }
1291
1292 SMB_OFF_T smb_vfs_call_lseek(struct vfs_handle_struct *handle,
1293                              struct files_struct *fsp, SMB_OFF_T offset,
1294                              int whence)
1295 {
1296         VFS_FIND(lseek);
1297         return handle->fns->lseek(handle, fsp, offset, whence);
1298 }
1299
1300 ssize_t smb_vfs_call_sendfile(struct vfs_handle_struct *handle, int tofd,
1301                               files_struct *fromfsp, const DATA_BLOB *header,
1302                               SMB_OFF_T offset, size_t count)
1303 {
1304         VFS_FIND(sendfile);
1305         return handle->fns->sendfile(handle, tofd, fromfsp, header, offset,
1306                                      count);
1307 }
1308
1309 ssize_t smb_vfs_call_recvfile(struct vfs_handle_struct *handle, int fromfd,
1310                               files_struct *tofsp, SMB_OFF_T offset,
1311                               size_t count)
1312 {
1313         VFS_FIND(recvfile);
1314         return handle->fns->recvfile(handle, fromfd, tofsp, offset, count);
1315 }
1316
1317 int smb_vfs_call_rename(struct vfs_handle_struct *handle,
1318                         const struct smb_filename *smb_fname_src,
1319                         const struct smb_filename *smb_fname_dst)
1320 {
1321         VFS_FIND(rename);
1322         return handle->fns->rename(handle, smb_fname_src, smb_fname_dst);
1323 }
1324
1325 int smb_vfs_call_fsync(struct vfs_handle_struct *handle,
1326                        struct files_struct *fsp)
1327 {
1328         VFS_FIND(fsync);
1329         return handle->fns->fsync(handle, fsp);
1330 }
1331
1332 int smb_vfs_call_stat(struct vfs_handle_struct *handle,
1333                       struct smb_filename *smb_fname)
1334 {
1335         VFS_FIND(stat);
1336         return handle->fns->stat(handle, smb_fname);
1337 }
1338
1339 int smb_vfs_call_fstat(struct vfs_handle_struct *handle,
1340                        struct files_struct *fsp, SMB_STRUCT_STAT *sbuf)
1341 {
1342         VFS_FIND(fstat);
1343         return handle->fns->fstat(handle, fsp, sbuf);
1344 }
1345
1346 int smb_vfs_call_lstat(struct vfs_handle_struct *handle,
1347                        struct smb_filename *smb_filename)
1348 {
1349         VFS_FIND(lstat);
1350         return handle->fns->lstat(handle, smb_filename);
1351 }
1352
1353 uint64_t smb_vfs_call_get_alloc_size(struct vfs_handle_struct *handle,
1354                                      struct files_struct *fsp,
1355                                      const SMB_STRUCT_STAT *sbuf)
1356 {
1357         VFS_FIND(get_alloc_size);
1358         return handle->fns->get_alloc_size(handle, fsp, sbuf);
1359 }
1360
1361 int smb_vfs_call_unlink(struct vfs_handle_struct *handle,
1362                         const struct smb_filename *smb_fname)
1363 {
1364         VFS_FIND(unlink);
1365         return handle->fns->unlink(handle, smb_fname);
1366 }
1367
1368 int smb_vfs_call_chmod(struct vfs_handle_struct *handle, const char *path,
1369                        mode_t mode)
1370 {
1371         VFS_FIND(chmod);
1372         return handle->fns->chmod(handle, path, mode);
1373 }
1374
1375 int smb_vfs_call_fchmod(struct vfs_handle_struct *handle,
1376                         struct files_struct *fsp, mode_t mode)
1377 {
1378         VFS_FIND(fchmod);
1379         return handle->fns->fchmod(handle, fsp, mode);
1380 }
1381
1382 int smb_vfs_call_chown(struct vfs_handle_struct *handle, const char *path,
1383                        uid_t uid, gid_t gid)
1384 {
1385         VFS_FIND(chown);
1386         return handle->fns->chown(handle, path, uid, gid);
1387 }
1388
1389 int smb_vfs_call_fchown(struct vfs_handle_struct *handle,
1390                         struct files_struct *fsp, uid_t uid, gid_t gid)
1391 {
1392         VFS_FIND(fchown);
1393         return handle->fns->fchown(handle, fsp, uid, gid);
1394 }
1395
1396 int smb_vfs_call_lchown(struct vfs_handle_struct *handle, const char *path,
1397                         uid_t uid, gid_t gid)
1398 {
1399         VFS_FIND(lchown);
1400         return handle->fns->lchown(handle, path, uid, gid);
1401 }
1402
1403 int smb_vfs_call_chdir(struct vfs_handle_struct *handle, const char *path)
1404 {
1405         VFS_FIND(chdir);
1406         return handle->fns->chdir(handle, path);
1407 }
1408
1409 char *smb_vfs_call_getwd(struct vfs_handle_struct *handle, char *buf)
1410 {
1411         VFS_FIND(getwd);
1412         return handle->fns->getwd(handle, buf);
1413 }
1414
1415 int smb_vfs_call_ntimes(struct vfs_handle_struct *handle,
1416                         const struct smb_filename *smb_fname,
1417                         struct smb_file_time *ft)
1418 {
1419         VFS_FIND(ntimes);
1420         return handle->fns->ntimes(handle, smb_fname, ft);
1421 }
1422
1423 int smb_vfs_call_ftruncate(struct vfs_handle_struct *handle,
1424                            struct files_struct *fsp, SMB_OFF_T offset)
1425 {
1426         VFS_FIND(ftruncate);
1427         return handle->fns->ftruncate(handle, fsp, offset);
1428 }
1429
1430 int smb_vfs_call_kernel_flock(struct vfs_handle_struct *handle,
1431                               struct files_struct *fsp, uint32 share_mode,
1432                               uint32_t access_mask)
1433 {
1434         VFS_FIND(kernel_flock);
1435         return handle->fns->kernel_flock(handle, fsp, share_mode,
1436                                          access_mask);
1437 }
1438
1439 int smb_vfs_call_linux_setlease(struct vfs_handle_struct *handle,
1440                                 struct files_struct *fsp, int leasetype)
1441 {
1442         VFS_FIND(linux_setlease);
1443         return handle->fns->linux_setlease(handle, fsp, leasetype);
1444 }
1445
1446 int smb_vfs_call_symlink(struct vfs_handle_struct *handle, const char *oldpath,
1447                          const char *newpath)
1448 {
1449         VFS_FIND(symlink);
1450         return handle->fns->symlink(handle, oldpath, newpath);
1451 }
1452
1453 int smb_vfs_call_vfs_readlink(struct vfs_handle_struct *handle,
1454                               const char *path, char *buf, size_t bufsiz)
1455 {
1456         VFS_FIND(vfs_readlink);
1457         return handle->fns->vfs_readlink(handle, path, buf, bufsiz);
1458 }
1459
1460 int smb_vfs_call_link(struct vfs_handle_struct *handle, const char *oldpath,
1461                       const char *newpath)
1462 {
1463         VFS_FIND(link);
1464         return handle->fns->link(handle, oldpath, newpath);
1465 }
1466
1467 int smb_vfs_call_mknod(struct vfs_handle_struct *handle, const char *path,
1468                        mode_t mode, SMB_DEV_T dev)
1469 {
1470         VFS_FIND(mknod);
1471         return handle->fns->mknod(handle, path, mode, dev);
1472 }
1473
1474 char *smb_vfs_call_realpath(struct vfs_handle_struct *handle,
1475                             const char *path, char *resolved_path)
1476 {
1477         VFS_FIND(realpath);
1478         return handle->fns->realpath(handle, path, resolved_path);
1479 }
1480
1481 NTSTATUS smb_vfs_call_notify_watch(struct vfs_handle_struct *handle,
1482                                    struct sys_notify_context *ctx,
1483                                    struct notify_entry *e,
1484                                    void (*callback)(struct sys_notify_context *ctx,
1485                                                     void *private_data,
1486                                                     struct notify_event *ev),
1487                                    void *private_data, void *handle_p)
1488 {
1489         VFS_FIND(notify_watch);
1490         return handle->fns->notify_watch(handle, ctx, e, callback,
1491                                          private_data, handle_p);
1492 }
1493
1494 int smb_vfs_call_chflags(struct vfs_handle_struct *handle, const char *path,
1495                          unsigned int flags)
1496 {
1497         VFS_FIND(chflags);
1498         return handle->fns->chflags(handle, path, flags);
1499 }
1500
1501 struct file_id smb_vfs_call_file_id_create(struct vfs_handle_struct *handle,
1502                                            const SMB_STRUCT_STAT *sbuf)
1503 {
1504         VFS_FIND(file_id_create);
1505         return handle->fns->file_id_create(handle, sbuf);
1506 }
1507
1508 NTSTATUS smb_vfs_call_streaminfo(struct vfs_handle_struct *handle,
1509                                  struct files_struct *fsp,
1510                                  const char *fname,
1511                                  TALLOC_CTX *mem_ctx,
1512                                  unsigned int *num_streams,
1513                                  struct stream_struct **streams)
1514 {
1515         VFS_FIND(streaminfo);
1516         return handle->fns->streaminfo(handle, fsp, fname, mem_ctx,
1517                                        num_streams, streams);
1518 }
1519
1520 int smb_vfs_call_get_real_filename(struct vfs_handle_struct *handle,
1521                                    const char *path, const char *name,
1522                                    TALLOC_CTX *mem_ctx, char **found_name)
1523 {
1524         VFS_FIND(get_real_filename);
1525         return handle->fns->get_real_filename(handle, path, name, mem_ctx,
1526                                               found_name);
1527 }
1528
1529 const char *smb_vfs_call_connectpath(struct vfs_handle_struct *handle,
1530                                      const char *filename)
1531 {
1532         VFS_FIND(connectpath);
1533         return handle->fns->connectpath(handle, filename);
1534 }
1535
1536 bool smb_vfs_call_strict_lock(struct vfs_handle_struct *handle,
1537                               struct files_struct *fsp,
1538                               struct lock_struct *plock)
1539 {
1540         VFS_FIND(strict_lock);
1541         return handle->fns->strict_lock(handle, fsp, plock);
1542 }
1543
1544 void smb_vfs_call_strict_unlock(struct vfs_handle_struct *handle,
1545                                 struct files_struct *fsp,
1546                                 struct lock_struct *plock)
1547 {
1548         VFS_FIND(strict_unlock);
1549         handle->fns->strict_unlock(handle, fsp, plock);
1550 }
1551
1552 NTSTATUS smb_vfs_call_translate_name(struct vfs_handle_struct *handle,
1553                                      char **mapped_name,
1554                                      enum vfs_translate_direction direction)
1555 {
1556         VFS_FIND(translate_name);
1557         return handle->fns->translate_name(handle, mapped_name, direction);
1558 }
1559
1560 NTSTATUS smb_vfs_call_fget_nt_acl(struct vfs_handle_struct *handle,
1561                                   struct files_struct *fsp,
1562                                   uint32 security_info,
1563                                   struct security_descriptor **ppdesc)
1564 {
1565         VFS_FIND(fget_nt_acl);
1566         return handle->fns->fget_nt_acl(handle, fsp, security_info,
1567                                         ppdesc);
1568 }
1569
1570 NTSTATUS smb_vfs_call_get_nt_acl(struct vfs_handle_struct *handle,
1571                                  const char *name,
1572                                  uint32 security_info,
1573                                  struct security_descriptor **ppdesc)
1574 {
1575         VFS_FIND(get_nt_acl);
1576         return handle->fns->get_nt_acl(handle, name, security_info, ppdesc);
1577 }
1578
1579 NTSTATUS smb_vfs_call_fset_nt_acl(struct vfs_handle_struct *handle,
1580                                   struct files_struct *fsp,
1581                                   uint32 security_info_sent,
1582                                   const struct security_descriptor *psd)
1583 {
1584         VFS_FIND(fset_nt_acl);
1585         return handle->fns->fset_nt_acl(handle, fsp, security_info_sent, psd);
1586 }
1587
1588 int smb_vfs_call_chmod_acl(struct vfs_handle_struct *handle, const char *name,
1589                            mode_t mode)
1590 {
1591         VFS_FIND(chmod_acl);
1592         return handle->fns->chmod_acl(handle, name, mode);
1593 }
1594
1595 int smb_vfs_call_fchmod_acl(struct vfs_handle_struct *handle,
1596                             struct files_struct *fsp, mode_t mode)
1597 {
1598         VFS_FIND(fchmod_acl);
1599         return handle->fns->fchmod_acl(handle, fsp, mode);
1600 }
1601
1602 int smb_vfs_call_sys_acl_get_entry(struct vfs_handle_struct *handle,
1603                                    SMB_ACL_T theacl, int entry_id,
1604                                    SMB_ACL_ENTRY_T *entry_p)
1605 {
1606         VFS_FIND(sys_acl_get_entry);
1607         return handle->fns->sys_acl_get_entry(handle, theacl, entry_id,
1608                                               entry_p);
1609 }
1610
1611 int smb_vfs_call_sys_acl_get_tag_type(struct vfs_handle_struct *handle,
1612                                       SMB_ACL_ENTRY_T entry_d,
1613                                       SMB_ACL_TAG_T *tag_type_p)
1614 {
1615         VFS_FIND(sys_acl_get_tag_type);
1616         return handle->fns->sys_acl_get_tag_type(handle, entry_d, tag_type_p);
1617 }
1618
1619 int smb_vfs_call_sys_acl_get_permset(struct vfs_handle_struct *handle,
1620                                      SMB_ACL_ENTRY_T entry_d,
1621                                      SMB_ACL_PERMSET_T *permset_p)
1622 {
1623         VFS_FIND(sys_acl_get_permset);
1624         return handle->fns->sys_acl_get_permset(handle, entry_d, permset_p);
1625 }
1626
1627 void * smb_vfs_call_sys_acl_get_qualifier(struct vfs_handle_struct *handle,
1628                                           SMB_ACL_ENTRY_T entry_d)
1629 {
1630         VFS_FIND(sys_acl_get_qualifier);
1631         return handle->fns->sys_acl_get_qualifier(handle, entry_d);
1632 }
1633
1634 SMB_ACL_T smb_vfs_call_sys_acl_get_file(struct vfs_handle_struct *handle,
1635                                         const char *path_p,
1636                                         SMB_ACL_TYPE_T type)
1637 {
1638         VFS_FIND(sys_acl_get_file);
1639         return handle->fns->sys_acl_get_file(handle, path_p, type);
1640 }
1641
1642 SMB_ACL_T smb_vfs_call_sys_acl_get_fd(struct vfs_handle_struct *handle,
1643                                       struct files_struct *fsp)
1644 {
1645         VFS_FIND(sys_acl_get_fd);
1646         return handle->fns->sys_acl_get_fd(handle, fsp);
1647 }
1648
1649 int smb_vfs_call_sys_acl_clear_perms(struct vfs_handle_struct *handle,
1650                                      SMB_ACL_PERMSET_T permset)
1651 {
1652         VFS_FIND(sys_acl_clear_perms);
1653         return handle->fns->sys_acl_clear_perms(handle, permset);
1654 }
1655
1656 int smb_vfs_call_sys_acl_add_perm(struct vfs_handle_struct *handle,
1657                                   SMB_ACL_PERMSET_T permset,
1658                                   SMB_ACL_PERM_T perm)
1659 {
1660         VFS_FIND(sys_acl_add_perm);
1661         return handle->fns->sys_acl_add_perm(handle, permset, perm);
1662 }
1663
1664 char * smb_vfs_call_sys_acl_to_text(struct vfs_handle_struct *handle,
1665                                     SMB_ACL_T theacl, ssize_t *plen)
1666 {
1667         VFS_FIND(sys_acl_to_text);
1668         return handle->fns->sys_acl_to_text(handle, theacl, plen);
1669 }
1670
1671 SMB_ACL_T smb_vfs_call_sys_acl_init(struct vfs_handle_struct *handle,
1672                                     int count)
1673 {
1674         VFS_FIND(sys_acl_init);
1675         return handle->fns->sys_acl_init(handle, count);
1676 }
1677
1678 int smb_vfs_call_sys_acl_create_entry(struct vfs_handle_struct *handle,
1679                                       SMB_ACL_T *pacl, SMB_ACL_ENTRY_T *pentry)
1680 {
1681         VFS_FIND(sys_acl_create_entry);
1682         return handle->fns->sys_acl_create_entry(handle, pacl, pentry);
1683 }
1684
1685 int smb_vfs_call_sys_acl_set_tag_type(struct vfs_handle_struct *handle,
1686                                       SMB_ACL_ENTRY_T entry,
1687                                       SMB_ACL_TAG_T tagtype)
1688 {
1689         VFS_FIND(sys_acl_set_tag_type);
1690         return handle->fns->sys_acl_set_tag_type(handle, entry, tagtype);
1691 }
1692
1693 int smb_vfs_call_sys_acl_set_qualifier(struct vfs_handle_struct *handle,
1694                                        SMB_ACL_ENTRY_T entry, void *qual)
1695 {
1696         VFS_FIND(sys_acl_set_qualifier);
1697         return handle->fns->sys_acl_set_qualifier(handle, entry, qual);
1698 }
1699
1700 int smb_vfs_call_sys_acl_set_permset(struct vfs_handle_struct *handle,
1701                                      SMB_ACL_ENTRY_T entry,
1702                                      SMB_ACL_PERMSET_T permset)
1703 {
1704         VFS_FIND(sys_acl_set_permset);
1705         return handle->fns->sys_acl_set_permset(handle, entry, permset);
1706 }
1707
1708 int smb_vfs_call_sys_acl_valid(struct vfs_handle_struct *handle,
1709                                SMB_ACL_T theacl)
1710 {
1711         VFS_FIND(sys_acl_valid);
1712         return handle->fns->sys_acl_valid(handle, theacl);
1713 }
1714
1715 int smb_vfs_call_sys_acl_set_file(struct vfs_handle_struct *handle,
1716                                   const char *name, SMB_ACL_TYPE_T acltype,
1717                                   SMB_ACL_T theacl)
1718 {
1719         VFS_FIND(sys_acl_set_file);
1720         return handle->fns->sys_acl_set_file(handle, name, acltype, theacl);
1721 }
1722
1723 int smb_vfs_call_sys_acl_set_fd(struct vfs_handle_struct *handle,
1724                                 struct files_struct *fsp, SMB_ACL_T theacl)
1725 {
1726         VFS_FIND(sys_acl_set_fd);
1727         return handle->fns->sys_acl_set_fd(handle, fsp, theacl);
1728 }
1729
1730 int smb_vfs_call_sys_acl_delete_def_file(struct vfs_handle_struct *handle,
1731                                          const char *path)
1732 {
1733         VFS_FIND(sys_acl_delete_def_file);
1734         return handle->fns->sys_acl_delete_def_file(handle, path);
1735 }
1736
1737 int smb_vfs_call_sys_acl_get_perm(struct vfs_handle_struct *handle,
1738                                   SMB_ACL_PERMSET_T permset,
1739                                   SMB_ACL_PERM_T perm)
1740 {
1741         VFS_FIND(sys_acl_get_perm);
1742         return handle->fns->sys_acl_get_perm(handle, permset, perm);
1743 }
1744
1745 int smb_vfs_call_sys_acl_free_text(struct vfs_handle_struct *handle,
1746                                    char *text)
1747 {
1748         VFS_FIND(sys_acl_free_text);
1749         return handle->fns->sys_acl_free_text(handle, text);
1750 }
1751
1752 int smb_vfs_call_sys_acl_free_acl(struct vfs_handle_struct *handle,
1753                                   SMB_ACL_T posix_acl)
1754 {
1755         VFS_FIND(sys_acl_free_acl);
1756         return handle->fns->sys_acl_free_acl(handle, posix_acl);
1757 }
1758
1759 int smb_vfs_call_sys_acl_free_qualifier(struct vfs_handle_struct *handle,
1760                                         void *qualifier, SMB_ACL_TAG_T tagtype)
1761 {
1762         VFS_FIND(sys_acl_free_qualifier);
1763         return handle->fns->sys_acl_free_qualifier(handle, qualifier, tagtype);
1764 }
1765
1766 ssize_t smb_vfs_call_getxattr(struct vfs_handle_struct *handle,
1767                               const char *path, const char *name, void *value,
1768                               size_t size)
1769 {
1770         VFS_FIND(getxattr);
1771         return handle->fns->getxattr(handle, path, name, value, size);
1772 }
1773
1774 ssize_t smb_vfs_call_lgetxattr(struct vfs_handle_struct *handle,
1775                                const char *path, const char *name, void *value,
1776                                size_t size)
1777 {
1778         VFS_FIND(lgetxattr);
1779         return handle->fns->lgetxattr(handle, path, name, value, size);
1780 }
1781
1782 ssize_t smb_vfs_call_fgetxattr(struct vfs_handle_struct *handle,
1783                                struct files_struct *fsp, const char *name,
1784                                void *value, size_t size)
1785 {
1786         VFS_FIND(fgetxattr);
1787         return handle->fns->fgetxattr(handle, fsp, name, value, size);
1788 }
1789
1790 ssize_t smb_vfs_call_listxattr(struct vfs_handle_struct *handle,
1791                                const char *path, char *list, size_t size)
1792 {
1793         VFS_FIND(listxattr);
1794         return handle->fns->listxattr(handle, path, list, size);
1795 }
1796
1797 ssize_t smb_vfs_call_llistxattr(struct vfs_handle_struct *handle,
1798                                 const char *path, char *list, size_t size)
1799 {
1800         VFS_FIND(llistxattr);
1801         return handle->fns->llistxattr(handle, path, list, size);
1802 }
1803
1804 ssize_t smb_vfs_call_flistxattr(struct vfs_handle_struct *handle,
1805                                 struct files_struct *fsp, char *list,
1806                                 size_t size)
1807 {
1808         VFS_FIND(flistxattr);
1809         return handle->fns->flistxattr(handle, fsp, list, size);
1810 }
1811
1812 int smb_vfs_call_removexattr(struct vfs_handle_struct *handle,
1813                              const char *path, const char *name)
1814 {
1815         VFS_FIND(removexattr);
1816         return handle->fns->removexattr(handle, path, name);
1817 }
1818
1819 int smb_vfs_call_lremovexattr(struct vfs_handle_struct *handle,
1820                               const char *path, const char *name)
1821 {
1822         VFS_FIND(lremovexattr);
1823         return handle->fns->lremovexattr(handle, path, name);
1824 }
1825
1826 int smb_vfs_call_fremovexattr(struct vfs_handle_struct *handle,
1827                               struct files_struct *fsp, const char *name)
1828 {
1829         VFS_FIND(fremovexattr);
1830         return handle->fns->fremovexattr(handle, fsp, name);
1831 }
1832
1833 int smb_vfs_call_setxattr(struct vfs_handle_struct *handle, const char *path,
1834                           const char *name, const void *value, size_t size,
1835                           int flags)
1836 {
1837         VFS_FIND(setxattr);
1838         return handle->fns->setxattr(handle, path, name, value, size, flags);
1839 }
1840
1841 int smb_vfs_call_lsetxattr(struct vfs_handle_struct *handle, const char *path,
1842                            const char *name, const void *value, size_t size,
1843                            int flags)
1844 {
1845         VFS_FIND(lsetxattr);
1846         return handle->fns->lsetxattr(handle, path, name, value, size, flags);
1847 }
1848
1849 int smb_vfs_call_fsetxattr(struct vfs_handle_struct *handle,
1850                            struct files_struct *fsp, const char *name,
1851                            const void *value, size_t size, int flags)
1852 {
1853         VFS_FIND(fsetxattr);
1854         return handle->fns->fsetxattr(handle, fsp, name, value, size, flags);
1855 }
1856
1857 int smb_vfs_call_aio_read(struct vfs_handle_struct *handle,
1858                           struct files_struct *fsp, SMB_STRUCT_AIOCB *aiocb)
1859 {
1860         VFS_FIND(aio_read);
1861         return handle->fns->aio_read(handle, fsp, aiocb);
1862 }
1863
1864 int smb_vfs_call_aio_write(struct vfs_handle_struct *handle,
1865                            struct files_struct *fsp, SMB_STRUCT_AIOCB *aiocb)
1866 {
1867         VFS_FIND(aio_write);
1868         return handle->fns->aio_write(handle, fsp, aiocb);
1869 }
1870
1871 ssize_t smb_vfs_call_aio_return_fn(struct vfs_handle_struct *handle,
1872                                    struct files_struct *fsp,
1873                                    SMB_STRUCT_AIOCB *aiocb)
1874 {
1875         VFS_FIND(aio_return_fn);
1876         return handle->fns->aio_return_fn(handle, fsp, aiocb);
1877 }
1878
1879 int smb_vfs_call_aio_cancel(struct vfs_handle_struct *handle,
1880                             struct files_struct *fsp, SMB_STRUCT_AIOCB *aiocb)
1881 {
1882         VFS_FIND(aio_cancel);
1883         return handle->fns->aio_cancel(handle, fsp, aiocb);
1884 }
1885
1886 int smb_vfs_call_aio_error_fn(struct vfs_handle_struct *handle,
1887                               struct files_struct *fsp,
1888                               SMB_STRUCT_AIOCB *aiocb)
1889 {
1890         VFS_FIND(aio_error_fn);
1891         return handle->fns->aio_error_fn(handle, fsp, aiocb);
1892 }
1893
1894 int smb_vfs_call_aio_fsync(struct vfs_handle_struct *handle,
1895                            struct files_struct *fsp, int op,
1896                            SMB_STRUCT_AIOCB *aiocb)
1897 {
1898         VFS_FIND(aio_fsync);
1899         return handle->fns->aio_fsync(handle, fsp, op, aiocb);
1900 }
1901
1902 int smb_vfs_call_aio_suspend(struct vfs_handle_struct *handle,
1903                              struct files_struct *fsp,
1904                              const SMB_STRUCT_AIOCB * const aiocb[], int n,
1905                              const struct timespec *timeout)
1906 {
1907         VFS_FIND(aio_suspend);
1908         return handle->fns->aio_suspend(handle, fsp, aiocb, n, timeout);
1909 }
1910
1911 bool smb_vfs_call_aio_force(struct vfs_handle_struct *handle,
1912                             struct files_struct *fsp)
1913 {
1914         VFS_FIND(aio_force);
1915         return handle->fns->aio_force(handle, fsp);
1916 }
1917
1918 bool smb_vfs_call_is_offline(struct vfs_handle_struct *handle,
1919                              const char *path, SMB_STRUCT_STAT *sbuf)
1920 {
1921         VFS_FIND(is_offline);
1922         return handle->fns->is_offline(handle, path, sbuf);
1923 }
1924
1925 int smb_vfs_call_set_offline(struct vfs_handle_struct *handle,
1926                              const char *path)
1927 {
1928         VFS_FIND(set_offline);
1929         return handle->fns->set_offline(handle, path);
1930 }