]> git.sur5r.net Git - bacula/bacula/blob - bacula/src/stored/bls.c
- Add copyright to title page of manual so it is clear.
[bacula/bacula] / bacula / src / stored / bls.c
1 /*
2  *
3  *  Dumb program to do an "ls" of a Bacula 1.0 mortal file.
4  *
5  *   Version $Id$
6  */
7 /*
8    Copyright (C) 2000-2005 Kern Sibbald
9
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.
14
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.
19
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,
23    MA 02111-1307, USA.
24
25  */
26
27 #include "bacula.h"
28 #include "stored.h"
29 #include "findlib/find.h"
30
31 #if defined(HAVE_CYGWIN) || defined(HAVE_WIN32)
32 int win32_client = 1;
33 #else
34 int win32_client = 0;
35 #endif
36
37 static void do_blocks(char *infname);
38 static void do_jobs(char *infname);
39 static void do_ls(char *fname);
40 static void do_close(JCR *jcr);
41 static void get_session_record(DEVICE *dev, DEV_RECORD *rec, SESSION_LABEL *sessrec);
42 static bool record_cb(DCR *dcr, DEV_RECORD *rec);
43
44 static DEVICE *dev;
45 static DCR *dcr;
46 static bool dump_label = false;
47 static bool list_blocks = false;
48 static bool list_jobs = false;
49 static DEV_RECORD *rec;
50 static DEV_BLOCK *block;
51 static JCR *jcr;
52 static SESSION_LABEL sessrec;
53 static uint32_t num_files = 0;
54 static ATTR *attr;
55
56 #define CONFIG_FILE "bacula-sd.conf"
57 char *configfile;
58 bool forge_on = false;
59
60
61 static FF_PKT *ff;
62
63 static BSR *bsr = NULL;
64
65 static void usage()
66 {
67    fprintf(stderr,
68 "Copyright (C) 2000-2005 Kern Sibbald.\n"
69 "\nVersion: " VERSION " (" BDATE ")\n\n"
70 "Usage: bls [options] <device-name>\n"
71 "       -b <file>       specify a bootstrap file\n"
72 "       -c <file>       specify a config file\n"
73 "       -d <level>      specify debug level\n"
74 "       -e <file>       exclude list\n"
75 "       -i <file>       include list\n"
76 "       -j              list jobs\n"
77 "       -k              list blocks\n"
78 "    (no j or k option) list saved files\n"
79 "       -L              dump label\n"
80 "       -p              proceed inspite of errors\n"
81 "       -v              be verbose\n"
82 "       -V              specify Volume names (separated by |)\n"
83 "       -?              print this message\n\n");
84    exit(1);
85 }
86
87
88 int main (int argc, char *argv[])
89 {
90    int i, ch;
91    FILE *fd;
92    char line[1000];
93    char *VolumeName= NULL;
94    char *bsrName = NULL;
95    bool ignore_label_errors = false;
96
97    working_directory = "/tmp";
98    my_name_is(argc, argv, "bls");
99    init_msg(NULL, NULL);              /* initialize message handler */
100
101    ff = init_find_files();
102
103    while ((ch = getopt(argc, argv, "b:c:d:e:i:jkLpvV:?")) != -1) {
104       switch (ch) {
105       case 'b':
106          bsrName = optarg;
107          break;
108
109       case 'c':                    /* specify config file */
110          if (configfile != NULL) {
111             free(configfile);
112          }
113          configfile = bstrdup(optarg);
114          break;
115
116       case 'd':                    /* debug level */
117          debug_level = atoi(optarg);
118          if (debug_level <= 0)
119             debug_level = 1;
120          break;
121
122       case 'e':                    /* exclude list */
123          if ((fd = fopen(optarg, "r")) == NULL) {
124             Pmsg2(0, _("Could not open exclude file: %s, ERR=%s\n"),
125                optarg, strerror(errno));
126             exit(1);
127          }
128          while (fgets(line, sizeof(line), fd) != NULL) {
129             strip_trailing_junk(line);
130             Dmsg1(100, "add_exclude %s\n", line);
131             add_fname_to_exclude_list(ff, line);
132          }
133          fclose(fd);
134          break;
135
136       case 'i':                    /* include list */
137          if ((fd = fopen(optarg, "r")) == NULL) {
138             Pmsg2(0, "Could not open include file: %s, ERR=%s\n",
139                optarg, strerror(errno));
140             exit(1);
141          }
142          while (fgets(line, sizeof(line), fd) != NULL) {
143             strip_trailing_junk(line);
144             Dmsg1(100, "add_include %s\n", line);
145             add_fname_to_include_list(ff, 0, line);
146          }
147          fclose(fd);
148          break;
149
150       case 'j':
151          list_jobs = true;
152          break;
153
154       case 'k':
155          list_blocks = true;
156          break;
157
158       case 'L':
159          dump_label = true;
160          break;
161
162       case 'p':
163          ignore_label_errors = true;
164          forge_on = true;
165          break;
166
167       case 'v':
168          verbose++;
169          break;
170
171       case 'V':                    /* Volume name */
172          VolumeName = optarg;
173          break;
174
175       case '?':
176       default:
177          usage();
178
179       } /* end switch */
180    } /* end while */
181    argc -= optind;
182    argv += optind;
183
184    if (!argc) {
185       Pmsg0(0, _("No archive name specified\n"));
186       usage();
187    }
188
189    if (configfile == NULL) {
190       configfile = bstrdup(CONFIG_FILE);
191    }
192
193    parse_config(configfile);
194
195    if (ff->included_files_list == NULL) {
196       add_fname_to_include_list(ff, 0, "/");
197    }
198
199    for (i=0; i < argc; i++) {
200       if (bsrName) {
201          bsr = parse_bsr(NULL, bsrName);
202       }
203       jcr = setup_jcr("bls", argv[i], bsr, VolumeName, 1); /* acquire for read */
204       if (!jcr) {
205          exit(1);
206       }
207       jcr->ignore_label_errors = ignore_label_errors;
208       dev = jcr->dcr->dev;
209       if (!dev) {
210          exit(1);
211       }
212       dcr = jcr->dcr;
213       rec = new_record();
214       block = new_block(dev);
215       attr = new_attr();
216       /*
217        * Assume that we have already read the volume label.
218        * If on second or subsequent volume, adjust buffer pointer
219        */
220       if (dev->VolHdr.PrevVolName[0] != 0) { /* second volume */
221          Pmsg1(0, "\n"
222 "Warning, this Volume is a continuation of Volume %s\n",
223                 dev->VolHdr.PrevVolName);
224       }
225
226       if (list_blocks) {
227          do_blocks(argv[i]);
228       } else if (list_jobs) {
229          do_jobs(argv[i]);
230       } else {
231          do_ls(argv[i]);
232       }
233       do_close(jcr);
234    }
235    if (bsr) {
236       free_bsr(bsr);
237    }
238    term_include_exclude_files(ff);
239    term_find_files(ff);
240    return 0;
241 }
242
243
244 static void do_close(JCR *jcr)
245 {
246    release_device(jcr->dcr);
247    free_attr(attr);
248    free_record(rec);
249    free_block(block);
250    free_jcr(jcr);
251    term_dev(dev);
252 }
253
254
255 /* List just block information */
256 static void do_blocks(char *infname)
257 {
258    for ( ;; ) {
259       if (!read_block_from_device(dcr, NO_BLOCK_NUMBER_CHECK)) {
260          Dmsg1(100, "!read_block(): ERR=%s\n", dev->strerror());
261          if (dev->at_eot()) {
262             if (!mount_next_read_volume(dcr)) {
263                Jmsg(jcr, M_INFO, 0, _("Got EOM at file %u on device %s, Volume \"%s\"\n"),
264                   dev->file, dev->print_name(), dcr->VolumeName);
265                break;
266             }
267             /* Read and discard Volume label */
268             DEV_RECORD *record;
269             record = new_record();
270             read_block_from_device(dcr, NO_BLOCK_NUMBER_CHECK);
271             read_record_from_block(block, record);
272             get_session_record(dev, record, &sessrec);
273             free_record(record);
274             Jmsg(jcr, M_INFO, 0, _("Mounted Volume \"%s\".\n"), dcr->VolumeName);
275          } else if (dev->at_eof()) {
276             Jmsg(jcr, M_INFO, 0, _("Got EOF at file %u on device %s, Volume \"%s\"\n"),
277                dev->file, dev->print_name(), dcr->VolumeName);
278             Dmsg0(20, "read_record got eof. try again\n");
279             continue;
280          } else if (dev->state & ST_SHORT) {
281             Jmsg(jcr, M_INFO, 0, "%s", dev->errmsg);
282             continue;
283          } else {
284             /* I/O error */
285             display_tape_error_status(jcr, dev);
286             break;
287          }
288       }
289       if (!match_bsr_block(bsr, block)) {
290          Dmsg5(100, "reject Blk=%u blen=%u bVer=%d SessId=%u SessTim=%u\n",
291             block->BlockNumber, block->block_len, block->BlockVer,
292             block->VolSessionId, block->VolSessionTime);
293          continue;
294       }
295       Dmsg5(100, "Blk=%u blen=%u bVer=%d SessId=%u SessTim=%u\n",
296         block->BlockNumber, block->block_len, block->BlockVer,
297         block->VolSessionId, block->VolSessionTime);
298       if (verbose == 1) {
299          read_record_from_block(block, rec);
300          Pmsg9(-1, "File:blk=%u:%u blk_num=%u blen=%u First rec FI=%s SessId=%u SessTim=%u Strm=%s rlen=%d\n",
301               dev->file, dev->block_num,
302               block->BlockNumber, block->block_len,
303               FI_to_ascii(rec->FileIndex), rec->VolSessionId, rec->VolSessionTime,
304               stream_to_ascii(rec->Stream, rec->FileIndex), rec->data_len);
305          rec->remainder = 0;
306       } else if (verbose > 1) {
307          dump_block(block, "");
308       } else {
309          printf("Block: %d size=%d\n", block->BlockNumber, block->block_len);
310       }
311
312    }
313    return;
314 }
315
316 /*
317  * We are only looking for labels or in particular Job Session records
318  */
319 static bool jobs_cb(DCR *dcr, DEV_RECORD *rec)
320 {
321    if (rec->FileIndex < 0) {
322       dump_label_record(dcr->dev, rec, verbose);
323    }
324    rec->remainder = 0;
325    return true;
326 }
327
328 /* Do list job records */
329 static void do_jobs(char *infname)
330 {
331    read_records(dcr, jobs_cb, mount_next_read_volume);
332 }
333
334 /* Do an ls type listing of an archive */
335 static void do_ls(char *infname)
336 {
337    if (dump_label) {
338       dump_volume_label(dev);
339       return;
340    }
341    read_records(dcr, record_cb, mount_next_read_volume);
342    printf("%u files found.\n", num_files);
343 }
344
345 /*
346  * Called here for each record from read_records()
347  */
348 static bool record_cb(DCR *dcr, DEV_RECORD *rec)
349 {
350    if (rec->FileIndex < 0) {
351       get_session_record(dev, rec, &sessrec);
352       return true;
353    }
354    /* File Attributes stream */
355    if (rec->Stream == STREAM_UNIX_ATTRIBUTES ||
356        rec->Stream == STREAM_UNIX_ATTRIBUTES_EX) {
357
358       if (!unpack_attributes_record(jcr, rec->Stream, rec->data, attr)) {
359          if (!forge_on) {
360             Emsg0(M_ERROR_TERM, 0, _("Cannot continue.\n"));
361          }
362          num_files++;
363          return true;
364       }
365
366       if (attr->file_index != rec->FileIndex) {
367          Emsg2(forge_on?M_WARNING:M_ERROR_TERM, 0, _("Record header file index %ld not equal record index %ld\n"),
368                rec->FileIndex, attr->file_index);
369       }
370
371       attr->data_stream = decode_stat(attr->attr, &attr->statp, &attr->LinkFI);
372       build_attr_output_fnames(jcr, attr);
373
374       if (file_is_included(ff, attr->fname) && !file_is_excluded(ff, attr->fname)) {
375          if (verbose) {
376             Pmsg5(-1, "FileIndex=%d VolSessionId=%d VolSessionTime=%d Stream=%d DataLen=%d\n",
377                   rec->FileIndex, rec->VolSessionId, rec->VolSessionTime, rec->Stream, rec->data_len);
378          }
379          print_ls_output(jcr, attr);
380          num_files++;
381       }
382    }
383    return true;
384 }
385
386
387 static void get_session_record(DEVICE *dev, DEV_RECORD *rec, SESSION_LABEL *sessrec)
388 {
389    const char *rtype;
390    memset(sessrec, 0, sizeof(sessrec));
391    switch (rec->FileIndex) {
392    case PRE_LABEL:
393       rtype = "Fresh Volume Label";
394       break;
395    case VOL_LABEL:
396       rtype = "Volume Label";
397       unser_volume_label(dev, rec);
398       break;
399    case SOS_LABEL:
400       rtype = "Begin Job Session";
401       unser_session_label(sessrec, rec);
402       break;
403    case EOS_LABEL:
404       rtype = "End Job Session";
405       break;
406    case EOM_LABEL:
407       rtype = "End of Medium";
408       break;
409    default:
410       rtype = "Unknown";
411       break;
412    }
413    Dmsg5(10, "%s Record: VolSessionId=%d VolSessionTime=%d JobId=%d DataLen=%d\n",
414          rtype, rec->VolSessionId, rec->VolSessionTime, rec->Stream, rec->data_len);
415    if (verbose) {
416       Pmsg5(-1, "%s Record: VolSessionId=%d VolSessionTime=%d JobId=%d DataLen=%d\n",
417             rtype, rec->VolSessionId, rec->VolSessionTime, rec->Stream, rec->data_len);
418    }
419 }
420
421
422 /* Dummies to replace askdir.c */
423 bool    dir_get_volume_info(DCR *dcr, enum get_vol_info_rw  writing) { return 1;}
424 bool    dir_find_next_appendable_volume(DCR *dcr) { return 1;}
425 bool    dir_update_volume_info(DCR *dcr, bool relabel) { return 1; }
426 bool    dir_create_jobmedia_record(DCR *dcr) { return 1; }
427 bool    dir_ask_sysop_to_create_appendable_volume(DCR *dcr) { return 1; }
428 bool    dir_update_file_attributes(DCR *dcr, DEV_RECORD *rec) { return 1;}
429 bool    dir_send_job_status(JCR *jcr) {return 1;}
430
431
432 bool dir_ask_sysop_to_mount_volume(DCR *dcr)
433 {
434    DEVICE *dev = dcr->dev;
435    fprintf(stderr, "Mount Volume \"%s\" on device %s and press return when ready: ",
436       dcr->VolumeName, dev->print_name());
437    getchar();
438    return true;
439 }