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, 2001, 2002 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,
31 /* Imported functions */
32 int find_one_file(FF_PKT *ff, int handle_file(FF_PKT *ff_pkt, void *hpkt),
33 void *pkt, char *p, dev_t parent_device, int top_level);
34 void term_find_one(FF_PKT *ff);
36 size_t name_max; /* filename max length */
37 size_t path_max; /* path name max length */
40 /* ****FIXME**** debug until stable */
42 #define bmalloc(x) sm_malloc(__FILE__, __LINE__, x)
46 * Initialize the find files "global" variables
48 FF_PKT *init_find_files()
52 ff = (FF_PKT *) bmalloc(sizeof(FF_PKT));
53 memset(ff, 0, sizeof(FF_PKT));
55 init_include_exclude_files(ff); /* init lists */
57 ff->one_file_system = 1;
59 /* Get system path and filename maximum lengths */
60 path_max = pathconf(".", _PC_PATH_MAX);
61 if (path_max < 1024) {
65 name_max = pathconf(".", _PC_NAME_MAX);
66 if (name_max < 1024) {
69 path_max++; /* add for EOS */
70 name_max++; /* add for EOS */
72 Dmsg1(100, "init_find_files ff=%p\n", ff);
77 * Set find_files options. For the moment, we only
78 * provide for full/incremental saves, and setting
79 * of save_time. For additional options, see above
82 set_find_options(FF_PKT *ff, int incremental, time_t save_time)
84 Dmsg0(100, "Enter set_find_options()\n");
85 ff->incremental = incremental;
86 ff->save_time = save_time;
87 Dmsg0(100, "Leave set_find_options()\n");
91 * Find all specified files (determined by calls to
93 * This routine calls the (handle_file) subroutine with all
94 * sorts of good information for the final disposition of
97 * Call this subroutine with a callback subroutine as the first
98 * argument and a packet as the second argument, this packet
99 * will be passed back to the callback subroutine as the last
102 * The callback subroutine gets called with:
103 * arg1 -- the FF_PKT containing filename, link, stat, ftype, flags, etc
104 * arg2 -- the user supplied packet
108 find_files(FF_PKT *ff, int callback(FF_PKT *ff_pkt, void *hpkt), void *his_pkt)
111 struct s_included_file *inc = NULL;
113 while ((inc = get_next_included_file(ff, inc))) {
115 strcpy(ff->VerifyOpts, inc->VerifyOpts); /* Copy options for this file */
116 Dmsg1(50, "find_files: file=%s\n", file);
117 if (!file_is_excluded(ff, file)) {
118 if (!find_one_file(ff, callback, his_pkt, file, (dev_t)-1, 1)) {
119 return 0; /* error return */
127 * Terminate find_files() and release
128 * all allocated memory
131 term_find_files(FF_PKT *ff)
133 term_include_exclude_files(ff);