3 * Dumb program to do an "ls" of a Bacula 1.0 mortal file.
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,
29 #include "findlib/find.h"
38 static void do_blocks(char *infname);
39 static void do_jobs(char *infname);
40 static void do_ls(char *fname);
41 static void do_close(JCR *jcr);
42 static void get_session_record(DEVICE *dev, DEV_RECORD *rec, SESSION_LABEL *sessrec);
43 static void record_cb(JCR *jcr, DEVICE *dev, DEV_BLOCK *block, DEV_RECORD *rec);
46 static int dump_label = FALSE;
47 static int list_blocks = FALSE;
48 static int list_jobs = FALSE;
49 static DEV_RECORD *rec;
50 static DEV_BLOCK *block;
52 static SESSION_LABEL sessrec;
53 static uint32_t num_files = 0;
55 static int non_support_data = 0;
57 #define CONFIG_FILE "bacula-sd.conf"
63 static BSR *bsr = NULL;
68 "\nVersion: " VERSION " (" BDATE ")\n\n"
69 "Usage: bls [-d debug_level] <physical-device-name>\n"
70 " -b <file> specify a bootstrap file\n"
71 " -c <file> specify a config file\n"
72 " -d <level> specify debug level\n"
73 " -e <file> exclude list\n"
74 " -i <file> include list\n"
77 " (none of above) list saved files\n"
79 " -V specify Volume names (separated by |)\n"
80 " -? print this message\n\n");
85 int main (int argc, char *argv[])
90 char *VolumeName= NULL;
93 working_directory = "/tmp";
94 my_name_is(argc, argv, "bls");
95 init_msg(NULL, NULL); /* initialize message handler */
97 memset(&ff, 0, sizeof(ff));
98 init_include_exclude_files(&ff);
100 while ((ch = getopt(argc, argv, "b:c:d:e:i:jkLtvV:?")) != -1) {
106 case 'c': /* specify config file */
107 if (configfile != NULL) {
110 configfile = bstrdup(optarg);
113 case 'd': /* debug level */
114 debug_level = atoi(optarg);
115 if (debug_level <= 0)
119 case 'e': /* exclude list */
120 if ((fd = fopen(optarg, "r")) == NULL) {
121 Pmsg2(0, _("Could not open exclude file: %s, ERR=%s\n"),
122 optarg, strerror(errno));
125 while (fgets(line, sizeof(line), fd) != NULL) {
126 strip_trailing_junk(line);
127 Dmsg1(100, "add_exclude %s\n", line);
128 add_fname_to_exclude_list(&ff, line);
133 case 'i': /* include list */
134 if ((fd = fopen(optarg, "r")) == NULL) {
135 Pmsg2(0, "Could not open include file: %s, ERR=%s\n",
136 optarg, strerror(errno));
139 while (fgets(line, sizeof(line), fd) != NULL) {
140 strip_trailing_junk(line);
141 Dmsg1(100, "add_include %s\n", line);
142 add_fname_to_include_list(&ff, 0, line);
163 case 'V': /* Volume name */
177 Pmsg0(0, _("No archive name specified\n"));
181 if (configfile == NULL) {
182 configfile = bstrdup(CONFIG_FILE);
185 parse_config(configfile);
187 if (ff.included_files_list == NULL) {
188 add_fname_to_include_list(&ff, 0, "/");
191 for (i=0; i < argc; i++) {
193 bsr = parse_bsr(NULL, bsrName);
195 jcr = setup_jcr("bls", argv[i], bsr, VolumeName);
196 dev = setup_to_access_device(jcr, 1); /* acquire for read */
201 block = new_block(dev);
204 * Assume that we have already read the volume label.
205 * If on second or subsequent volume, adjust buffer pointer
207 if (dev->VolHdr.PrevVolName[0] != 0) { /* second volume */
209 Warning, this Volume is a continuation of Volume %s\n",
210 dev->VolHdr.PrevVolName);
215 } else if (list_jobs) {
229 static void do_close(JCR *jcr)
231 release_device(jcr, dev);
240 /* List just block information */
241 static void do_blocks(char *infname)
244 dump_volume_label(dev);
248 if (!read_block_from_device(jcr, dev, block, NO_BLOCK_NUMBER_CHECK)) {
249 Dmsg1(100, "!read_block(): ERR=%s\n", strerror_dev(dev));
250 if (dev->state & ST_EOT) {
251 if (!mount_next_read_volume(jcr, dev, block)) {
252 Jmsg(jcr, M_INFO, 0, _("Got EOM at file %u on device %s, Volume \"%s\"\n"),
253 dev->file, dev_name(dev), jcr->VolumeName);
256 /* Read and discard Volume label */
258 record = new_record();
259 read_block_from_device(jcr, dev, block, NO_BLOCK_NUMBER_CHECK);
260 read_record_from_block(block, record);
261 get_session_record(dev, record, &sessrec);
263 Jmsg(jcr, M_INFO, 0, _("Mounted Volume \"%s\".\n"), jcr->VolumeName);
265 } else if (dev->state & ST_EOF) {
266 Jmsg(jcr, M_INFO, 0, _("Got EOF at file %u on device %s, Volume \"%s\"\n"),
267 dev->file, dev_name(dev), jcr->VolumeName);
268 Dmsg0(20, "read_record got eof. try again\n");
270 } else if (dev->state & ST_SHORT) {
271 Jmsg(jcr, M_INFO, 0, "%s", dev->errmsg);
275 display_tape_error_status(jcr, dev);
279 if (!match_bsr_block(bsr, block)) {
280 Dmsg5(100, "reject Blk=%u blen=%u bVer=%d SessId=%u SessTim=%u\n",
281 block->BlockNumber, block->block_len, block->BlockVer,
282 block->VolSessionId, block->VolSessionTime);
285 Dmsg5(100, "Blk=%u blen=%u bVer=%d SessId=%u SessTim=%u\n",
286 block->BlockNumber, block->block_len, block->BlockVer,
287 block->VolSessionId, block->VolSessionTime);
289 read_record_from_block(block, rec);
290 Pmsg7(-1, "Block: %u blen=%u First rec FI=%s SessId=%u SessTim=%u Strm=%s rlen=%d\n",
291 block->BlockNumber, block->block_len,
292 FI_to_ascii(rec->FileIndex), rec->VolSessionId, rec->VolSessionTime,
293 stream_to_ascii(rec->Stream, rec->FileIndex), rec->data_len);
295 } else if (verbose > 1) {
296 dump_block(block, "");
298 printf("Block: %d size=%d\n", block->BlockNumber, block->block_len);
306 * We are only looking for labels or in particula Job Session records
308 static void jobs_cb(JCR *jcr, DEVICE *dev, DEV_BLOCK *block, DEV_RECORD *rec)
310 if (rec->FileIndex < 0) {
311 dump_label_record(dev, rec, verbose);
316 /* Do list job records */
317 static void do_jobs(char *infname)
319 read_records(jcr, dev, jobs_cb, mount_next_read_volume);
322 /* Do an ls type listing of an archive */
323 static void do_ls(char *infname)
326 dump_volume_label(dev);
329 read_records(jcr, dev, record_cb, mount_next_read_volume);
330 printf("%u files found.\n", num_files);
334 * Called here for each record from read_records()
336 static void record_cb(JCR *jcr, DEVICE *dev, DEV_BLOCK *block, DEV_RECORD *rec)
338 if (rec->FileIndex < 0) {
339 get_session_record(dev, rec, &sessrec);
342 /* File Attributes stream */
343 if (rec->Stream == STREAM_UNIX_ATTRIBUTES ||
344 rec->Stream == STREAM_UNIX_ATTRIBUTES_EX) {
346 if (!unpack_attributes_record(jcr, rec->Stream, rec->data, attr)) {
347 Emsg0(M_ERROR_TERM, 0, _("Cannot continue.\n"));
350 if (attr->file_index != rec->FileIndex) {
351 Emsg2(M_ERROR_TERM, 0, _("Record header file index %ld not equal record index %ld\n"),
352 rec->FileIndex, attr->file_index);
355 attr->data_stream = decode_stat(attr->attr, &attr->statp, &attr->LinkFI);
356 if (!is_stream_supported(attr->data_stream)) {
357 if (!non_support_data++) {
358 Jmsg(jcr, M_ERROR, 0, _("%s stream not supported on this Client.\n"),
359 stream_to_ascii(attr->data_stream));
363 build_attr_output_fnames(jcr, attr);
365 if (file_is_included(&ff, attr->fname) && !file_is_excluded(&ff, attr->fname)) {
366 print_ls_output(jcr, attr);
374 static void get_session_record(DEVICE *dev, DEV_RECORD *rec, SESSION_LABEL *sessrec)
377 memset(sessrec, 0, sizeof(sessrec));
378 switch (rec->FileIndex) {
380 rtype = "Fresh Volume Label";
383 rtype = "Volume Label";
384 unser_volume_label(dev, rec);
387 rtype = "Begin Session";
388 unser_session_label(sessrec, rec);
391 rtype = "End Session";
394 rtype = "End of Medium";
400 Dmsg5(10, "%s Record: VolSessionId=%d VolSessionTime=%d JobId=%d DataLen=%d\n",
401 rtype, rec->VolSessionId, rec->VolSessionTime, rec->Stream, rec->data_len);
405 /* Dummies to replace askdir.c */
406 int dir_get_volume_info(JCR *jcr, enum get_vol_info_rw writing) { return 1;}
407 int dir_find_next_appendable_volume(JCR *jcr) { return 1;}
408 int dir_update_volume_info(JCR *jcr, VOLUME_CAT_INFO *vol, int relabel) { return 1; }
409 int dir_create_jobmedia_record(JCR *jcr) { return 1; }
410 int dir_ask_sysop_to_mount_next_volume(JCR *jcr, DEVICE *dev) { return 1; }
411 int dir_update_file_attributes(JCR *jcr, DEV_RECORD *rec) { return 1;}
412 int dir_send_job_status(JCR *jcr) {return 1;}
415 int dir_ask_sysop_to_mount_volume(JCR *jcr, DEVICE *dev)
417 fprintf(stderr, "Mount Volume \"%s\" on device %s and press return when ready: ",
418 jcr->VolumeName, dev_name(dev));