source: trunk/mondo/mondo/common/libmondo-tools.c @ 672

Last change on this file since 672 was 672, checked in by bcornec, 14 years ago

merge -r651:671 $SVN_M/branches/stable

  • Property svn:keywords set to Id
File size: 35.5 KB
Line 
1/* $Id: libmondo-tools.c 672 2006-06-12 07:55:14Z bcornec $
2misc tools
3*/
4
5/**
6 * @file
7 * Miscellaneous tools that didn't really fit anywhere else.
8 */
9
10#include "my-stuff.h"
11#include "mondostructures.h"
12#include "libmondo-tools.h"
13#include "newt-specific-EXT.h"
14#include "libmondo-files-EXT.h"
15#include "libmondo-fork-EXT.h"
16#include "libmondo-raid-EXT.h"
17#include <sys/socket.h>
18#include <netdb.h>
19#include <netinet/in.h>
20#ifndef S_SPLINT_S
21#include <arpa/inet.h>
22#endif
23
24/*@unused@*/
25//static char cvsid[] = "$Id: libmondo-tools.c 672 2006-06-12 07:55:14Z bcornec $";
26
27extern int g_tape_buffer_size_MB;
28extern char *g_erase_tmpdir_and_scratchdir;
29extern char *g_serial_string;
30extern bool g_text_mode;
31extern int g_currentY;
32extern int g_current_media_number;
33
34/**
35 * @addtogroup globalGroup
36 * @{
37 */
38bool g_remount_cdrom_at_end,    ///< TRUE if we unmounted the CD-ROM and should remount it when done with the backup.
39 g_remount_floppy_at_end;       ///< TRUE if we unmounted the floppy and should remount it when done with the backup.
40bool g_cd_recovery;             ///< TRUE if we're making an "autonuke" backup.
41double g_kernel_version;
42
43/**
44 * The place where /boot is mounted. - Used locally only
45 */
46static char *g_boot_mountpt = NULL;
47
48/**
49 * The location of Mondo's home directory.
50 */
51char *g_mondo_home = NULL;
52
53/**
54 * The serial string (used to differentiate between backups) of the current backup.
55 */
56char *g_serial_string = NULL;
57
58/**
59 * The location where tmpfs is mounted, or "" if it's not mounted.
60 */
61char *g_tmpfs_mountpt = NULL;
62char *g_magicdev_command = NULL;
63
64/**
65 * The default maximum level to log messages at or below.
66 */
67int g_loglevel = DEFAULT_DEBUG_LEVEL;
68
69/* @} - end of globalGroup */
70
71
72extern pid_t g_buffer_pid;
73extern pid_t g_main_pid;
74
75extern t_bkptype g_backup_media_type;
76
77extern bool am_I_in_disaster_recovery_mode(void);
78
79
80/**
81 * @addtogroup utilityGroup
82 * @{
83 */
84/**
85 * Assertion handler. Prints a friendly message to the user,
86 * offering to ignore all, dump core, break to debugger,
87 * exit, or ignore. Intended to be used with an assert() macro.
88 *
89 * @param file The file in which the assertion triggered.
90 * @param function The function (@c __FUNCTION__) in which the assertion triggered.
91 * @param line The line number of the assert() statement.
92 * @param exp The expression that failed (as a string).
93 */
94void _mondo_assert_fail(const char *file,
95                        const char *function, int line, const char *exp)
96{
97    static int ignoring_assertions = 0;
98    bool is_valid = TRUE;
99
100    log_it("ASSERTION FAILED: `%s' at %s:%d in %s", exp, file, line,
101           function);
102    if (ignoring_assertions) {
103        log_it("Well, the user doesn't care...");
104        return;
105    }
106#ifndef _XWIN
107    if (!g_text_mode)
108        newtSuspend();
109#endif
110    printf(_("ASSERTION FAILED: `%s'\n"), exp);
111    printf(_("\tat %s:%d in %s\n\n"), file, line, function);
112    printf(_("(I)gnore, ignore (A)ll, (D)ebug, a(B)ort, or (E)xit? "));
113    do {
114        is_valid = TRUE;
115        switch (toupper(getchar())) {
116        case 'A':               // ignore (A)ll
117            ignoring_assertions = 1;
118            break;
119        case 'B':               // a(B)ort
120            signal(SIGABRT, SIG_DFL);   /* prevent SIGABRT handler from running */
121            raise(SIGABRT);
122            break;              /* "can't get here" */
123        case 'D':               // (D)ebug, aka asm("int 3")
124#ifdef __IA32__
125            __asm__ __volatile__("int $3"); // break to debugger
126#endif
127            break;
128        case 'E':               // (E)xit
129            fatal_error("Failed assertion -- see above for details");
130            break;              /* "can't get here" */
131        case 'I':               // (I)gnore
132            break;
133            /* These next two work as follows:
134               the `default' catches the user's invalid choice and says so;
135               the '\n' catches the newline on the end and prints the prompt again.
136             */
137        case '\n':
138            printf
139                (_("(I)gnore, ignore (A)ll, (D)ebug, a(B)ort, or (E)xit? "));
140            break;
141        default:
142            is_valid = FALSE;
143            printf(_("Invalid choice.\n"));
144            break;
145        }
146    } while (!is_valid);
147
148    if (ignoring_assertions) {
149        log_it("Ignoring ALL assertions from now on.");
150    } else {
151        log_it("Ignoring assertion: %s", exp);
152    }
153
154    getchar();                  // skip \n
155
156#ifndef _XWIN
157    if (!g_text_mode)
158        newtResume();
159#endif
160}
161
162/**
163 * Clean's up users' KDE desktops.
164 * @bug Details about this function are unknown.
165 */
166void clean_up_KDE_desktop_if_necessary(void)
167{
168    char *tmp;
169
170    asprintf(&tmp,
171             "for i in `find /root /home -type d -name Desktop -maxdepth 2`; do \
172file=$i/.directory; if [ -f \"$file\" ] ; then mv -f $file $file.old ; \
173awk '{if (index($0, \"rootimagesmindi\")) { while (length($0)>2) { getline;} ; } \
174else { print $0;};}' $file.old  > $file ; fi ; done");
175    run_program_and_log_output(tmp, 5);
176    paranoid_free(tmp);
177}
178
179
180/**
181 * Locate mondoarchive's home directory. Searches in /usr/local/mondo, /usr/share/mondo,
182 * /usr/local/share/mondo, /opt, or if all else fails, search /usr.
183 *
184 * @param home_sz String to store the home directory ("" if it could not be found).
185 * @return 0 for success, nonzero for failure.
186 */
187char *find_and_store_mondoarchives_home()
188{
189    char *home_sz = NULL;
190
191    asprintf(&home_sz, MONDO_SHARE);
192    return (home_sz);
193}
194
195
196char *get_architecture()
197{
198#ifdef __IA32__
199    return ("i386");
200#endif
201#ifdef __X86_64__
202    return ("x86-64");
203#endif
204#ifdef __IA64__
205    return ("ia64");
206#endif
207    return ("unknown");
208}
209
210
211
212double get_kernel_version()
213{
214    char *p, *tmp;
215    double d;
216#ifdef __FreeBSD__
217    // JOSH - FIXME :)
218    d = 5.2;                    // :-)
219#else
220    asprintf(&tmp, call_program_and_get_last_line_of_output("uname -r"));
221    p = strchr(tmp, '.');
222    if (p) {
223        p = strchr(++p, '.');
224        if (p) {
225            while (*p) {
226                *p = *(p + 1);
227                p++;
228            }
229        }
230    }
231//  log_msg(1, "tmp = '%s'", tmp);
232    d = atof(tmp);
233#endif
234    log_msg(1, "g_kernel_version = %f", d);
235    return (d);
236}
237
238
239
240
241
242/**
243 * Get the current time.
244 * @return number of seconds since the epoch.
245 */
246long get_time()
247{
248    return (long) time((void *) 0);
249}
250
251
252
253
254
255
256
257/**
258 * Initialize a RAID volume structure, setting fields to zero. The
259 * actual hard drive is unaffected.
260 *
261 * @param raidrec The RAID volume structure to initialize.
262 * @note This function is system dependent.
263 */
264#ifdef __FreeBSD__
265void initialize_raidrec(struct vinum_volume *raidrec)
266{
267    int i, j;
268    raidrec->volname[0] = '\0';
269    raidrec->plexes = 0;
270    for (i = 0; i < 9; ++i) {
271        raidrec->plex[i].raidlevel = -1;
272        raidrec->plex[i].stripesize = 0;
273        raidrec->plex[i].subdisks = 0;
274        for (j = 0; j < 9; ++j) {
275            strcpy(raidrec->plex[i].sd[j].which_device, "");
276        }
277    }
278}
279#else
280void initialize_raidrec(struct raid_device_record *raidrec)
281{
282    assert(raidrec != NULL);
283    raidrec->raid_device[0] = '\0';
284    raidrec->raid_level = -9;
285    raidrec->persistent_superblock = 1;
286    raidrec->chunk_size = 64;
287    raidrec->parity = -1;
288    raidrec->data_disks.entries = 0;
289    raidrec->spare_disks.entries = 0;
290    raidrec->parity_disks.entries = 0;
291    raidrec->failed_disks.entries = 0;
292    raidrec->additional_vars.entries = 0;
293}
294#endif
295
296
297
298
299/**
300 * Insert modules that Mondo requires.
301 * Currently inserts @c dos, @c fat, @c vfat, and @c osst for Linux;
302 * @c msdosfs and @c ext2fs for FreeBSD.
303 */
304void insmod_crucial_modules(void)
305{
306#ifdef __FreeBSD__
307    system("kldstat | grep msdosfs || kldload msdosfs 2> /dev/null");
308    system("kldstat | grep ext2fs  || kldload ext2fs 2> /dev/null");
309#else
310    system("modprobe -a dos fat vfat loop &> /dev/null");
311#endif
312}
313
314
315/**
316 * Finish configuring the backup information structure. Call this function
317 * to set the parameters that depend on those that can be given on the command
318 * line.
319 *
320 * @param bkpinfo The backup information structure. Fields modified/used:
321 * - Used: @c bkpinfo->backup_data
322 * - Used: @c bkpinfo->backup_media_type
323 * - Used: @c bkpinfo->cdrw_speed
324 * - Used: @c bkpinfo->compression_level
325 * - Used: @c bkpinfo->include_paths
326 * - Used: @c bkpinfo->prefix
327 * - Used: @c bkpinfo->isodir
328 * - Used: @c bkpinfo->manual_cd_tray
329 * - Used: @c bkpinfo->make_cd_use_lilo
330 * - Used: @c bkpinfo->media_device
331 * - Used: @c bkpinfo->nfs_mount
332 * - Used: @c bkpinfo->nonbootable_backup
333 * - Used: @c bkpinfo->scratchdir
334 * - Used: @c bkpinfo->tmpdir
335 * - Used: @c bkpinfo->use_lzo
336 * - Modified: @c bkpinfo->call_before_iso
337 * - Modified: @c bkpinfo->call_make_iso
338 * - Modified: @c bkpinfo->optimal_set_size
339 * - Modified: @c bkpinfo->zip_exe
340 * - Modified: @c bkpinfo->zip_suffix
341 *
342 * @return number of errors, or 0 for success.
343 * @note Also creates directories that are specified in the @c bkpinfo structure but
344 * do not exist.
345 */
346int post_param_configuration(struct s_bkpinfo *bkpinfo)
347{
348    char *extra_cdrom_params = NULL;
349    char *mondo_mkisofs_sz = NULL;
350    char *command;
351    char *hostname, *ip_address;
352    int retval = 0;
353    long avm = 0;
354    char *colon;
355    char *cdr_exe;
356    char *tmp;
357    char *tmp1;
358    char call_before_iso_user[MAX_STR_LEN] = "\0";
359    int rdsiz_MB;
360    char *iso_path;
361
362    assert(bkpinfo != NULL);
363    bkpinfo->optimal_set_size =
364        (IS_THIS_A_STREAMING_BACKUP(bkpinfo->backup_media_type) ? 4 : 8) *
365        1024;
366
367    log_msg(1, "Foo");
368    if (bkpinfo->backup_media_type == tape) {
369        log_msg(1, "Bar");
370        asprintf(&tmp, "mt -f %s status", bkpinfo->media_device);
371        log_msg(1, "tmp = '%s'", tmp);
372        if (run_program_and_log_output(tmp, 3)) {
373            fatal_error
374                ("Unable to open tape device. If you haven't specified it with -d, do so. If you already have, check your parameter. I think it's wrong.");
375        }
376        paranoid_free(tmp);
377    }
378    make_hole_for_dir(bkpinfo->scratchdir);
379    make_hole_for_dir(bkpinfo->tmpdir);
380    if (bkpinfo->backup_media_type == iso)
381        make_hole_for_dir(bkpinfo->isodir);
382
383    run_program_and_log_output("uname -a", 5);
384    run_program_and_log_output("cat /etc/*issue*", 5);
385    asprintf(&g_tmpfs_mountpt, "%s/tmpfs", bkpinfo->tmpdir);
386    asprintf(&command, "mkdir -p %s", g_tmpfs_mountpt);
387    paranoid_system(command);
388    paranoid_free(command);
389    rdsiz_MB = PPCFG_RAMDISK_SIZE + g_tape_buffer_size_MB;
390#ifdef __FreeBSD__
391    asprintf(&tmp,
392             call_program_and_get_last_line_of_output
393             ("vmstat | tail -1 | tr -s ' ' | cut -d' ' -f6"));
394    avm += atol(tmp);
395    paranoid_free(tmp);
396    asprintf(&tmp,
397             call_program_and_get_last_line_of_output
398             ("swapinfo | grep -v Device | tr -s ' ' | cut -d' ' -f4 | tr '\n' '+' | sed 's/+$//' | bc"));
399    avm += atol(tmp);
400    paranoid_free(tmp);
401    asprintf(&command, "mdmfs -s %d%c md9 %s", rdsiz_MB, 'm',
402             g_tmpfs_mountpt);
403#else
404    asprintf(&tmp,
405             call_program_and_get_last_line_of_output
406             ("free | grep \":\" | tr -s ' ' '\t' | cut -f2 | head -n1"));
407    avm += atol(tmp);
408    paranoid_free(tmp);
409    asprintf(&command, "mount /dev/shm -t tmpfs %s -o size=%d%c",
410             g_tmpfs_mountpt, rdsiz_MB, 'm');
411    run_program_and_log_output("cat /proc/cpuinfo", 5);
412    /* BERLIOS: rpm is not necessarily there ! */
413    run_program_and_log_output
414        ("rpm -q newt newt-devel slang slang-devel ncurses ncurses-devel gcc",
415         5);
416#endif
417    if (avm / 1024 > rdsiz_MB * 3) {
418        if (run_program_and_log_output(command, 5)) {
419            g_tmpfs_mountpt[0] = '\0';
420            log_it("Failed to mount tmpfs");
421        } else {
422            log_it("Tmpfs mounted OK - %d MB", rdsiz_MB);
423        }
424    } else {
425        g_tmpfs_mountpt[0] = '\0';
426        log_it("It doesn't seem you have enough swap to use tmpfs. Fine.");
427    }
428    paranoid_free(command);
429
430    if (bkpinfo->use_lzo) {
431        strcpy(bkpinfo->zip_exe, "lzop");
432        strcpy(bkpinfo->zip_suffix, "lzo");
433    } else if (bkpinfo->compression_level != 0) {
434        strcpy(bkpinfo->zip_exe, "bzip2");
435        strcpy(bkpinfo->zip_suffix, "bz2");
436    } else {
437        bkpinfo->zip_exe[0] = bkpinfo->zip_suffix[0] = '\0';
438    }
439
440// DVD
441
442    if (bkpinfo->backup_media_type == dvd) {
443        if (!(find_home_of_exe("growisofs"))) {
444            fatal_error("Please install growisofs.");
445        }
446        if (bkpinfo->nonbootable_backup) {
447            asprintf(&mondo_mkisofs_sz, MONDO_GROWISOFS_NONBOOT);
448        } else if
449#ifdef __FreeBSD__
450            (TRUE)
451#else
452            (bkpinfo->make_cd_use_lilo)
453#endif
454#ifdef __IA64__
455    {
456        asprintf(&mondo_mkisofs_sz, MONDO_GROWISOFS_REGULAR_ELILO);
457    }
458#else
459    {
460        asprintf(&mondo_mkisofs_sz, MONDO_GROWISOFS_REGULAR_LILO);
461    }
462#endif
463        else
464        {
465            asprintf(&mondo_mkisofs_sz, MONDO_GROWISOFS_REGULAR_SYSLINUX);
466        }
467        if (bkpinfo->manual_cd_tray) {
468            fatal_error("Manual CD tray + DVD not supported yet.");
469            // -m isn't supported by growisofs, BTW...
470        } else {
471            sprintf(bkpinfo->call_make_iso,
472                    "%s %s -Z %s . 2>> _ERR_",
473                    mondo_mkisofs_sz, "", bkpinfo->media_device);
474        }
475        paranoid_free(mondo_mkisofs_sz);
476
477        if (getenv("SUDO_COMMAND")) {
478            fatal_error
479                ("Can't write DVDs as sudo because growisofs doesn't support this - please see the growisofs manpage for details.");
480        }
481        log_msg(2, "call_make_iso (DVD res) is ... %s",
482                bkpinfo->call_make_iso);
483    }                           // end of DVD code
484
485// CD-R or CD-RW
486    if (bkpinfo->backup_media_type == cdrw
487        || bkpinfo->backup_media_type == cdr) {
488        if (!bkpinfo->manual_cd_tray) {
489            asprintf(&extra_cdrom_params, "-waiti ");
490        }
491        if (bkpinfo->backup_media_type == cdrw) {
492            if (extra_cdrom_params != NULL) {
493                asprintf(&tmp, extra_cdrom_params);
494                paranoid_free(extra_cdrom_params);
495                asprintf(&extra_cdrom_params, "%s blank=fast ", tmp);
496            } else {
497                asprintf(&extra_cdrom_params, "blank=fast ");
498            }
499        }
500        if (find_home_of_exe("cdrecord")) {
501            asprintf(&cdr_exe, "cdrecord");
502        } else if (find_home_of_exe("dvdrecord")) {
503            asprintf(&cdr_exe, "dvdrecord");
504        } else {
505            fatal_error("Please install either cdrecord or dvdrecord.");
506        }
507        if (bkpinfo->nonbootable_backup) {
508            asprintf(&mondo_mkisofs_sz, "%s -r -p MondoRescue -publisher www.mondorescue.org -A Mondo_Rescue_GPL_Version -V _CD#_", mrconf->mondo_iso_creation_cmd);
509        } else if
510#ifdef __FreeBSD__
511            (TRUE)
512#else
513            (bkpinfo->make_cd_use_lilo)
514#endif
515#ifdef __IA64__
516    {
517        asprintf(&mondo_mkisofs_sz, MONDO_MKISOFS_REGULAR_ELILO);
518    }
519#else
520    {
521        asprintf(&mondo_mkisofs_sz, MONDO_MKISOFS_REGULAR_LILO);
522    }
523#endif
524        else
525        {
526            asprintf(&mondo_mkisofs_sz, MONDO_MKISOFS_REGULAR_SYSLINUX);
527        }
528        if (bkpinfo->manual_cd_tray) {
529            if (bkpinfo->call_before_iso[0] == '\0') {
530            sprintf(bkpinfo->call_before_iso,
531                        "%s -o %s/temporary.iso . 2>> _ERR_",
532                        mondo_mkisofs_sz, bkpinfo->tmpdir);
533                } else {
534                strncpy(call_before_iso_user, bkpinfo->call_before_iso, MAX_STR_LEN);
535                sprintf (bkpinfo->call_before_iso,
536                                    "( %s -o %s/temporary.iso . 2>> _ERR_ ; %s )",
537                        mondo_mkisofs_sz, bkpinfo->tmpdir, call_before_iso_user);
538            }
539            log_it("bkpinfo->call_before_iso = %s", bkpinfo->call_before_iso);
540            sprintf(bkpinfo->call_make_iso,
541                    "%s %s -v %s fs=4m dev=%s speed=%d %s/temporary.iso",
542                    cdr_exe, (bkpinfo->please_dont_eject) ? " " : "-eject",
543                    extra_cdrom_params, bkpinfo->media_device,
544                    bkpinfo->cdrw_speed, bkpinfo->tmpdir);
545        } else {
546            sprintf(bkpinfo->call_make_iso,
547                    "%s . 2>> _ERR_ | %s %s %s fs=4m dev=%s speed=%d -",
548                    mondo_mkisofs_sz, cdr_exe,
549                    (bkpinfo->please_dont_eject) ? " " : "-eject",
550                    extra_cdrom_params, bkpinfo->media_device,
551                    bkpinfo->cdrw_speed);
552        }
553        paranoid_free(mondo_mkisofs_sz);
554        paranoid_free(cdr_exe);
555        paranoid_free(extra_cdrom_params);
556    }                           // end of CD code
557
558    if (bkpinfo->backup_media_type == iso) {
559
560/* Patch by Conor Daly <conor.daly@met.ie>
561 * 23-june-2004
562 * Break up isodir into iso_mnt and iso_path
563 * These will be used along with iso-dev at restore time
564 * to locate the ISOs where ever they're mounted
565 */
566
567        log_it("isodir = %s", bkpinfo->isodir);
568        asprintf(&command, "df -P %s | tail -n1 | cut -d' ' -f1",
569                 bkpinfo->isodir);
570        log_it("command = %s", command);
571        asprintf(&tmp, call_program_and_get_last_line_of_output(command));
572        paranoid_free(command);
573        log_it("res of it = %s", tmp);
574        asprintf(&tmp1, "%s/ISO-DEV", bkpinfo->tmpdir);
575        write_one_liner_data_file(tmp1, tmp);
576        paranoid_free(tmp1);
577
578        asprintf(&command, "mount | grep -w %s | tail -n1 | cut -d' ' -f3",
579                 tmp);
580        paranoid_free(tmp);
581        log_it("command = %s", command);
582        asprintf(&tmp, call_program_and_get_last_line_of_output(command));
583        paranoid_free(command);
584        log_it("res of it = %s", tmp);
585
586        asprintf(&tmp1, "%s/ISO-MNT", bkpinfo->tmpdir);
587        write_one_liner_data_file(tmp1, tmp);
588        paranoid_free(tmp1);
589
590        log_it("isomnt: %s, %d", tmp, strlen(tmp));
591        if (strlen(bkpinfo->isodir) < strlen(tmp)) {
592            asprintf(&iso_path, " ");
593        } else {
594            asprintf(&iso_path, "%s", bkpinfo->isodir + strlen(tmp));
595        }
596        paranoid_free(tmp);
597
598        asprintf(&tmp, "%s/ISODIR", bkpinfo->tmpdir);
599        write_one_liner_data_file(tmp, iso_path);
600        paranoid_free(tmp);
601        log_it("isodir: %s", iso_path);
602        paranoid_free(iso_path);
603        asprintf(&tmp, "%s/ISO-PREFIX", bkpinfo->tmpdir);
604        write_one_liner_data_file(tmp, bkpinfo->prefix);
605        log_it("iso-prefix: %s",  bkpinfo->prefix);
606        paranoid_free(tmp);
607/* End patch */
608    }                           // end of iso code
609
610    if (bkpinfo->backup_media_type == nfs) {
611        asprintf(&hostname, bkpinfo->nfs_mount);
612        colon = strchr(hostname, ':');
613        if (!colon) {
614            log_it("nfs mount doesn't have a colon in it");
615            retval++;
616        } else {
617            struct hostent *hent;
618
619            *colon = '\0';
620            hent = gethostbyname(hostname);
621            if (!hent) {
622                log_it("Can't resolve NFS mount (%s): %s", hostname,
623                       hstrerror(h_errno));
624                retval++;
625            } else {
626                asprintf(&ip_address, "%s%s", inet_ntoa((struct in_addr)
627                                                        *((struct in_addr
628                                                           *) hent->
629                                                          h_addr)),
630                         strchr(bkpinfo->nfs_mount, ':'));
631                strcpy(bkpinfo->nfs_mount, ip_address);
632                paranoid_free(ip_address);
633            }
634        }
635        store_nfs_config(bkpinfo);
636        paranoid_free(hostname);
637    }
638
639    log_it("Finished processing incoming params");
640    if (retval) {
641        fprintf(stderr, "Type 'man mondoarchive' for help.\n");
642    }
643    asprintf(&tmp, "%s", MONDO_TMPISOS);
644    if (does_file_exist(tmp)) {
645        unlink(tmp);
646    }
647    paranoid_free(tmp);
648
649    if (strlen(bkpinfo->tmpdir) < 2 || strlen(bkpinfo->scratchdir) < 2) {
650        log_it("tmpdir or scratchdir are blank/missing");
651        retval++;
652    }
653    if (bkpinfo->include_paths[0] == '\0') {
654        //      fatal_error ("Why no backup path?");
655        strcpy(bkpinfo->include_paths, "/");
656    }
657    chmod(bkpinfo->scratchdir, 0700);
658    chmod(bkpinfo->tmpdir, 0700);
659    g_backup_media_type = bkpinfo->backup_media_type;
660    return (retval);
661}
662
663
664
665/**
666 * Do some miscellaneous setup tasks to be performed before filling @c bkpinfo.
667 * Seeds the random-number generator, loads important modules, checks the sanity
668 * of the user's Linux distribution, and deletes logfile.
669 * @param bkpinfo The backup information structure. Will be initialized.
670 * @return number of errors (0 for success)
671 */
672int pre_param_configuration(struct s_bkpinfo *bkpinfo)
673{
674    int res = 0;
675
676    make_hole_for_dir(MNT_CDROM);
677    assert(bkpinfo != NULL);
678    srandom((unsigned long) (time(NULL)));
679    insmod_crucial_modules();
680    reset_bkpinfo(bkpinfo);     // also sets defaults ('/'=backup path, 3=compression level)
681    if (bkpinfo->disaster_recovery) {
682        if (!does_nonMS_partition_exist()) {
683            fatal_error
684                ("I am in disaster recovery mode\nPlease don't run mondoarchive.");
685        }
686    }
687
688    unlink(MONDO_TRACEFILE);
689    run_program_and_log_output("rm -Rf /tmp/changed.files*", FALSE);
690    if ((g_mondo_home = find_and_store_mondoarchives_home()) == NULL) {
691        fprintf(stderr,
692                "Cannot find Mondo's homedir. I think you have >1 'mondo' directory on your hard disk. Please delete the superfluous 'mondo' directories and try again\n");
693        res++;
694        return (res);
695    }
696    res += some_basic_system_sanity_checks();
697    if (res) {
698        log_it("Your distribution did not pass Mondo's sanity test.");
699    }
700    g_current_media_number = 1;
701    bkpinfo->postnuke_tarball[0] = bkpinfo->nfs_mount[0] = '\0';
702    return (res);
703}
704
705
706
707
708/**
709 * Reset all fields of the backup information structure to a sensible default.
710 * @param bkpinfo The @c bkpinfo to reset.
711 */
712void reset_bkpinfo(struct s_bkpinfo *bkpinfo)
713{
714    int i;
715
716    log_msg(1, "Hi");
717    assert(bkpinfo != NULL);
718    memset((void *) bkpinfo, 0, sizeof(struct s_bkpinfo));
719    bkpinfo->manual_cd_tray = FALSE;
720    bkpinfo->internal_tape_block_size = DEFAULT_INTERNAL_TAPE_BLOCK_SIZE;
721    paranoid_free(bkpinfo->media_device);
722    for (i = 0; i <= MAX_NOOF_MEDIA; i++) {
723        bkpinfo->media_size[i] = -1;
724    }
725    bkpinfo->boot_loader = '\0';
726    bkpinfo->boot_device[0] = '\0';
727    bkpinfo->zip_exe[0] = '\0';
728    bkpinfo->zip_suffix[0] = '\0';
729    bkpinfo->restore_path[0] = '\0';
730    bkpinfo->use_lzo = FALSE;
731    bkpinfo->do_not_compress_these[0] = '\0';
732    bkpinfo->verify_data = FALSE;
733    bkpinfo->backup_data = FALSE;
734    bkpinfo->restore_data = FALSE;
735    bkpinfo->disaster_recovery =
736        (am_I_in_disaster_recovery_mode()? TRUE : FALSE);
737    if (bkpinfo->disaster_recovery) {
738        strcpy(bkpinfo->isodir, "/");
739    } else {
740        strcpy(bkpinfo->isodir, "/var/cache/mondo/iso");
741    }
742    strcpy(bkpinfo->prefix, STD_PREFIX);
743
744    bkpinfo->scratchdir[0] = '\0';
745    bkpinfo->make_filelist = TRUE;  // unless -J supplied to mondoarchive
746    sprintf(bkpinfo->tmpdir, "/tmp/tmpfs/mondo.tmp.%d", (int) (random() % 32768));  // for mondorestore
747    bkpinfo->optimal_set_size = 0;
748    bkpinfo->backup_media_type = none;
749    strcpy(bkpinfo->include_paths, "/");
750    bkpinfo->exclude_paths[0] = '\0';
751    bkpinfo->call_before_iso[0] = '\0';
752    bkpinfo->call_make_iso[0] = '\0';
753    bkpinfo->call_burn_iso[0] = '\0';
754    bkpinfo->call_after_iso[0] = '\0';
755    bkpinfo->image_devs[0] = '\0';
756    bkpinfo->postnuke_tarball[0] = '\0';
757    bkpinfo->kernel_path[0] = '\0';
758    bkpinfo->nfs_mount[0] = '\0';
759    bkpinfo->nfs_remote_dir[0] = '\0';
760    bkpinfo->wipe_media_first = FALSE;
761    bkpinfo->differential = FALSE;
762    bkpinfo->cdrw_speed = 0;
763// patch by Herman Kuster 
764    bkpinfo->differential = 0;
765// patch end
766    bkpinfo->compression_level = 3;
767}
768
769
770
771
772/**
773 * Get the remaining free space (in MB) on @p partition.
774 * @param partition The partition to check free space on (either a device or a mountpoint).
775 * @return The free space on @p partition, in MB.
776 */
777long free_space_on_given_partition(char *partition)
778{
779    char *command, *out_sz;
780    long res;
781
782    assert_string_is_neither_NULL_nor_zerolength(partition);
783
784    asprintf(&command, "df -m -P %s &> /dev/null", partition);
785    if (system(command)) {
786        return (-1);
787    }                           // partition does not exist
788    paranoid_free(command);
789
790    asprintf(&command, "df -m -P %s | tail -n1 | tr -s ' ' '\t' | cut -f4",
791             partition);
792    asprintf(&out_sz, call_program_and_get_last_line_of_output(command));
793    paranoid_free(command);
794    if (strlen(out_sz) == 0) {
795        return (-1);
796    }                           // error within df, probably
797    res = atol(out_sz);
798    paranoid_free(out_sz);
799    return (res);
800}
801
802
803
804/**
805 * Check the user's system for sanity. Checks performed:
806 * - make sure user has enough RAM (32mb required, 64mb recommended)
807 * - make sure user has enough free space in @c /
808 * - check kernel for ramdisk support
809 * - make sure afio, cdrecord, mkisofs, bzip2, awk, md5sum, strings, mindi, and buffer exist
810 * - make sure CD-ROM is unmounted
811 * - make sure /etc/modules.conf exists
812 * - make sure user's mountlist is OK by running <tt>mindi --makemountlist</tt>
813 *
814 * @return number of problems with the user's setup (0 for success)
815 */
816int some_basic_system_sanity_checks()
817{
818
819    /*@ buffers ************ */
820    char *tmp;
821
822    /*@ int's *************** */
823    int retval = 0;
824    long Lres;
825
826
827    mvaddstr_and_log_it(g_currentY, 0,
828                        "Checking sanity of your Linux distribution");
829#ifndef __FreeBSD__
830    if (system("which mkfs.vfat &> /dev/null")
831        && !system("which mkfs.msdos &> /dev/null")) {
832        log_it
833            ("OK, you've got mkfs.msdos but not mkfs.vfat; time for the fairy to wave her magic wand...");
834        run_program_and_log_output
835            ("ln -sf `which mkfs.msdos` /sbin/mkfs.vfat", FALSE);
836    }
837    asprintf(&tmp,
838             call_program_and_get_last_line_of_output
839             ("free | grep Mem | head -n1 | tr -s ' ' '\t' | cut -f2"));
840    if (atol(tmp) < 35000) {
841        retval++;
842        log_to_screen(_("You must have at least 32MB of RAM to use Mondo."));
843    }
844    if (atol(tmp) < 66000) {
845        log_to_screen
846            (_("WARNING! You have very little RAM. Please upgrade to 64MB or more."));
847    }
848    paranoid_free(tmp);
849#endif
850
851    if ((Lres = free_space_on_given_partition("/var/cache/mondo")) == -1) /* {
852        Lres = free_space_on_given_partition("/");
853    }
854    */
855    log_it("Free space on given partition = %ld MB", Lres);
856
857    if (Lres < 50) {
858        fatal_error("Your /var/cache/mondo partition has <50MB free. Please adjust your partition table to something saner."); 
859    }
860
861    if (system("which " MKE2FS_OR_NEWFS " > /dev/null 2> /dev/null")) {
862        retval++;
863        log_to_screen
864            ("Unable to find " MKE2FS_OR_NEWFS " in system path.");
865        fatal_error
866            ("Please use \"su -\", not \"su\" to become root. OK? ...and please don't e-mail the mailing list or me about this. Just read the message. :)");
867    }
868#ifndef __FreeBSD__
869    if (run_program_and_log_output
870        ("grep ramdisk /proc/devices", FALSE)) {
871        if (!ask_me_yes_or_no
872            (_("Your kernel has no ramdisk support. That's mind-numbingly stupid but I'll allow it if you're planning to use a failsafe kernel. Are you?")))
873        {
874            //          retval++;
875            log_to_screen
876                (_("It looks as if your kernel lacks ramdisk and initrd support."));
877            log_to_screen
878                (_("I'll allow you to proceed but FYI, if I'm right, your kernel is broken."));
879        }
880    }
881#endif
882    retval += whine_if_not_found(MKE2FS_OR_NEWFS);
883    retval += whine_if_not_found("mkisofs");
884    if (system("which dvdrecord > /dev/null 2> /dev/null")) {
885        retval += whine_if_not_found("cdrecord");
886    }
887    retval += whine_if_not_found("bzip2");
888    retval += whine_if_not_found("awk");
889    retval += whine_if_not_found("md5sum");
890    retval += whine_if_not_found("strings");
891    retval += whine_if_not_found("mindi");
892    retval += whine_if_not_found("buffer");
893
894    // abort if Windows partition but no ms-sys and parted
895    if (!run_program_and_log_output
896        ("mount | grep -w vfat | grep -v /dev/fd | grep -v nexdisk", 0)
897        ||
898        !run_program_and_log_output
899        ("mount | grep -w dos | grep -v /dev/fd | grep -v nexdisk", 0)) {
900        log_to_screen(_("I think you have a Windows 9x partition."));
901        retval += whine_if_not_found("parted");
902#ifndef __IA64__
903        /* IA64 always has one vfat partition for EFI even without Windows */
904        // retval +=
905        if (!find_home_of_exe("ms-sys")) {
906            log_to_screen(_("Please install ms-sys just in case."));
907        }
908#endif
909    }
910
911    if (!find_home_of_exe("cmp")) {
912        if (!find_home_of_exe("true")) {
913            whine_if_not_found("cmp");
914        } else {
915            log_to_screen
916                (_("Your system lacks the 'cmp' binary. I'll create a dummy cmp for you."));
917            if (run_program_and_log_output
918                ("cp -f `which true` /usr/bin/cmp", 0)) {
919                fatal_error("Failed to create dummy 'cmp' file.");
920            }
921        }
922    }
923    run_program_and_log_output
924        ("umount `mount | grep cdr | cut -d' ' -f3 | tr '\n' ' '`", 5);
925    asprintf(&tmp,
926             call_program_and_get_last_line_of_output
927             ("mount | grep -E \"cdr(om|w)\""));
928    if (strcmp("", tmp)) {
929        if (strstr(tmp, "autofs")) {
930            log_to_screen
931                (_("Your CD-ROM is mounted via autofs. I therefore cannot tell"));
932            log_to_screen
933                (_("if a CD actually is inserted. If a CD is inserted, please"));
934            log_to_screen(_("eject it. Thank you."));
935            log_it
936                ("Ignoring autofs CD-ROM 'mount' since we hope nothing's in it.");
937        } else
938            if (run_program_and_log_output("uname -a | grep Knoppix", 5)) {
939            retval++;
940            fatal_error
941                ("Your CD-ROM drive is mounted. Please unmount it.");
942        }
943    }
944    paranoid_free(tmp);
945#ifndef __FreeBSD__
946    if (!does_file_exist("/etc/modules.conf")) {
947        if (does_file_exist("/etc/conf.modules")) {
948            log_it("Linking /etc/modules.conf to /etc/conf.modules");
949            run_program_and_log_output
950                ("ln -sf /etc/conf.modules /etc/modules.conf", 5);
951        } else if (does_file_exist("/etc/modprobe.d")) {
952            log_it
953                ("Directory /etc/modprobe.d found. mindi will use its contents.");
954        } else if (does_file_exist("/etc/modprobe.conf")) {
955            log_it("Linking /etc/modules.conf to /etc/modprobe.conf");
956            run_program_and_log_output
957                ("ln -sf /etc/modprobe.conf /etc/modules.conf", 5);
958        } else {
959            retval++;
960            log_to_screen
961                (_("Please find out what happened to /etc/modules.conf"));
962        }
963    }
964#endif
965
966    run_program_and_log_output("cat /etc/fstab", 5);
967#ifdef __FreeBSD__
968    run_program_and_log_output("vinum printconfig", 5);
969#else
970    run_program_and_log_output("cat /etc/raidtab", 5);
971#endif
972
973    if (run_program_and_log_output("mindi -V", 1)) {
974        log_to_screen(_("Could not ascertain mindi's version number."));
975        log_to_screen
976            (_("You have not installed Mondo and/or Mindi properly."));
977        log_to_screen(_("Please uninstall and reinstall them both."));
978        fatal_error("Please reinstall Mondo and Mindi.");
979    }
980    if (run_program_and_log_output
981        ("mindi --makemountlist /tmp/mountlist.txt.test", 5)) {
982        log_to_screen
983            (_("Mindi --makemountlist /tmp/mountlist.txt.test failed for some reason."));
984        log_to_screen
985            (_("Please run that command by hand and examine /var/log/mindi.log"));
986        log_to_screen
987            (_("for more information. Perhaps your /etc/fstab file is insane."));
988        log_to_screen
989            (_("Perhaps Mindi's MakeMountlist() subroutine has a bug. We'll see."));
990        retval++;
991    }
992
993    if (!run_program_and_log_output("parted2fdisk -l | grep -i raid", 1)
994        && !does_file_exist("/etc/raidtab")) {
995        log_to_screen
996            (_("You have RAID partitions but no /etc/raidtab - creating one from /proc/mdstat"));
997        create_raidtab_from_mdstat("/etc/raidtab");
998    }
999
1000    if (retval) {
1001        mvaddstr_and_log_it(g_currentY++, 74, _("Failed."));
1002    } else {
1003        mvaddstr_and_log_it(g_currentY++, 74, _("Done."));
1004    }
1005    return (retval);
1006}
1007
1008/**
1009 * Retrieve the line containing @p label from the config file.
1010 * @param config_file The file to read from, usually @c /tmp/mondo-restore.cfg.
1011 * @param label What to read from the file.
1012 * @param value Where to put it.
1013 * @return 0 for success, 1 for failure.
1014 */
1015int read_cfg_var(char *config_file, char *label, char *value)
1016{
1017    /*@ buffer ****************************************************** */
1018    char *command;
1019    char *tmp;
1020
1021    /*@ end vars *************************************************** */
1022
1023    assert_string_is_neither_NULL_nor_zerolength(config_file);
1024    assert_string_is_neither_NULL_nor_zerolength(label);
1025    if (!does_file_exist(config_file)) {
1026        asprintf(&tmp, "(read_cfg_var) Cannot find %s config file",
1027                 config_file);
1028        log_to_screen(tmp);
1029        paranoid_free(tmp);
1030        value[0] = '\0';
1031        return (1);
1032    } else if (strstr(value, "/dev/") && strstr(value, "t0")
1033               && !strcmp(label, "media-dev")) {
1034        log_msg(2, "FYI, I shan't read new value for %s - already got %s",
1035                label, value);
1036        return (0);
1037    } else {
1038        asprintf(&command, "grep '%s .*' %s| cut -d' ' -f2,3,4,5",
1039                label, config_file);
1040        strcpy(value, call_program_and_get_last_line_of_output(command));
1041        paranoid_free(command);
1042        if (strlen(value) == 0) {
1043            return (1);
1044        } else {
1045            return (0);
1046        }
1047    }
1048}
1049
1050
1051
1052/**
1053 * Remount @c supermount if it was unmounted earlier.
1054 */
1055void remount_supermounts_if_necessary()
1056{
1057    if (g_remount_cdrom_at_end) {
1058        run_program_and_log_output("mount " MNT_CDROM, FALSE);
1059    }
1060    if (g_remount_floppy_at_end) {
1061        run_program_and_log_output("mount " MNT_FLOPPY, FALSE);
1062    }
1063}
1064
1065/**
1066 * Unmount @c supermount if it's mounted.
1067 */
1068void unmount_supermounts_if_necessary()
1069{
1070    if (run_program_and_log_output
1071        ("mount | grep cdrom | grep super", FALSE) == 0) {
1072        g_remount_cdrom_at_end = TRUE;
1073        run_program_and_log_output("umount " MNT_CDROM, FALSE);
1074    }
1075    if (run_program_and_log_output
1076        ("mount | grep floppy | grep super", FALSE) == 0) {
1077        g_remount_floppy_at_end = TRUE;
1078        run_program_and_log_output("umount " MNT_FLOPPY, FALSE);
1079    }
1080}
1081
1082/**
1083 * If this is a distribution like Gentoo that doesn't keep /boot mounted, mount it.
1084 */
1085void mount_boot_if_necessary()
1086{
1087    char *tmp;
1088    char *tmp1;
1089    char *command;
1090
1091    log_msg(1, "Started sub");
1092    log_msg(4, "About to set g_boot_mountpt to \"\"");
1093    asprintf(&g_boot_mountpt, "");
1094    log_msg(4, "Done. Great. Seeting command to something");
1095    asprintf(&command,
1096             "grep -v \":\" /etc/fstab | grep -vx \"#.*\" | grep -w \"/boot\" | tr -s ' ' '\t' | cut -f1 | head -n1");
1097    log_msg(4, "Cool. Command = '%s'", command);
1098    asprintf(&tmp, call_program_and_get_last_line_of_output(command));
1099    paranoid_free(command);
1100
1101    log_msg(4, "tmp = '%s'", tmp);
1102    if (tmp[0]) {
1103        log_it("/boot is at %s according to /etc/fstab", tmp);
1104        if (strstr(tmp, "LABEL=")) {
1105            if (!run_program_and_log_output("mount /boot", 5)) {
1106                paranoid_free(g_boot_mountpt);
1107                asprintf(&g_boot_mountpt, "/boot");
1108                log_msg(1, "Mounted /boot");
1109            } else {
1110                log_it("...ignored cos it's a label :-)");
1111            }
1112        } else {
1113            asprintf(&command, "mount | grep -w \"%s\"", tmp);
1114            log_msg(3, "command = %s", command);
1115            if (run_program_and_log_output(command, 5)) {
1116                paranoid_free(g_boot_mountpt);
1117                asprintf(&g_boot_mountpt, tmp);
1118                asprintf(&tmp1,
1119                         "%s (your /boot partition) is not mounted. I'll mount it before backing up",
1120                         g_boot_mountpt);
1121                log_it(tmp1);
1122                paranoid_free(tmp1);
1123
1124                asprintf(&tmp1, "mount %s", g_boot_mountpt);
1125                if (run_program_and_log_output(tmp1, 5)) {
1126                    paranoid_free(g_boot_mountpt);
1127                    asprintf(&g_boot_mountpt, " ");
1128                    log_msg(1, "Plan B");
1129                    if (!run_program_and_log_output("mount /boot", 5)) {
1130                        paranoid_free(g_boot_mountpt);
1131                        asprintf(&g_boot_mountpt, "/boot");
1132                        log_msg(1, "Plan B worked");
1133                    } else {
1134                        log_msg(1,
1135                                "Plan B failed. Unable to mount /boot for backup purposes. This probably means /boot is mounted already, or doesn't have its own partition.");
1136                    }
1137                }
1138                paranoid_free(tmp1);
1139            }
1140            paranoid_free(command);
1141        }
1142    }
1143    paranoid_free(tmp);
1144    log_msg(1, "Ended sub");
1145}
1146
1147
1148/**
1149 * If we mounted /boot earlier, unmount it.
1150 */
1151void unmount_boot_if_necessary()
1152{
1153    char *tmp;
1154
1155    log_msg(3, "starting");
1156    if (g_boot_mountpt[0]) {
1157        asprintf(&tmp, "umount %s", g_boot_mountpt);
1158        if (run_program_and_log_output(tmp, 5)) {
1159            log_it("WARNING - unable to unmount /boot");
1160        }
1161        paranoid_free(tmp);
1162    }
1163    log_msg(3, "leaving");
1164}
1165
1166
1167
1168/**
1169 * Write a line to a configuration file. Writes a line of the form,
1170 * @c label @c value.
1171 * @param config_file The file to write to. Usually @c mondo-restore.cfg.
1172 * @param label What to call this bit of data you're writing.
1173 * @param value The bit of data you're writing.
1174 * @return 0 for success, 1 for failure.
1175 */
1176int write_cfg_var(char *config_file, char *label, char *value)
1177{
1178    /*@ buffers ***************************************************** */
1179    char *command;
1180    char *tempfile;
1181    char *tmp;
1182
1183
1184    /*@ end vars *************************************************** */
1185    assert_string_is_neither_NULL_nor_zerolength(config_file);
1186    assert_string_is_neither_NULL_nor_zerolength(label);
1187    assert(value != NULL);
1188
1189    if (!does_file_exist(config_file)) {
1190        asprintf(&tmp, "(write_cfg_file) Cannot find %s config file",
1191                 config_file);
1192        log_to_screen(tmp);
1193        paranoid_free(tmp);
1194        return (1);
1195    }
1196    asprintf(&tempfile,
1197             call_program_and_get_last_line_of_output
1198             ("mktemp -q /tmp/mojo-jojo.blah.XXXXXX"));
1199    if (does_file_exist(config_file)) {
1200        asprintf(&command, "grep -vx '%s .*' %s > %s",
1201                label, config_file, tempfile);
1202        paranoid_system(command);
1203        paranoid_free(command);
1204    }
1205    asprintf(&command, "echo \"%s %s\" >> %s", label, value, tempfile);
1206    paranoid_system(command);
1207    paranoid_free(command);
1208
1209    asprintf(&command, "mv -f %s %s", tempfile, config_file);
1210    paranoid_system(command);
1211    paranoid_free(command);
1212    unlink(tempfile);
1213    paranoid_free(tempfile);
1214    return (0);
1215}
1216
1217/**
1218 * Allocate or free important globals, depending on @p mal.
1219 * @param mal If TRUE, malloc; if FALSE, free.
1220 */
1221void do_libmondo_global_strings_thing(int mal)
1222{
1223    if (mal) {
1224        iamhere("Malloc'ing globals");
1225        malloc_string(g_erase_tmpdir_and_scratchdir);
1226        malloc_string(g_serial_string);
1227        malloc_string(g_magicdev_command);
1228    } else {
1229        iamhere("Freeing globals");
1230        paranoid_free(g_boot_mountpt);
1231        paranoid_free(g_mondo_home);
1232        paranoid_free(g_tmpfs_mountpt);
1233        paranoid_free(g_erase_tmpdir_and_scratchdir);
1234        paranoid_free(g_serial_string);
1235        paranoid_free(g_magicdev_command);
1236    }
1237}
1238
1239/**
1240 * Allocate important globals.
1241 * @see do_libmondo_global_strings_thing
1242 */
1243void malloc_libmondo_global_strings(void)
1244{
1245    do_libmondo_global_strings_thing(1);
1246}
1247
1248/**
1249 * Free important globals.
1250 * @see do_libmondo_global_strings_thing
1251 */
1252void free_libmondo_global_strings(void)
1253{
1254    do_libmondo_global_strings_thing(0);
1255}
1256
1257
1258
1259/**
1260 * Stop @c magicdev if it's running.
1261 * The command used to start it is saved in @p g_magicdev_command.
1262 */
1263void stop_magicdev_if_necessary()
1264{
1265    strcpy(g_magicdev_command,
1266           call_program_and_get_last_line_of_output
1267           ("ps ax | grep -w magicdev | grep -v grep | tr -s '\t' ' '| cut -d' ' -f6-99"));
1268    if (g_magicdev_command[0]) {
1269        log_msg(1, "g_magicdev_command = '%s'", g_magicdev_command);
1270        paranoid_system("killall magicdev");
1271    }
1272}
1273
1274
1275/**
1276 * Restart magicdev if it was stopped.
1277 */
1278void restart_magicdev_if_necessary()
1279{
1280    char *tmp;
1281
1282    if (g_magicdev_command && g_magicdev_command[0]) {
1283        asprintf(&tmp, "%s &", g_magicdev_command);
1284        paranoid_system(tmp);
1285        paranoid_free(tmp);
1286    }
1287}
1288
1289/* @} - end of utilityGroup */
Note: See TracBrowser for help on using the repository browser.