2 * Main routine for finding files on a file system.
3 * The heart of the work is done in find_one.c
8 Copyright (C) 2000-2003 Kern Sibbald and John Walker
10 This program is free software; you can redistribute it and/or
11 modify it under the terms of the GNU General Public License as
12 published by the Free Software Foundation; either version 2 of
13 the License, or (at your option) any later version.
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 GNU
18 General Public License for more details.
20 You should have received a copy of the GNU General Public
21 License along with this program; if not, write to the Free
22 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
32 size_t name_max; /* filename max length */
33 size_t path_max; /* path name max length */
36 /* ****FIXME**** debug until stable */
38 #define bmalloc(x) sm_malloc(__FILE__, __LINE__, x)
42 * Initialize the find files "global" variables
44 FF_PKT *init_find_files()
48 ff = (FF_PKT *) bmalloc(sizeof(FF_PKT));
49 memset(ff, 0, sizeof(FF_PKT));
51 ff->sys_fname = get_pool_memory(PM_FNAME);
53 init_include_exclude_files(ff); /* init lists */
56 /* Get system path and filename maximum lengths */
57 path_max = pathconf(".", _PC_PATH_MAX);
58 if (path_max < 1024) {
62 name_max = pathconf(".", _PC_NAME_MAX);
63 if (name_max < 1024) {
66 path_max++; /* add for EOS */
67 name_max++; /* add for EOS */
69 Dmsg1(100, "init_find_files ff=%p\n", ff);
74 * Set find_files options. For the moment, we only
75 * provide for full/incremental saves, and setting
76 * of save_time. For additional options, see above
79 set_find_options(FF_PKT *ff, int incremental, time_t save_time)
81 Dmsg0(100, "Enter set_find_options()\n");
82 ff->incremental = incremental;
83 ff->save_time = save_time;
84 Dmsg0(100, "Leave set_find_options()\n");
88 * Find all specified files (determined by calls to
90 * This routine calls the (handle_file) subroutine with all
91 * sorts of good information for the final disposition of
94 * Call this subroutine with a callback subroutine as the first
95 * argument and a packet as the second argument, this packet
96 * will be passed back to the callback subroutine as the last
99 * The callback subroutine gets called with:
100 * arg1 -- the FF_PKT containing filename, link, stat, ftype, flags, etc
101 * arg2 -- the user supplied packet
105 find_files(JCR *jcr, FF_PKT *ff, int callback(FF_PKT *ff_pkt, void *hpkt), void *his_pkt)
108 struct s_included_file *inc = NULL;
110 while (!job_cancelled(jcr) && (inc = get_next_included_file(ff, inc))) {
112 strcpy(ff->VerifyOpts, inc->VerifyOpts); /* Copy options for this file */
113 Dmsg1(50, "find_files: file=%s\n", file);
114 if (!file_is_excluded(ff, file)) {
115 if (!find_one_file(jcr, ff, callback, his_pkt, file, (dev_t)-1, 1)) {
116 return 0; /* error return */
124 * Terminate find_files() and release
125 * all allocated memory
128 term_find_files(FF_PKT *ff)
132 term_include_exclude_files(ff);
133 free_pool_memory(ff->sys_fname);
134 hard_links = term_find_one(ff);