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 */
55 /* Get system path and filename maximum lengths */
56 path_max = pathconf(".", _PC_PATH_MAX);
57 if (path_max < 1024) {
61 name_max = pathconf(".", _PC_NAME_MAX);
62 if (name_max < 1024) {
65 path_max++; /* add for EOS */
66 name_max++; /* add for EOS */
68 Dmsg1(100, "init_find_files ff=%p\n", ff);
73 * Set find_files options. For the moment, we only
74 * provide for full/incremental saves, and setting
75 * of save_time. For additional options, see above
78 set_find_options(FF_PKT *ff, int incremental, time_t save_time)
80 Dmsg0(100, "Enter set_find_options()\n");
81 ff->incremental = incremental;
82 ff->save_time = save_time;
83 Dmsg0(100, "Leave set_find_options()\n");
87 * Find all specified files (determined by calls to
89 * This routine calls the (handle_file) subroutine with all
90 * sorts of good information for the final disposition of
93 * Call this subroutine with a callback subroutine as the first
94 * argument and a packet as the second argument, this packet
95 * will be passed back to the callback subroutine as the last
98 * The callback subroutine gets called with:
99 * arg1 -- the FF_PKT containing filename, link, stat, ftype, flags, etc
100 * arg2 -- the user supplied packet
104 find_files(JCR *jcr, FF_PKT *ff, int callback(FF_PKT *ff_pkt, void *hpkt), void *his_pkt)
106 struct s_included_file *inc = NULL;
108 while (!job_canceled(jcr) && (inc = get_next_included_file(ff, inc))) {
109 /* Copy options for this file */
110 bstrncpy(ff->VerifyOpts, inc->VerifyOpts, sizeof(ff->VerifyOpts));
111 Dmsg1(50, "find_files: file=%s\n", inc->fname);
112 if (!file_is_excluded(ff, inc->fname)) {
113 if (!find_one_file(jcr, ff, callback, his_pkt, inc->fname,
115 return 0; /* error return */
123 * Terminate find_files() and release
124 * all allocated memory
127 term_find_files(FF_PKT *ff)
131 term_include_exclude_files(ff);
132 free_pool_memory(ff->sys_fname);
133 hard_links = term_find_one(ff);