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 int32_t name_max; /* filename max length */
33 int32_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 */
54 ff->mtime_only = 0; /* use both st_mtime and st_ctime */
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, int mtime_only)
81 Dmsg0(100, "Enter set_find_options()\n");
82 ff->incremental = incremental;
83 ff->save_time = save_time;
84 ff->mtime_only = mtime_only;
85 Dmsg0(100, "Leave set_find_options()\n");
89 * Find all specified files (determined by calls to
91 * This routine calls the (handle_file) subroutine with all
92 * sorts of good information for the final disposition of
95 * Call this subroutine with a callback subroutine as the first
96 * argument and a packet as the second argument, this packet
97 * will be passed back to the callback subroutine as the last
100 * The callback subroutine gets called with:
101 * arg1 -- the FF_PKT containing filename, link, stat, ftype, flags, etc
102 * arg2 -- the user supplied packet
106 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_canceled(jcr) && (inc = get_next_included_file(ff, inc))) {
111 /* Copy options for this file */
112 bstrncpy(ff->VerifyOpts, inc->VerifyOpts, sizeof(ff->VerifyOpts));
113 Dmsg1(50, "find_files: file=%s\n", inc->fname);
114 if (!file_is_excluded(ff, inc->fname)) {
115 if (!find_one_file(jcr, ff, callback, his_pkt, inc->fname,
117 return 0; /* error return */
125 * Terminate find_files() and release
126 * all allocated memory
129 term_find_files(FF_PKT *ff)
133 term_include_exclude_files(ff);
134 free_pool_memory(ff->sys_fname);
135 hard_links = term_find_one(ff);