source: MondoRescue/branches/stable/mondo/src/common/libmondo-tools.c@ 1344

Last change on this file since 1344 was 1344, checked in by Bruno Cornec, 17 years ago

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