-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathmkg.html
676 lines (676 loc) · 30.5 KB
/
mkg.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
<p><strong>USAGE:</strong><br />
<strong>mkg</strong> [1]<br />
<strong>mkg</strong> [[switch=argument]…] filename.iso [2]<br />
<strong>mkg</strong> [[switch=argument]…] [3]<br />
<strong>mkg</strong> help[=md] [4]</p>
<p>Usage [1] and [2] create a bootable ISO output file with a current<br />
Gentoo distribution.<br />
For [1], implicit ISO output name is <strong>gentoo.iso</strong><br />
Usage [3] creates a VirtualBox VDI dynamic disk and a virtual machine<br />
with name Gentoo.<br />
Usage [4] prints this help, in markdown form if argument ‘md’ is<br />
specified.<br />
Warning: you should have at least 55 GB of free disk space in the<br />
current directory or in vmpath if specified.</p>
<p>Arguments with white space (like <code>cflags="-O2 -march=..."</code>) should be<br />
written in list form with commas and no spaces: <code>cflags=[-O2,-march=...]</code><br />
The same holds for paths with white space.</p>
<p>As of March, 2021, part of the build is performed<br />
by <em>Github Actions</em> automatically. An ISO file of CloneZilla<br />
supplemented with VirtualBox guest additions will be downloaded<br />
from the resulting automated Github release. To disable this behavior<br />
you can add <code>use_clonezilla_workflow=false</code> to command line, or build the<br />
custom ISO file beforehand using the companion project<br />
<strong>clonezilla_with_virtualbox</strong>. In this case, add:<br />
<code>custom_clonezilla=your_build.iso</code><br />
to command line.<br />
Within containers, <code>use_clonezilla_workflow</code>, <code>build_virtualbox</code><br />
and <code>test_emerge</code> are not (yet) supported and will fail.<br />
A similar procedure also applies to the minimal Gentoo install ISO.<br />
MKG scripts and the stage3 archive are added within its squashfs filesystem<br />
by the <em>Github Actions</em> workflow of the MKG Github site.<br />
An ISO file labelled <strong>downloaded.iso</strong> is automatically released<br />
by the workflow. It will be downloaded from the MKG Github release section.<br />
This preprocessed ISO has build parameter presets. It builds the full desktop.<br />
In particular, the following command line options will be ignored:<br />
<code>bios, cflags, clonezilla_install, debug_mode, elist, emirrors,</code><br />
<code>kernel_config, minimal, minimal_size, ncpus, nonroot_user, passwd,</code><br />
<code>processor, rootpasswd, stage3, vm_keymap, vm_language.</code><br />
To disable this behavior you can add <code>use_mkg_workflow=false</code><br />
to command line. You will need to do so if you do not use OS build presets.</p>
<p><strong>Options:</strong></p>
<p>Boolean values are either <code>true</code> or <code>false</code>. For example, to build<br />
a minimal distribution, add to command line:<br />
<code>minimal=true</code><br />
or simply: <code>minimal</code> as <code>true</code> can be omitted (unlike <code>false</code>).</p>
<p><strong>Examples</strong></p>
<p><code>$ ./mkg pdfpage</code><br />
<code>$ ./mkg debug_mode verbose from_vm vm=Gentoo gentoo_small.iso</code> <code>ext_device=sdc device_installer blank burn cleanup=false</code><br />
<code># ./mkg download_arch=false download=false download_clonezilla=false</code> <code>custom_clonezilla=clonezilla_cached.iso use_mkg_workflow=false nonroot_user=phil</code><br />
<code># nohup ./mkg plot plot_color=red plot_period=10 plot_pause=7</code> <code>compact minimal minimal_size=false use_mkg_workflow=false gui=false elist=myebuilds</code> <code>[email protected] email_passwd='mypasswd' &</code><br />
<code># nohup ./mkg gui=false from_device=sdc gentoo_backup.iso &</code><br />
'# ./mkg dockerize minimal use_mkg_workflow=false ncpus=5 mem=10000 gentoo.iso`</p>
<p><strong>Type Conventions:</strong><br />
b: true/false Boolean<br />
o: on/off Boolean<br />
n: Integer<br />
f: Filepath<br />
d: Directory path<br />
e: Email address<br />
s: String<br />
u: URL</p>
<p>When a field depends on another, a colon separates the type and<br />
the name of the dependency. dep is a reserved word for dummy defaults of dependencies i.e.<br />
optional strings that may remain unspecified.<br />
Some options are incompatible, e.g. <code>test_only</code> and <code>use_mkg_workflow</code></p>
<table>
<colgroup>
<col style="width: 19%" />
<col style="width: 30%" />
<col style="width: 35%" />
<col style="width: 14%" />
</colgroup>
<thead>
<tr class="header">
<th style="text-align: center;">Option</th>
<th style="text-align: left;">Description</th>
<th style="text-align: center;">Default value</th>
<th style="text-align: center;">Type</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: center;">debug_mode</td>
<td style="text-align: left;">Do not clean up mkg custom logs at root of gentoo system files before VM shutdown. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">verbose</td>
<td style="text-align: left;">Increase verbosity</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">bios</td>
<td style="text-align: left;">Type of bootloader: BIOS or EFI (default)</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">blank</td>
<td style="text-align: left;">Blank rewritable optical disk before burning installation image.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">build_virtualbox</td>
<td style="text-align: left;">Download code source and automatically build virtualbox and tools. Yields VirtualBox and vbox-img executables under main directory and subdirectory virtualbox with the build, including documentation.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">burn</td>
<td style="text-align: left;">Burn to optical disc. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">cdrecord</td>
<td style="text-align: left;">cdrecord full path. Automatically determined if left unspecified.</td>
<td style="text-align: center;">[ <code>which cdrecord</code> ]</td>
<td style="text-align: center;">f:burn</td>
</tr>
<tr class="even">
<td style="text-align: center;">cflags</td>
<td style="text-align: left;">GCC CFLAGS options for ebuilds</td>
<td style="text-align: center;">[ [-march=native,-O2] ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">cleanup</td>
<td style="text-align: left;">Clean up archives, temporary images and virtual machine after successful completion. Boolean.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">clonezilla_install</td>
<td style="text-align: left;">Use the CloneZilla live CD instead of the official Gentoo minimal install CD. May be more robust for headless install, owing to a VB bug requiring artificial keyboard input (see doc).</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">cloning_method</td>
<td style="text-align: left;">Method used by hot_install ext_device=… to intall Gentoo to disk. One of: ‘guestfish’ (default) or ‘qemu’</td>
<td style="text-align: center;">[ guestfish ]</td>
<td style="text-align: center;">s:ext_device</td>
</tr>
<tr class="even">
<td style="text-align: center;">compact</td>
<td style="text-align: left;">Compact virtual disk after VM building. Caution: this may impede hot_install and ext_device.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">cpuexecutioncap</td>
<td style="text-align: left;">Maximum percentage of CPU per core (0 to 100)</td>
<td style="text-align: center;">[ 100 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">CRAN_REPOS</td>
<td style="text-align: left;">CRAN repository URL for downloading extra R packages</td>
<td style="text-align: center;">[ https://cloud.r-project.org ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">create_squashfs</td>
<td style="text-align: left;">(Re)create the squashfs filesystem. Boolean.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">custom_clonezilla</td>
<td style="text-align: left;">Use this previously created custom CloneZilla ISO with added VirtualBox and guest additions.</td>
<td style="text-align: center;">[ dep ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">device_installer</td>
<td style="text-align: left;">Create Gentoo clone installer on external device. <strong>ext_device</strong> value must be specified.</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;"></td>
</tr>
<tr class="even">
<td style="text-align: center;">disable_checksum</td>
<td style="text-align: left;">Disable checkum verification after downloads. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">disconnect</td>
<td style="text-align: left;">Unmount guest virtual disk from host.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">dockerize</td>
<td style="text-align: left;">Use a pre-built Docker image to run MKG into. Incompatible with e.g. ‘gui’, ‘hot_install’, ‘plot’, ‘test_emerge’</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">docker_image_path</td>
<td style="text-align: left;">URL to ../‘workflow_tag2’/mygentoo-‘workflow_tag2’.tar.xz</td>
<td style="text-align: center;">[ path5 ]</td>
<td style="text-align: center;">s:workflow_tag2</td>
</tr>
<tr class="even">
<td style="text-align: center;">download</td>
<td style="text-align: left;">Download install ISO image from Gentoo mirror. Boolean.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">download_arch</td>
<td style="text-align: left;">Download and install stage3 archive to virtual disk. Booelan.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">download_clonezilla</td>
<td style="text-align: left;">Refresh CloneZilla ISO download. An ISO file must have been downloaded to create the recovery image of the Gentoo platform once the virtual machine has ended its job. Boolean</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">download_clonezilla_path</td>
<td style="text-align: left;">Download the following CloneZilla ISO</td>
<td style="text-align: center;">[ path1 ]</td>
<td style="text-align: center;">u</td>
</tr>
<tr class="even">
<td style="text-align: center;">download_only</td>
<td style="text-align: left;">Only download the Gentoo minimal install ISO and stage3 archive of the day, then exit.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">efi_size</td>
<td style="text-align: left;">Size of EFI partition in MiB.</td>
<td style="text-align: center;">[ 512 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">elist</td>
<td style="text-align: left;">File containing a list of Gentoo ebuilds to add to the VM on top of stage3. Note: if the default value is not used, adjust the names of the ‘elist’.accept_keywords and ‘elist’.use files</td>
<td style="text-align: center;">[ ebuilds.list ]</td>
<td style="text-align: center;">f</td>
</tr>
<tr class="odd">
<td style="text-align: center;">email</td>
<td style="text-align: left;">Email address to send a warning to upon build completion. Note: you will have to accept so-called <em>insecure software</em> with some providers. It is not insecure if you are using your private PC throughout.</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;">e</td>
</tr>
<tr class="even">
<td style="text-align: center;">email_passwd</td>
<td style="text-align: left;">Email password</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;">s:email</td>
</tr>
<tr class="odd">
<td style="text-align: center;">emirrors</td>
<td style="text-align: left;">Mirror sites for downloading ebuilds</td>
<td style="text-align: center;">[ path2 ]</td>
<td style="text-align: center;">u</td>
</tr>
<tr class="even">
<td style="text-align: center;">ext_device</td>
<td style="text-align: left;">Create Gentoo OS on external device. Argument is either a device label (e.g. sdb, hdb), or a mountpoint directory (if mounted), or a few consecutive letters of the vendor name (e.g. ‘Samsu’, ‘PNY’ or ‘Kingst’), if there is just one such. Requires <em>hot_install</em> on commandline.</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">force</td>
<td style="text-align: left;">Forcefully creates machine even if others with same same exist. Stops and restarts VBox daemons. Not advised if other VMs are running.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">from_device</td>
<td style="text-align: left;">Do not Generate Gentoo but use the external device on which Gentoo was previously installed. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b:ext_device</td>
</tr>
<tr class="odd">
<td style="text-align: center;">from_iso</td>
<td style="text-align: left;">Do not generate Gentoo but use the bootable ISO given on commandline.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">from_vm</td>
<td style="text-align: left;">Do not generate Gentoo but use the VM. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">full_cleanup</td>
<td style="text-align: left;">Remove virtual disk, archives and ISO files on clean-up</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">github_release_path</td>
<td style="text-align: left;">URL to Github Release of clonezilla_with_virtualbox.iso</td>
<td style="text-align: center;">[ path3 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">github_release_path2</td>
<td style="text-align: left;">URL to Github Release of preprocessed_gentoo_install.iso</td>
<td style="text-align: center;">[ path4 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">gui</td>
<td style="text-align: left;">Binary: true corresponds to VBoxManage startvm … –type=gui, false to –type=headless</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">help</td>
<td style="text-align: left;">This help</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;"></td>
</tr>
<tr class="even">
<td style="text-align: center;">hot_install</td>
<td style="text-align: left;">Intall to Gentoo attached device (like /dev/sdb) possibly mounted (like /media/USER/567EAF). To be used with <em>ext_device=…</em></td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b:ext_device</td>
</tr>
<tr class="odd">
<td style="text-align: center;">htmlpage</td>
<td style="text-align: left;">Create HTML help page</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">hwvirtex</td>
<td style="text-align: left;">Activate HWVIRTEX: on/off</td>
<td style="text-align: center;">[ on ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">interactive</td>
<td style="text-align: left;">Allow interaction with user. This may cause deadlock if process is detached from the console (<em>nohup</em> or other methods)</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">ioapic</td>
<td style="text-align: left;">IOAPIC parameter: on or off</td>
<td style="text-align: center;">[ on ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">kernel_config</td>
<td style="text-align: left;">Use a custom kernel config file</td>
<td style="text-align: center;">[ .config ]</td>
<td style="text-align: center;">f</td>
</tr>
<tr class="even">
<td style="text-align: center;">livecd</td>
<td style="text-align: left;">Path to the live CD that will start the VM</td>
<td style="text-align: center;">[ gentoo.iso ]</td>
<td style="text-align: center;">f</td>
</tr>
<tr class="odd">
<td style="text-align: center;">logging</td>
<td style="text-align: left;">Activate logging</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">manpage</td>
<td style="text-align: left;">Create manpage mkg.1</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">mem</td>
<td style="text-align: left;">VM RAM memory in MiB</td>
<td style="text-align: center;">[ 8000 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">minimal</td>
<td style="text-align: left;">Remove <em>libreoffice</em> and <em>data science tools</em> from default list of installed software. Boolean.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">minimal_size</td>
<td style="text-align: left;">Remove kernel sources to minimize packaging. Not advised for personal use but OK for deployment and distribution.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">mirror</td>
<td style="text-align: left;">Mirror site for downloading of stage3 tarball</td>
<td style="text-align: center;">[ path2 ]</td>
<td style="text-align: center;">u</td>
</tr>
<tr class="odd">
<td style="text-align: center;">ncpus</td>
<td style="text-align: left;">Number of VM CPUs. By default the third of available threads.</td>
<td style="text-align: center;">[ count ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">no_run</td>
<td style="text-align: left;">If using <strong>share_root=‘r’ or ‘w’</strong>, do not run the virtual machine but use the VDI disk corresponding to vm=… Otherwise start 15 minutes later.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">nonroot_user</td>
<td style="text-align: left;">Non-root user</td>
<td style="text-align: center;">[ fab ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">pae</td>
<td style="text-align: left;">Activate PAE: on/off</td>
<td style="text-align: center;">[ on ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">paravirtprovider</td>
<td style="text-align: left;">Virtualization interface: kvm for GNU/Linux, may be tweaked (see VirtualBox documentation)</td>
<td style="text-align: center;">[ kvm ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">passwd</td>
<td style="text-align: left;">User password</td>
<td style="text-align: center;">[ _user2021_ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">pdfpage</td>
<td style="text-align: left;">Create PDF help page</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">plot</td>
<td style="text-align: left;">Plot VDI disk size using GNUPlot</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">plot_color</td>
<td style="text-align: left;">Plot line color between simple quotes (e.g: ‘cyan’,‘red’ etc.)</td>
<td style="text-align: center;">[ ‘cyan’ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">plot_pause</td>
<td style="text-align: left;">Number of seconds of plot display per minute of processing. Maximum 50.</td>
<td style="text-align: center;">[ 5 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="odd">
<td style="text-align: center;">plot_period</td>
<td style="text-align: left;">Number of minutes elapsed between two successive plots</td>
<td style="text-align: center;">[ 10 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">plot_position</td>
<td style="text-align: left;">Plot position of on monitor screen (top-left angle) in pixels e.g ‘0,0’ or ‘500,500’</td>
<td style="text-align: center;">[ ‘0,0’ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">plot_span</td>
<td style="text-align: left;">Number of minutes of virtual disk processing to be plotted, back in time</td>
<td style="text-align: center;">[ 1200 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">processor</td>
<td style="text-align: left;">Processor type</td>
<td style="text-align: center;">[ amd64 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">pull</td>
<td style="text-align: left;">Invoke ‘git pull’ in mkg local repository on startup.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">quiet_mode</td>
<td style="text-align: left;">Silence output except for the most severe errors.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">rootpasswd</td>
<td style="text-align: left;">Root password</td>
<td style="text-align: center;">[ _dev2021_ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">rtcuseutc</td>
<td style="text-align: left;">Use UTC as time reference: on/off</td>
<td style="text-align: center;">[ on ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">scsi_address</td>
<td style="text-align: left;">In case of several optical disc burners, specify the SCSI address as x,y,z</td>
<td style="text-align: center;">[ ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">shared_dir</td>
<td style="text-align: left;">Host mount point for guest virtual disk filesystem</td>
<td style="text-align: center;">[ /vdi ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">share_root</td>
<td style="text-align: left;">Mount guest virtual disk to host folder <strong>shared_folder</strong>. Argument is ‘w’ to enable write I/O otherwise read-only mode is assumed. May raise security issues, see Wiki.</td>
<td style="text-align: center;">[ dep ]</td>
<td style="text-align: center;">s:shared_dir</td>
</tr>
<tr class="even">
<td style="text-align: center;">size</td>
<td style="text-align: left;">Dynamic disc size</td>
<td style="text-align: center;">[ 55000 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="odd">
<td style="text-align: center;">smtp_url</td>
<td style="text-align: left;">SMTP URL of email provider for end-of-job warning. Default: gmail SMTP</td>
<td style="text-align: center;">[ smtps://smtp.gmail.com:465 ]</td>
<td style="text-align: center;">u</td>
</tr>
<tr class="even">
<td style="text-align: center;">stage3</td>
<td style="text-align: left;">Path to stage3 archive</td>
<td style="text-align: center;">[ stage3.tar.xz ]</td>
<td style="text-align: center;">f</td>
</tr>
<tr class="odd">
<td style="text-align: center;">swap_size</td>
<td style="text-align: left;">Size of swap partition in MiB.</td>
<td style="text-align: center;">[ 1024 ]</td>
<td style="text-align: center;">n</td>
</tr>
<tr class="even">
<td style="text-align: center;">test_emerge</td>
<td style="text-align: left;">Test whether emerge will be able to install packages in the VM before starting it.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">test_only</td>
<td style="text-align: left;">Only test if portage will be able to install packages. Do not create a virtual machine.</td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">timezone</td>
<td style="text-align: left;">Set timezone. See /usr/share/zoneinfo for formats.</td>
<td style="text-align: center;">[ US/Eastern ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">usbehci</td>
<td style="text-align: left;">Activate USB2 driver: on/off</td>
<td style="text-align: center;">[ off ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="even">
<td style="text-align: center;">usbxhci</td>
<td style="text-align: left;">Activate USB3 driver: on/off. Note: if on, needs extension pack.</td>
<td style="text-align: center;">[ off ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">use_bsdtar</td>
<td style="text-align: left;">Use ‘bsdtar’ (from libarchive) to extract CloneZilla ISO files if creating an ISO installer.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">use_clonezilla_workflow</td>
<td style="text-align: left;">Use Github Actions workflow to add virtualbox guest additions to CloneZilla ISO.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">use_mkg_workflow</td>
<td style="text-align: left;">Use Github Actions workflow to preprocess minimal Gentoo ISO by adding MKG scripts inside the squashfs filesystem.</td>
<td style="text-align: center;">[ true ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="even">
<td style="text-align: center;">use_qemu</td>
<td style="text-align: left;">Use qemu instead of guestfish for installing Gentoo to block device with <strong>hot_install</strong></td>
<td style="text-align: center;">[ false ]</td>
<td style="text-align: center;">b</td>
</tr>
<tr class="odd">
<td style="text-align: center;">vbox_version</td>
<td style="text-align: left;">Virtualbox version</td>
<td style="text-align: center;">[ 6.1.16 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">vbox_version_full</td>
<td style="text-align: left;">Virtualbox full version</td>
<td style="text-align: center;">[ 6.1.16 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">vbpath</td>
<td style="text-align: left;">Path to VirtualBox directory</td>
<td style="text-align: center;">[ /usr/bin ]</td>
<td style="text-align: center;">d</td>
</tr>
<tr class="even">
<td style="text-align: center;">vm</td>
<td style="text-align: left;">Virtual Machine name. Unless ‘force=true’ is used, a time stamp will be appended to avoid registry issues with prior VMs of the same name.</td>
<td style="text-align: center;">[ Gentoo ]</td>
<td style="text-align: center;">vm</td>
</tr>
<tr class="odd">
<td style="text-align: center;">vm_keymap</td>
<td style="text-align: left;">Add support for non-US English keymaps. Use values in /usr/share/keymaps, e.g. fr, de, us.</td>
<td style="text-align: center;">[ us ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">vm_language</td>
<td style="text-align: left;">Add support for non-US English language as a default. Use standard abbreviations. Must be at least 5 characters: e.g. fr_FR, de_DE, fr_FR.utf8</td>
<td style="text-align: center;">[ en_US.utf8 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="odd">
<td style="text-align: center;">vmpath</td>
<td style="text-align: left;">Path to VM base directory</td>
<td style="text-align: center;">[ $PWD ]</td>
<td style="text-align: center;">d</td>
</tr>
<tr class="even">
<td style="text-align: center;">vtxvpid</td>
<td style="text-align: left;">Activate VTXVPID: on/off</td>
<td style="text-align: center;">[ on ]</td>
<td style="text-align: center;">o</td>
</tr>
<tr class="odd">
<td style="text-align: center;">workflow_tag</td>
<td style="text-align: left;">Tag version (vX.Y) of the release of file clonezilla_with_virtualbox by Github Actions</td>
<td style="text-align: center;">[ v1.8 ]</td>
<td style="text-align: center;">s</td>
</tr>
<tr class="even">
<td style="text-align: center;">workflow_tag2</td>
<td style="text-align: left;">Tag version (vX.Y) of the release of file preprocessed_gentoo_install.iso by Github Actions (MKG site)</td>
<td style="text-align: center;">[ release-master or release-gnome ]</td>
<td style="text-align: center;">s</td>
</tr>
</tbody>
</table>
<p><strong>path1:</strong> https://sourceforge.net/projects/clonezilla/files/clonezilla_live_alternative/20200703-focal/clonezilla-live-20200703-focal-amd64.iso/download<br />
<strong>path2:</strong> http://gentoo.mirrors.ovh.net/gentoo-distfiles/<br />
<strong>path3:</strong> https://github.com/fabnicol/clonezilla_with_virtualbox<br />
<strong>path4:</strong> https://github.com/fabnicol/mkg/releases/download<br />
<strong>count:</strong> nproc –all / 3</p>