s3:configure: fix a comment.
[Samba.git] / source3 / modules / vfs_recycle.c
blob626147ca83a6aceb19f3dfd5ba39714a3494e480
1 /*
2 * Recycle bin VFS module for Samba.
4 * Copyright (C) 2001, Brandon Stone, Amherst College, <bbstone@amherst.edu>.
5 * Copyright (C) 2002, Jeremy Allison - modified to make a VFS module.
6 * Copyright (C) 2002, Alexander Bokovoy - cascaded VFS adoption,
7 * Copyright (C) 2002, Juergen Hasch - added some options.
8 * Copyright (C) 2002, Simo Sorce
9 * Copyright (C) 2002, Stefan (metze) Metzmacher
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 3 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, see <http://www.gnu.org/licenses/>.
25 #include "includes.h"
26 #include "../librpc/gen_ndr/ndr_netlogon.h"
28 #define ALLOC_CHECK(ptr, label) do { if ((ptr) == NULL) { DEBUG(0, ("recycle.bin: out of memory!\n")); errno = ENOMEM; goto label; } } while(0)
30 static int vfs_recycle_debug_level = DBGC_VFS;
32 #undef DBGC_CLASS
33 #define DBGC_CLASS vfs_recycle_debug_level
35 static int recycle_connect(vfs_handle_struct *handle, const char *service, const char *user);
36 static void recycle_disconnect(vfs_handle_struct *handle);
37 static int recycle_unlink(vfs_handle_struct *handle,
38 const struct smb_filename *smb_fname);
40 static int recycle_connect(vfs_handle_struct *handle, const char *service, const char *user)
42 int ret = SMB_VFS_NEXT_CONNECT(handle, service, user);
44 if (ret < 0) {
45 return ret;
48 DEBUG(10,("recycle_connect() connect to service[%s] as user[%s].\n",
49 service,user));
51 return 0;
54 static void recycle_disconnect(vfs_handle_struct *handle)
56 DEBUG(10,("recycle_disconnect() connect to service[%s].\n",
57 lp_servicename(SNUM(handle->conn))));
59 SMB_VFS_NEXT_DISCONNECT(handle);
62 static const char *recycle_repository(vfs_handle_struct *handle)
64 const char *tmp_str = NULL;
66 tmp_str = lp_parm_const_string(SNUM(handle->conn), "recycle", "repository",".recycle");
68 DEBUG(10, ("recycle: repository = %s\n", tmp_str));
70 return tmp_str;
73 static bool recycle_keep_dir_tree(vfs_handle_struct *handle)
75 bool ret;
77 ret = lp_parm_bool(SNUM(handle->conn), "recycle", "keeptree", False);
79 DEBUG(10, ("recycle_bin: keeptree = %s\n", ret?"True":"False"));
81 return ret;
84 static bool recycle_versions(vfs_handle_struct *handle)
86 bool ret;
88 ret = lp_parm_bool(SNUM(handle->conn), "recycle", "versions", False);
90 DEBUG(10, ("recycle: versions = %s\n", ret?"True":"False"));
92 return ret;
95 static bool recycle_touch(vfs_handle_struct *handle)
97 bool ret;
99 ret = lp_parm_bool(SNUM(handle->conn), "recycle", "touch", False);
101 DEBUG(10, ("recycle: touch = %s\n", ret?"True":"False"));
103 return ret;
106 static bool recycle_touch_mtime(vfs_handle_struct *handle)
108 bool ret;
110 ret = lp_parm_bool(SNUM(handle->conn), "recycle", "touch_mtime", False);
112 DEBUG(10, ("recycle: touch_mtime = %s\n", ret?"True":"False"));
114 return ret;
117 static const char **recycle_exclude(vfs_handle_struct *handle)
119 const char **tmp_lp;
121 tmp_lp = lp_parm_string_list(SNUM(handle->conn), "recycle", "exclude", NULL);
123 DEBUG(10, ("recycle: exclude = %s ...\n", tmp_lp?*tmp_lp:""));
125 return tmp_lp;
128 static const char **recycle_exclude_dir(vfs_handle_struct *handle)
130 const char **tmp_lp;
132 tmp_lp = lp_parm_string_list(SNUM(handle->conn), "recycle", "exclude_dir", NULL);
134 DEBUG(10, ("recycle: exclude_dir = %s ...\n", tmp_lp?*tmp_lp:""));
136 return tmp_lp;
139 static const char **recycle_noversions(vfs_handle_struct *handle)
141 const char **tmp_lp;
143 tmp_lp = lp_parm_string_list(SNUM(handle->conn), "recycle", "noversions", NULL);
145 DEBUG(10, ("recycle: noversions = %s\n", tmp_lp?*tmp_lp:""));
147 return tmp_lp;
150 static SMB_OFF_T recycle_maxsize(vfs_handle_struct *handle)
152 SMB_OFF_T maxsize;
154 maxsize = conv_str_size(lp_parm_const_string(SNUM(handle->conn),
155 "recycle", "maxsize", NULL));
157 DEBUG(10, ("recycle: maxsize = %lu\n", (long unsigned int)maxsize));
159 return maxsize;
162 static SMB_OFF_T recycle_minsize(vfs_handle_struct *handle)
164 SMB_OFF_T minsize;
166 minsize = conv_str_size(lp_parm_const_string(SNUM(handle->conn),
167 "recycle", "minsize", NULL));
169 DEBUG(10, ("recycle: minsize = %lu\n", (long unsigned int)minsize));
171 return minsize;
174 static mode_t recycle_directory_mode(vfs_handle_struct *handle)
176 int dirmode;
177 const char *buff;
179 buff = lp_parm_const_string(SNUM(handle->conn), "recycle", "directory_mode", NULL);
181 if (buff != NULL ) {
182 sscanf(buff, "%o", &dirmode);
183 } else {
184 dirmode=S_IRUSR | S_IWUSR | S_IXUSR;
187 DEBUG(10, ("recycle: directory_mode = %o\n", dirmode));
188 return (mode_t)dirmode;
191 static mode_t recycle_subdir_mode(vfs_handle_struct *handle)
193 int dirmode;
194 const char *buff;
196 buff = lp_parm_const_string(SNUM(handle->conn), "recycle", "subdir_mode", NULL);
198 if (buff != NULL ) {
199 sscanf(buff, "%o", &dirmode);
200 } else {
201 dirmode=recycle_directory_mode(handle);
204 DEBUG(10, ("recycle: subdir_mode = %o\n", dirmode));
205 return (mode_t)dirmode;
208 static bool recycle_directory_exist(vfs_handle_struct *handle, const char *dname)
210 SMB_STRUCT_STAT st;
212 if (vfs_stat_smb_fname(handle->conn, dname, &st) == 0) {
213 if (S_ISDIR(st.st_ex_mode)) {
214 return True;
218 return False;
221 static bool recycle_file_exist(vfs_handle_struct *handle,
222 const struct smb_filename *smb_fname)
224 struct smb_filename *smb_fname_tmp = NULL;
225 NTSTATUS status;
226 bool ret = false;
228 status = copy_smb_filename(talloc_tos(), smb_fname, &smb_fname_tmp);
229 if (!NT_STATUS_IS_OK(status)) {
230 return false;
233 if (SMB_VFS_STAT(handle->conn, smb_fname_tmp) == 0) {
234 if (S_ISREG(smb_fname_tmp->st.st_ex_mode)) {
235 ret = true;
239 TALLOC_FREE(smb_fname_tmp);
240 return ret;
244 * Return file size
245 * @param conn connection
246 * @param fname file name
247 * @return size in bytes
249 static SMB_OFF_T recycle_get_file_size(vfs_handle_struct *handle,
250 const struct smb_filename *smb_fname)
252 struct smb_filename *smb_fname_tmp = NULL;
253 NTSTATUS status;
254 SMB_OFF_T size;
256 status = copy_smb_filename(talloc_tos(), smb_fname, &smb_fname_tmp);
257 if (!NT_STATUS_IS_OK(status)) {
258 size = (SMB_OFF_T)0;
259 goto out;
262 if (SMB_VFS_STAT(handle->conn, smb_fname_tmp) != 0) {
263 DEBUG(0,("recycle: stat for %s returned %s\n",
264 smb_fname_str_dbg(smb_fname_tmp), strerror(errno)));
265 size = (SMB_OFF_T)0;
266 goto out;
269 size = smb_fname_tmp->st.st_ex_size;
270 out:
271 TALLOC_FREE(smb_fname_tmp);
272 return size;
276 * Create directory tree
277 * @param conn connection
278 * @param dname Directory tree to be created
279 * @return Returns True for success
281 static bool recycle_create_dir(vfs_handle_struct *handle, const char *dname)
283 size_t len;
284 mode_t mode;
285 char *new_dir = NULL;
286 char *tmp_str = NULL;
287 char *token;
288 char *tok_str;
289 bool ret = False;
290 char *saveptr;
292 mode = recycle_directory_mode(handle);
294 tmp_str = SMB_STRDUP(dname);
295 ALLOC_CHECK(tmp_str, done);
296 tok_str = tmp_str;
298 len = strlen(dname)+1;
299 new_dir = (char *)SMB_MALLOC(len + 1);
300 ALLOC_CHECK(new_dir, done);
301 *new_dir = '\0';
302 if (dname[0] == '/') {
303 /* Absolute path. */
304 safe_strcat(new_dir,"/",len);
307 /* Create directory tree if neccessary */
308 for(token = strtok_r(tok_str, "/", &saveptr); token;
309 token = strtok_r(NULL, "/", &saveptr)) {
310 safe_strcat(new_dir, token, len);
311 if (recycle_directory_exist(handle, new_dir))
312 DEBUG(10, ("recycle: dir %s already exists\n", new_dir));
313 else {
314 DEBUG(5, ("recycle: creating new dir %s\n", new_dir));
315 if (SMB_VFS_NEXT_MKDIR(handle, new_dir, mode) != 0) {
316 DEBUG(1,("recycle: mkdir failed for %s with error: %s\n", new_dir, strerror(errno)));
317 ret = False;
318 goto done;
321 safe_strcat(new_dir, "/", len);
322 mode = recycle_subdir_mode(handle);
325 ret = True;
326 done:
327 SAFE_FREE(tmp_str);
328 SAFE_FREE(new_dir);
329 return ret;
333 * Check if any of the components of "exclude_list" are contained in path.
334 * Return True if found
337 static bool matchdirparam(const char **dir_exclude_list, char *path)
339 char *startp = NULL, *endp = NULL;
341 if (dir_exclude_list == NULL || dir_exclude_list[0] == NULL ||
342 *dir_exclude_list[0] == '\0' || path == NULL || *path == '\0') {
343 return False;
347 * Walk the components of path, looking for matches with the
348 * exclude list on each component.
351 for (startp = path; startp; startp = endp) {
352 int i;
354 while (*startp == '/') {
355 startp++;
357 endp = strchr(startp, '/');
358 if (endp) {
359 *endp = '\0';
362 for(i=0; dir_exclude_list[i] ; i++) {
363 if(unix_wild_match(dir_exclude_list[i], startp)) {
364 /* Repair path. */
365 if (endp) {
366 *endp = '/';
368 return True;
372 /* Repair path. */
373 if (endp) {
374 *endp = '/';
378 return False;
382 * Check if needle is contained in haystack, * and ? patterns are resolved
383 * @param haystack list of parameters separated by delimimiter character
384 * @param needle string to be matched exectly to haystack including pattern matching
385 * @return True if found
387 static bool matchparam(const char **haystack_list, const char *needle)
389 int i;
391 if (haystack_list == NULL || haystack_list[0] == NULL ||
392 *haystack_list[0] == '\0' || needle == NULL || *needle == '\0') {
393 return False;
396 for(i=0; haystack_list[i] ; i++) {
397 if(unix_wild_match(haystack_list[i], needle)) {
398 return True;
402 return False;
406 * Touch access or modify date
408 static void recycle_do_touch(vfs_handle_struct *handle,
409 const struct smb_filename *smb_fname,
410 bool touch_mtime)
412 struct smb_filename *smb_fname_tmp = NULL;
413 struct smb_file_time ft;
414 NTSTATUS status;
415 int ret, err;
417 ZERO_STRUCT(ft);
419 status = copy_smb_filename(talloc_tos(), smb_fname, &smb_fname_tmp);
420 if (!NT_STATUS_IS_OK(status)) {
421 return;
424 if (SMB_VFS_STAT(handle->conn, smb_fname_tmp) != 0) {
425 DEBUG(0,("recycle: stat for %s returned %s\n",
426 smb_fname_str_dbg(smb_fname_tmp), strerror(errno)));
427 goto out;
429 /* atime */
430 ft.atime = timespec_current();
431 /* mtime */
432 ft.mtime = touch_mtime ? ft.atime : smb_fname_tmp->st.st_ex_mtime;
434 become_root();
435 ret = SMB_VFS_NEXT_NTIMES(handle, smb_fname_tmp, &ft);
436 err = errno;
437 unbecome_root();
438 if (ret == -1 ) {
439 DEBUG(0, ("recycle: touching %s failed, reason = %s\n",
440 smb_fname_str_dbg(smb_fname_tmp), strerror(err)));
442 out:
443 TALLOC_FREE(smb_fname_tmp);
447 * Check if file should be recycled
449 static int recycle_unlink(vfs_handle_struct *handle,
450 const struct smb_filename *smb_fname)
452 connection_struct *conn = handle->conn;
453 char *path_name = NULL;
454 char *temp_name = NULL;
455 char *final_name = NULL;
456 struct smb_filename *smb_fname_final = NULL;
457 const char *base;
458 char *repository = NULL;
459 int i = 1;
460 SMB_OFF_T maxsize, minsize;
461 SMB_OFF_T file_size; /* space_avail; */
462 bool exist;
463 NTSTATUS status;
464 int rc = -1;
466 repository = talloc_sub_advanced(NULL, lp_servicename(SNUM(conn)),
467 conn->session_info->unix_name,
468 conn->connectpath,
469 conn->session_info->utok.gid,
470 conn->session_info->sanitized_username,
471 conn->session_info->info3->base.domain.string,
472 recycle_repository(handle));
473 ALLOC_CHECK(repository, done);
474 /* shouldn't we allow absolute path names here? --metze */
475 /* Yes :-). JRA. */
476 trim_char(repository, '\0', '/');
478 if(!repository || *(repository) == '\0') {
479 DEBUG(3, ("recycle: repository path not set, purging %s...\n",
480 smb_fname_str_dbg(smb_fname)));
481 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
482 goto done;
485 /* we don't recycle the recycle bin... */
486 if (strncmp(smb_fname->base_name, repository,
487 strlen(repository)) == 0) {
488 DEBUG(3, ("recycle: File is within recycling bin, unlinking ...\n"));
489 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
490 goto done;
493 file_size = recycle_get_file_size(handle, smb_fname);
494 /* it is wrong to purge filenames only because they are empty imho
495 * --- simo
497 if(fsize == 0) {
498 DEBUG(3, ("recycle: File %s is empty, purging...\n", file_name));
499 rc = SMB_VFS_NEXT_UNLINK(handle,file_name);
500 goto done;
504 /* FIXME: this is wrong, we should check the whole size of the recycle bin is
505 * not greater then maxsize, not the size of the single file, also it is better
506 * to remove older files
508 maxsize = recycle_maxsize(handle);
509 if(maxsize > 0 && file_size > maxsize) {
510 DEBUG(3, ("recycle: File %s exceeds maximum recycle size, "
511 "purging... \n", smb_fname_str_dbg(smb_fname)));
512 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
513 goto done;
515 minsize = recycle_minsize(handle);
516 if(minsize > 0 && file_size < minsize) {
517 DEBUG(3, ("recycle: File %s lowers minimum recycle size, "
518 "purging... \n", smb_fname_str_dbg(smb_fname)));
519 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
520 goto done;
523 /* FIXME: this is wrong: moving files with rename does not change the disk space
524 * allocation
526 space_avail = SMB_VFS_NEXT_DISK_FREE(handle, ".", True, &bsize, &dfree, &dsize) * 1024L;
527 DEBUG(5, ("space_avail = %Lu, file_size = %Lu\n", space_avail, file_size));
528 if(space_avail < file_size) {
529 DEBUG(3, ("recycle: Not enough diskspace, purging file %s\n", file_name));
530 rc = SMB_VFS_NEXT_UNLINK(handle, file_name);
531 goto done;
535 /* extract filename and path */
536 base = strrchr(smb_fname->base_name, '/');
537 if (base == NULL) {
538 base = smb_fname->base_name;
539 path_name = SMB_STRDUP("/");
540 ALLOC_CHECK(path_name, done);
542 else {
543 path_name = SMB_STRDUP(smb_fname->base_name);
544 ALLOC_CHECK(path_name, done);
545 path_name[base - smb_fname->base_name] = '\0';
546 base++;
549 /* original filename with path */
550 DEBUG(10, ("recycle: fname = %s\n", smb_fname_str_dbg(smb_fname)));
551 /* original path */
552 DEBUG(10, ("recycle: fpath = %s\n", path_name));
553 /* filename without path */
554 DEBUG(10, ("recycle: base = %s\n", base));
556 if (matchparam(recycle_exclude(handle), base)) {
557 DEBUG(3, ("recycle: file %s is excluded \n", base));
558 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
559 goto done;
562 if (matchdirparam(recycle_exclude_dir(handle), path_name)) {
563 DEBUG(3, ("recycle: directory %s is excluded \n", path_name));
564 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
565 goto done;
568 if (recycle_keep_dir_tree(handle) == True) {
569 if (asprintf(&temp_name, "%s/%s", repository, path_name) == -1) {
570 ALLOC_CHECK(temp_name, done);
572 } else {
573 temp_name = SMB_STRDUP(repository);
575 ALLOC_CHECK(temp_name, done);
577 exist = recycle_directory_exist(handle, temp_name);
578 if (exist) {
579 DEBUG(10, ("recycle: Directory already exists\n"));
580 } else {
581 DEBUG(10, ("recycle: Creating directory %s\n", temp_name));
582 if (recycle_create_dir(handle, temp_name) == False) {
583 DEBUG(3, ("recycle: Could not create directory, "
584 "purging %s...\n",
585 smb_fname_str_dbg(smb_fname)));
586 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
587 goto done;
591 if (asprintf(&final_name, "%s/%s", temp_name, base) == -1) {
592 ALLOC_CHECK(final_name, done);
595 /* Create smb_fname with final base name and orig stream name. */
596 status = create_synthetic_smb_fname(talloc_tos(), final_name,
597 smb_fname->stream_name, NULL,
598 &smb_fname_final);
599 if (!NT_STATUS_IS_OK(status)) {
600 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
601 goto done;
604 /* new filename with path */
605 DEBUG(10, ("recycle: recycled file name: %s\n",
606 smb_fname_str_dbg(smb_fname_final)));
608 /* check if we should delete file from recycle bin */
609 if (recycle_file_exist(handle, smb_fname_final)) {
610 if (recycle_versions(handle) == False || matchparam(recycle_noversions(handle), base) == True) {
611 DEBUG(3, ("recycle: Removing old file %s from recycle "
612 "bin\n", smb_fname_str_dbg(smb_fname_final)));
613 if (SMB_VFS_NEXT_UNLINK(handle,
614 smb_fname_final) != 0) {
615 DEBUG(1, ("recycle: Error deleting old file: %s\n", strerror(errno)));
620 /* rename file we move to recycle bin */
621 i = 1;
622 while (recycle_file_exist(handle, smb_fname_final)) {
623 SAFE_FREE(final_name);
624 if (asprintf(&final_name, "%s/Copy #%d of %s", temp_name, i++, base) == -1) {
625 ALLOC_CHECK(final_name, done);
627 TALLOC_FREE(smb_fname_final->base_name);
628 smb_fname_final->base_name = talloc_strdup(smb_fname_final,
629 final_name);
630 if (smb_fname_final->base_name == NULL) {
631 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
632 goto done;
636 DEBUG(10, ("recycle: Moving %s to %s\n", smb_fname_str_dbg(smb_fname),
637 smb_fname_str_dbg(smb_fname_final)));
638 rc = SMB_VFS_NEXT_RENAME(handle, smb_fname, smb_fname_final);
639 if (rc != 0) {
640 DEBUG(3, ("recycle: Move error %d (%s), purging file %s "
641 "(%s)\n", errno, strerror(errno),
642 smb_fname_str_dbg(smb_fname),
643 smb_fname_str_dbg(smb_fname_final)));
644 rc = SMB_VFS_NEXT_UNLINK(handle, smb_fname);
645 goto done;
648 /* touch access date of moved file */
649 if (recycle_touch(handle) == True || recycle_touch_mtime(handle))
650 recycle_do_touch(handle, smb_fname_final,
651 recycle_touch_mtime(handle));
653 done:
654 SAFE_FREE(path_name);
655 SAFE_FREE(temp_name);
656 SAFE_FREE(final_name);
657 TALLOC_FREE(smb_fname_final);
658 TALLOC_FREE(repository);
659 return rc;
662 static struct vfs_fn_pointers vfs_recycle_fns = {
663 .connect_fn = recycle_connect,
664 .disconnect = recycle_disconnect,
665 .unlink = recycle_unlink
668 NTSTATUS vfs_recycle_init(void);
669 NTSTATUS vfs_recycle_init(void)
671 NTSTATUS ret = smb_register_vfs(SMB_VFS_INTERFACE_VERSION, "recycle",
672 &vfs_recycle_fns);
674 if (!NT_STATUS_IS_OK(ret))
675 return ret;
677 vfs_recycle_debug_level = debug_add_class("recycle");
678 if (vfs_recycle_debug_level == -1) {
679 vfs_recycle_debug_level = DBGC_VFS;
680 DEBUG(0, ("vfs_recycle: Couldn't register custom debugging class!\n"));
681 } else {
682 DEBUG(10, ("vfs_recycle: Debug class number of 'recycle': %d\n", vfs_recycle_debug_level));
685 return ret;