1 | .\" Copyright (c) 2005 Andree Leidenfrost |
---|
2 | .\" |
---|
3 | .\" This is free documentation; you can redistribute it and/or |
---|
4 | .\" modify it under the terms of the GNU General Public License as |
---|
5 | .\" published by the Free Software Foundation; either version 2 of |
---|
6 | .\" the License, or (at your option) any later version. |
---|
7 | .\" |
---|
8 | .\" The GNU General Public License's references to "object code" |
---|
9 | .\" and "executables" are to be interpreted as the output of any |
---|
10 | .\" document formatting or typesetting system, including |
---|
11 | .\" intermediate and printed output. |
---|
12 | .\" |
---|
13 | .\" This manual is distributed in the hope that it will be useful, |
---|
14 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
15 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
16 | .\" GNU General Public License for more details. |
---|
17 | .\" |
---|
18 | .\" You should have received a copy of the GNU General Public |
---|
19 | .\" License along with this manual; if not, write to the Free |
---|
20 | .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, |
---|
21 | .\" USA. |
---|
22 | .\" |
---|
23 | .TH MINDI 8 "DDD" "Mondo Rescue VVV-rRRR" |
---|
24 | .SH NAME |
---|
25 | mindi \- a tool for creating boot/root disks |
---|
26 | .SH SYNOPSIS |
---|
27 | .B mindi |
---|
28 | .br |
---|
29 | .BR "mindi -v"| " --version"| " -V"| " -version" |
---|
30 | .br |
---|
31 | .BI "mindi --findkernel" |
---|
32 | .br |
---|
33 | .BI "mindi --makemountlist "file |
---|
34 | .br |
---|
35 | .BI "mindi [--max-compressed-size "max "] --custom " parameters |
---|
36 | .SH DESCRIPTION |
---|
37 | .PP |
---|
38 | .B mindi |
---|
39 | creates a set of boot/root floppy disk images and/or a bootable ISO image using |
---|
40 | files from the system it runs on. |
---|
41 | .B mindi |
---|
42 | will try hard to reproduce the environment of its host system including loaded |
---|
43 | modules to ensure that the system can be booted properly from the created |
---|
44 | rescue media. |
---|
45 | .B mindi |
---|
46 | is used by |
---|
47 | .B monodarchive(8) |
---|
48 | to produce the required boot/root floppy or CD images but can also be used |
---|
49 | stand-alone. |
---|
50 | |
---|
51 | For stand-alone usage, |
---|
52 | .B mindi |
---|
53 | is called without any parameters or switches. It will then interactively ask |
---|
54 | the user for all information required to create a set of boot/root media. |
---|
55 | .LP |
---|
56 | The probably more frequent way of calling |
---|
57 | .B mindi |
---|
58 | is non-interactively from |
---|
59 | .B mondoarchive(8) |
---|
60 | using the |
---|
61 | .B --custom |
---|
62 | switch. All required information is then provided via command line parameters. |
---|
63 | The sequence of these parameters is listed below. |
---|
64 | .SH OPTIONS |
---|
65 | .TP |
---|
66 | .BR "-v"| " --version"| " -V"| " -version" |
---|
67 | Prints the version of mindi. |
---|
68 | .TP |
---|
69 | .B --findkernel |
---|
70 | Finds the image of the running kernel in the file system. |
---|
71 | .TP |
---|
72 | .BI "--makemountlist "file |
---|
73 | .RI "Creates a mount list and writes it to file "file ". |
---|
74 | .TP |
---|
75 | .BI "--max-compressed-size "max |
---|
76 | Maximum size for disk image in KB. |
---|
77 | .TP |
---|
78 | .BI "--custom " parameters |
---|
79 | Provide all required parameters to |
---|
80 | .B mindi |
---|
81 | for non-interactive calling. This usually means a call from |
---|
82 | .BR "mondoarchive(8)". |
---|
83 | The following parameters are used: |
---|
84 | .br |
---|
85 | 01) directory to use for temporary files |
---|
86 | .br |
---|
87 | 02) directory to put disk images in |
---|
88 | .br |
---|
89 | 03) path to kernel image |
---|
90 | .br |
---|
91 | 04) tape device |
---|
92 | .br |
---|
93 | 05) tape size [MB] |
---|
94 | .br |
---|
95 | 06) total number of files in file list |
---|
96 | .br |
---|
97 | 07) use LZO [yes|no] |
---|
98 | .br |
---|
99 | 08) CD recovery media [yes|no] |
---|
100 | .br |
---|
101 | 09) devices to include |
---|
102 | .br |
---|
103 | 10) conservative LiLo settings [yes|no] |
---|
104 | .br |
---|
105 | 11) number of last file list |
---|
106 | .br |
---|
107 | 12) estimated total number of slices |
---|
108 | .br |
---|
109 | 13) devices to exclude |
---|
110 | .br |
---|
111 | 14) compare mode [yes|no] |
---|
112 | .br |
---|
113 | 15) use lilo [yes|no] |
---|
114 | .br |
---|
115 | 16) use star (rather than tar) [yes|no] |
---|
116 | .br |
---|
117 | 17) internal tape block size [bytes] |
---|
118 | .br |
---|
119 | 18) number of diffenrential backup |
---|
120 | .br |
---|
121 | 19) make non-bootable [yes|no] |
---|
122 | .br |
---|
123 | (Blank parameters must be specified as "" on the command line.) |
---|
124 | .SH DIAGNOSTICS |
---|
125 | .B mindi |
---|
126 | writes some output to the console and extensive information to log file |
---|
127 | .IR /var/log/mindi.log ". |
---|
128 | When seeking technical support for |
---|
129 | .BR "mindi", |
---|
130 | please attach this file to your email. |
---|
131 | .SH FILES |
---|
132 | .TP |
---|
133 | .I /var/log/mindi.log |
---|
134 | Log file of mindi run. Contains important information to analyze mindi problem |
---|
135 | reports. |
---|
136 | .TP |
---|
137 | .I /etc/mindi/deplist.txt |
---|
138 | List of files to be included on boot/root disks. |
---|
139 | .TP |
---|
140 | .I /var/cache/mindi/N.tar.gz |
---|
141 | Number N of multiple tar balls together containing root file system for rescue |
---|
142 | media. |
---|
143 | .TP |
---|
144 | .I /var/cache/mindi/all.tar.gz |
---|
145 | Single tar ball of root file system for rescue media. |
---|
146 | .TP |
---|
147 | .I /var/cache/mindi/initrd.img |
---|
148 | initrd image for bootable ISO image. |
---|
149 | .TP |
---|
150 | .I /var/cache/mindi/mindi-boot.F.img |
---|
151 | .B mindi |
---|
152 | boot floppy of size F [KB]. |
---|
153 | .TP |
---|
154 | .I /var/cache/mindi/mindi-root.F.img |
---|
155 | .B mindi |
---|
156 | root floppy of size F [KB]. |
---|
157 | .TP |
---|
158 | .I /var/cache/mindi/mindi-data.N.img |
---|
159 | .B mindi |
---|
160 | data floppy number N for boot/root floppies. |
---|
161 | .TP |
---|
162 | .I /var/cache/mindi/mindi.iso |
---|
163 | .B mindi |
---|
164 | bootable ISO image. |
---|
165 | .SH CONFIGURATION FILE |
---|
166 | You may create a mindi configuration file under |
---|
167 | .B /etc/mindi |
---|
168 | called |
---|
169 | .B mindi.conf |
---|
170 | which overwrites default values by setting up the following variables: |
---|
171 | .TP |
---|
172 | .I TMPDIR |
---|
173 | .B (default /tmp): directory to create temporary files |
---|
174 | .br |
---|
175 | .TP |
---|
176 | .I EXTRA_SPACE |
---|
177 | .B (default 24576): increase if you run out of ramdisk space |
---|
178 | .br |
---|
179 | .TP |
---|
180 | .I IA64_BOOT_SIZE |
---|
181 | .B (default 8192): size of the ia64 boot disk |
---|
182 | .br |
---|
183 | .TP |
---|
184 | .I CACHE_LOC |
---|
185 | .B (default /var/cache/mindi): directory where boot/root files |
---|
186 | and iso are generated |
---|
187 | .br |
---|
188 | WARNING: This directory is erased before usage |
---|
189 | .br |
---|
190 | .SH "SEE ALSO" |
---|
191 | mondoarchive(8), mondorestore(8). |
---|
192 | .TP |
---|
193 | See mailing list at http://www.mondorescue.org for technical support. |
---|
194 | .SH AUTHORS |
---|
195 | Bruno Cornec (lead-development) |
---|
196 | .I "bcornec_at_mondorescue.org" |
---|
197 | .br |
---|
198 | Andree Leidenfrost (co-developper) |
---|
199 | .I "aleidenf_at_bigpond.net.au" |
---|
200 | .br |
---|
201 | .SH ORIGINAL AUTHORS |
---|
202 | Hugo Rabson (original author) |
---|
203 | .I "hugo.rabson_at_mondorescue.org" |
---|
204 | .br |
---|
205 | Jesse Keating (packaging) |
---|
206 | .I "hosting_at_j2solutions.net" |
---|
207 | .br |
---|
208 | Stan Benoit (testing) |
---|
209 | .I "troff_at_nakedsoul.org" |
---|
210 | .br |
---|
211 | Mikael Hultgren (docs) |
---|
212 | .I "mikael_hultgren_at_gmx.net" |
---|
213 | .br |
---|
214 | . |
---|