2 Unix SMB/CIFS implementation.
3 Files[] structure handling
4 Copyright (C) Andrew Tridgell 1998
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "smbd/smbd.h"
22 #include "smbd/globals.h"
23 #include "libcli/security/security.h"
25 #include <ccan/hash/hash.h>
26 #include "lib/util/bitmap.h"
28 #define FILE_HANDLE_OFFSET 0x1000
31 * create new fsp to be used for file_new or a durable handle reconnect
33 NTSTATUS
fsp_new(struct connection_struct
*conn
, TALLOC_CTX
*mem_ctx
,
34 files_struct
**result
)
36 NTSTATUS status
= NT_STATUS_NO_MEMORY
;
37 files_struct
*fsp
= NULL
;
38 struct smbd_server_connection
*sconn
= conn
->sconn
;
40 fsp
= talloc_zero(mem_ctx
, struct files_struct
);
46 * This can't be a child of fsp because the file_handle can be ref'd
47 * when doing a dos/fcb open, which will then share the file_handle
48 * across multiple fsps.
50 fsp
->fh
= talloc_zero(mem_ctx
, struct fd_handle
);
51 if (fsp
->fh
== NULL
) {
55 fsp
->fh
->ref_count
= 1;
58 fsp
->fnum
= FNUM_FIELD_INVALID
;
61 DLIST_ADD(sconn
->files
, fsp
);
62 sconn
->num_files
+= 1;
64 conn
->num_files_open
++;
78 /****************************************************************************
79 Find first available file slot.
80 ****************************************************************************/
82 NTSTATUS
file_new(struct smb_request
*req
, connection_struct
*conn
,
83 files_struct
**result
)
85 struct smbd_server_connection
*sconn
= conn
->sconn
;
89 status
= fsp_new(conn
, conn
, &fsp
);
90 if (!NT_STATUS_IS_OK(status
)) {
94 GetTimeOfDay(&fsp
->open_time
);
97 struct smbXsrv_open
*op
= NULL
;
98 NTTIME now
= timeval_to_nttime(&fsp
->open_time
);
100 status
= smbXsrv_open_create(sconn
->conn
,
103 if (!NT_STATUS_IS_OK(status
)) {
104 file_free(NULL
, fsp
);
109 fsp
->fnum
= op
->local_id
;
110 fsp
->fh
->gen_id
= smbXsrv_open_hash(op
);
114 * Create an smb_filename with "" for the base_name. There are very
115 * few NULL checks, so make sure it's initialized with something. to
116 * be safe until an audit can be done.
118 fsp
->fsp_name
= synthetic_smb_fname(fsp
, "", NULL
, NULL
);
119 if (fsp
->fsp_name
== NULL
) {
120 file_free(NULL
, fsp
);
121 return NT_STATUS_NO_MEMORY
;
124 DEBUG(5,("allocated file structure %s (%u used)\n",
125 fsp_fnum_dbg(fsp
), (unsigned int)sconn
->num_files
));
129 req
->chain_fsp
= fsp
;
132 /* A new fsp invalidates the positive and
133 negative fsp_fi_cache as the new fsp is pushed
134 at the start of the list and we search from
135 a cache hit to the *end* of the list. */
137 ZERO_STRUCT(sconn
->fsp_fi_cache
);
143 /****************************************************************************
144 Close all open files for a connection.
145 ****************************************************************************/
147 void file_close_conn(connection_struct
*conn
)
149 files_struct
*fsp
, *next
;
151 for (fsp
=conn
->sconn
->files
; fsp
; fsp
=next
) {
153 if (fsp
->conn
!= conn
) {
156 if (fsp
->op
!= NULL
&& fsp
->op
->global
->durable
) {
158 * A tree disconnect closes a durable handle
160 fsp
->op
->global
->durable
= false;
162 close_file(NULL
, fsp
, SHUTDOWN_CLOSE
);
166 /****************************************************************************
167 Close all open files for a pid and a vuid.
168 ****************************************************************************/
170 void file_close_pid(struct smbd_server_connection
*sconn
, uint16 smbpid
,
173 files_struct
*fsp
, *next
;
175 for (fsp
=sconn
->files
;fsp
;fsp
=next
) {
177 if ((fsp
->file_pid
== smbpid
) && (fsp
->vuid
== vuid
)) {
178 close_file(NULL
, fsp
, SHUTDOWN_CLOSE
);
183 /****************************************************************************
184 Initialise file structures.
185 ****************************************************************************/
187 static int files_max_open_fds
;
189 bool file_init_global(void)
191 int request_max
= lp_max_open_files();
195 if (files_max_open_fds
!= 0) {
200 * Set the max_open files to be the requested
201 * max plus a fudgefactor to allow for the extra
202 * fd's we need such as log files etc...
204 real_lim
= set_maxfiles(request_max
+ MAX_OPEN_FUDGEFACTOR
);
206 real_max
= real_lim
- MAX_OPEN_FUDGEFACTOR
;
208 if (real_max
+ FILE_HANDLE_OFFSET
+ MAX_OPEN_PIPES
> 65536) {
209 real_max
= 65536 - FILE_HANDLE_OFFSET
- MAX_OPEN_PIPES
;
212 if (real_max
!= request_max
) {
213 DEBUG(1, ("file_init_global: Information only: requested %d "
214 "open files, %d are available.\n",
215 request_max
, real_max
));
218 SMB_ASSERT(real_max
> 100);
220 files_max_open_fds
= real_max
;
224 bool file_init(struct smbd_server_connection
*sconn
)
228 ok
= file_init_global();
233 sconn
->real_max_open_files
= files_max_open_fds
;
238 /****************************************************************************
239 Close files open by a specified vuid.
240 ****************************************************************************/
242 void file_close_user(struct smbd_server_connection
*sconn
, uint64_t vuid
)
244 files_struct
*fsp
, *next
;
246 for (fsp
=sconn
->files
; fsp
; fsp
=next
) {
248 if (fsp
->vuid
== vuid
) {
249 close_file(NULL
, fsp
, SHUTDOWN_CLOSE
);
255 * Walk the files table until "fn" returns non-NULL
258 struct files_struct
*files_forall(
259 struct smbd_server_connection
*sconn
,
260 struct files_struct
*(*fn
)(struct files_struct
*fsp
,
264 struct files_struct
*fsp
, *next
;
266 for (fsp
= sconn
->files
; fsp
; fsp
= next
) {
267 struct files_struct
*ret
;
269 ret
= fn(fsp
, private_data
);
277 /****************************************************************************
278 Find a fsp given a file descriptor.
279 ****************************************************************************/
281 files_struct
*file_find_fd(struct smbd_server_connection
*sconn
, int fd
)
286 for (fsp
=sconn
->files
; fsp
; fsp
=fsp
->next
,count
++) {
287 if (fsp
->fh
->fd
== fd
) {
289 DLIST_PROMOTE(sconn
->files
, fsp
);
298 /****************************************************************************
299 Find a fsp given a device, inode and file_id.
300 ****************************************************************************/
302 files_struct
*file_find_dif(struct smbd_server_connection
*sconn
,
303 struct file_id id
, unsigned long gen_id
)
312 for (fsp
=sconn
->files
; fsp
; fsp
=fsp
->next
,count
++) {
313 /* We can have a fsp->fh->fd == -1 here as it could be a stat open. */
314 if (file_id_equal(&fsp
->file_id
, &id
) &&
315 fsp
->fh
->gen_id
== gen_id
) {
317 DLIST_PROMOTE(sconn
->files
, fsp
);
319 /* Paranoia check. */
320 if ((fsp
->fh
->fd
== -1) &&
321 (fsp
->oplock_type
!= NO_OPLOCK
) &&
322 (fsp
->oplock_type
!= FAKE_LEVEL_II_OPLOCK
)) {
323 DEBUG(0,("file_find_dif: file %s file_id = "
324 "%s, gen = %u oplock_type = %u is a "
325 "stat open with oplock type !\n",
327 file_id_string_tos(&fsp
->file_id
),
328 (unsigned int)fsp
->fh
->gen_id
,
329 (unsigned int)fsp
->oplock_type
));
330 smb_panic("file_find_dif");
339 /****************************************************************************
340 Find the first fsp given a device and inode.
341 We use a singleton cache here to speed up searching from getfilepathinfo
343 ****************************************************************************/
345 files_struct
*file_find_di_first(struct smbd_server_connection
*sconn
,
350 if (file_id_equal(&sconn
->fsp_fi_cache
.id
, &id
)) {
351 /* Positive or negative cache hit. */
352 return sconn
->fsp_fi_cache
.fsp
;
355 sconn
->fsp_fi_cache
.id
= id
;
357 for (fsp
=sconn
->files
;fsp
;fsp
=fsp
->next
) {
358 if (file_id_equal(&fsp
->file_id
, &id
)) {
359 /* Setup positive cache. */
360 sconn
->fsp_fi_cache
.fsp
= fsp
;
365 /* Setup negative cache. */
366 sconn
->fsp_fi_cache
.fsp
= NULL
;
370 /****************************************************************************
371 Find the next fsp having the same device and inode.
372 ****************************************************************************/
374 files_struct
*file_find_di_next(files_struct
*start_fsp
)
378 for (fsp
= start_fsp
->next
;fsp
;fsp
=fsp
->next
) {
379 if (file_id_equal(&fsp
->file_id
, &start_fsp
->file_id
)) {
387 /****************************************************************************
388 Find any fsp open with a pathname below that of an already open path.
389 ****************************************************************************/
391 bool file_find_subpath(files_struct
*dir_fsp
)
395 char *d_fullname
= NULL
;
397 d_fullname
= talloc_asprintf(talloc_tos(), "%s/%s",
398 dir_fsp
->conn
->connectpath
,
399 dir_fsp
->fsp_name
->base_name
);
405 dlen
= strlen(d_fullname
);
407 for (fsp
=dir_fsp
->conn
->sconn
->files
; fsp
; fsp
=fsp
->next
) {
410 if (fsp
== dir_fsp
) {
414 d1_fullname
= talloc_asprintf(talloc_tos(),
416 fsp
->conn
->connectpath
,
417 fsp
->fsp_name
->base_name
);
420 * If the open file has a path that is a longer
421 * component, then it's a subpath.
423 if (strnequal(d_fullname
, d1_fullname
, dlen
) &&
424 (d1_fullname
[dlen
] == '/')) {
425 TALLOC_FREE(d1_fullname
);
426 TALLOC_FREE(d_fullname
);
429 TALLOC_FREE(d1_fullname
);
432 TALLOC_FREE(d_fullname
);
436 /****************************************************************************
437 Sync open files on a connection.
438 ****************************************************************************/
440 void file_sync_all(connection_struct
*conn
)
442 files_struct
*fsp
, *next
;
444 for (fsp
=conn
->sconn
->files
; fsp
; fsp
=next
) {
446 if ((conn
== fsp
->conn
) && (fsp
->fh
->fd
!= -1)) {
447 sync_file(conn
, fsp
, True
/* write through */);
452 /****************************************************************************
454 ****************************************************************************/
456 void fsp_free(files_struct
*fsp
)
458 struct smbd_server_connection
*sconn
= fsp
->conn
->sconn
;
460 DLIST_REMOVE(sconn
->files
, fsp
);
461 SMB_ASSERT(sconn
->num_files
> 0);
464 TALLOC_FREE(fsp
->fake_file_handle
);
466 if (fsp
->fh
->ref_count
== 1) {
467 TALLOC_FREE(fsp
->fh
);
469 fsp
->fh
->ref_count
--;
472 fsp
->conn
->num_files_open
--;
474 /* this is paranoia, just in case someone tries to reuse the
478 /* fsp->fsp_name is a talloc child and is free'd automatically. */
482 void file_free(struct smb_request
*req
, files_struct
*fsp
)
484 struct smbd_server_connection
*sconn
= fsp
->conn
->sconn
;
485 uint64_t fnum
= fsp
->fnum
;
488 struct notify_context
*notify_ctx
=
489 fsp
->conn
->sconn
->notify_ctx
;
490 notify_remove(notify_ctx
, fsp
);
491 TALLOC_FREE(fsp
->notify
);
494 /* Ensure this event will never fire. */
495 TALLOC_FREE(fsp
->update_write_time_event
);
497 if (fsp
->op
!= NULL
) {
498 fsp
->op
->compat
= NULL
;
500 TALLOC_FREE(fsp
->op
);
502 if ((req
!= NULL
) && (fsp
== req
->chain_fsp
)) {
503 req
->chain_fsp
= NULL
;
507 * Clear all possible chained fsp
508 * pointers in the SMB2 request queue.
510 if (req
!= NULL
&& req
->smb2req
) {
511 remove_smb2_chained_fsp(fsp
);
514 /* Closing a file can invalidate the positive cache. */
515 if (fsp
== sconn
->fsp_fi_cache
.fsp
) {
516 ZERO_STRUCT(sconn
->fsp_fi_cache
);
519 /* Drop all remaining extensions. */
520 vfs_remove_all_fsp_extensions(fsp
);
524 DEBUG(5,("freed files structure %llu (%u used)\n",
525 (unsigned long long)fnum
, (unsigned int)sconn
->num_files
));
528 /****************************************************************************
529 Get an fsp from a packet given a 16 bit fnum.
530 ****************************************************************************/
532 files_struct
*file_fsp(struct smb_request
*req
, uint16 fid
)
534 struct smbXsrv_open
*op
;
541 * We should never get here. req==NULL could in theory
542 * only happen from internal opens with a non-zero
543 * root_dir_fid. Internal opens just don't do that, at
544 * least they are not supposed to do so. And if they
545 * start to do so, they better fake up a smb_request
546 * from which we get the right smbd_server_conn. While
547 * this should never happen, let's return NULL here.
552 if (req
->chain_fsp
!= NULL
) {
553 if (req
->chain_fsp
->deferred_close
) {
556 return req
->chain_fsp
;
559 if (req
->sconn
->conn
== NULL
) {
563 now
= timeval_to_nttime(&req
->request_time
);
565 status
= smb1srv_open_lookup(req
->sconn
->conn
,
567 if (!NT_STATUS_IS_OK(status
)) {
576 if (fsp
->deferred_close
) {
580 req
->chain_fsp
= fsp
;
584 struct files_struct
*file_fsp_get(struct smbd_smb2_request
*smb2req
,
585 uint64_t persistent_id
,
586 uint64_t volatile_id
)
588 struct smbXsrv_open
*op
;
591 struct files_struct
*fsp
;
593 now
= timeval_to_nttime(&smb2req
->request_time
);
595 status
= smb2srv_open_lookup(smb2req
->sconn
->conn
,
596 persistent_id
, volatile_id
,
598 if (!NT_STATUS_IS_OK(status
)) {
607 if (smb2req
->tcon
== NULL
) {
611 if (smb2req
->tcon
->compat
!= fsp
->conn
) {
615 if (smb2req
->session
== NULL
) {
619 if (smb2req
->session
->compat
== NULL
) {
623 if (smb2req
->session
->compat
->vuid
!= fsp
->vuid
) {
627 if (fsp
->deferred_close
) {
634 struct files_struct
*file_fsp_smb2(struct smbd_smb2_request
*smb2req
,
635 uint64_t persistent_id
,
636 uint64_t volatile_id
)
638 struct files_struct
*fsp
;
640 if (smb2req
->compat_chain_fsp
!= NULL
) {
641 if (smb2req
->compat_chain_fsp
->deferred_close
) {
644 return smb2req
->compat_chain_fsp
;
647 fsp
= file_fsp_get(smb2req
, persistent_id
, volatile_id
);
652 smb2req
->compat_chain_fsp
= fsp
;
656 /****************************************************************************
657 Duplicate the file handle part for a DOS or FCB open.
658 ****************************************************************************/
660 NTSTATUS
dup_file_fsp(struct smb_request
*req
, files_struct
*from
,
661 uint32 access_mask
, uint32 share_access
,
662 uint32 create_options
, files_struct
*to
)
664 /* this can never happen for print files */
665 SMB_ASSERT(from
->print_file
== NULL
);
672 to
->file_id
= from
->file_id
;
673 to
->initial_allocation_size
= from
->initial_allocation_size
;
674 to
->file_pid
= from
->file_pid
;
675 to
->vuid
= from
->vuid
;
676 to
->open_time
= from
->open_time
;
677 to
->access_mask
= access_mask
;
678 to
->share_access
= share_access
;
679 to
->oplock_type
= from
->oplock_type
;
680 to
->can_lock
= from
->can_lock
;
681 to
->can_read
= ((access_mask
& FILE_READ_DATA
) != 0);
683 CAN_WRITE(from
->conn
) &&
684 ((access_mask
& (FILE_WRITE_DATA
| FILE_APPEND_DATA
)) != 0);
685 to
->modified
= from
->modified
;
686 to
->is_directory
= from
->is_directory
;
687 to
->aio_write_behind
= from
->aio_write_behind
;
689 return fsp_set_smb_fname(to
, from
->fsp_name
);
693 * Return a jenkins hash of a pathname on a connection.
696 NTSTATUS
file_name_hash(connection_struct
*conn
,
697 const char *name
, uint32_t *p_name_hash
)
699 char *fullpath
= NULL
;
701 /* Set the hash of the full pathname. */
702 fullpath
= talloc_asprintf(talloc_tos(),
707 return NT_STATUS_NO_MEMORY
;
709 *p_name_hash
= hash(fullpath
, talloc_get_size(fullpath
), 0);
711 DEBUG(10,("file_name_hash: %s hash 0x%x\n",
713 (unsigned int)*p_name_hash
));
715 TALLOC_FREE(fullpath
);
720 * The only way that the fsp->fsp_name field should ever be set.
722 NTSTATUS
fsp_set_smb_fname(struct files_struct
*fsp
,
723 const struct smb_filename
*smb_fname_in
)
725 struct smb_filename
*smb_fname_new
;
727 smb_fname_new
= cp_smb_filename(fsp
, smb_fname_in
);
728 if (smb_fname_new
== NULL
) {
729 return NT_STATUS_NO_MEMORY
;
732 TALLOC_FREE(fsp
->fsp_name
);
733 fsp
->fsp_name
= smb_fname_new
;
735 return file_name_hash(fsp
->conn
,
736 smb_fname_str_dbg(fsp
->fsp_name
),