Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/modules/sd_card_image/README
blob: 0deda3052b638915bfb84dbace61baecc132c6a9 (plain)
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
This module creates ext4 SD card images from the build output. These
images contain partition tables and 2 partitions.

These images are in the "ZD" format, suitable for flashing via OpenFirmware's
fs-update command. Corresponding .zsp files are produced too. To disable
.zd/.zsp creation, set the make_zd option to 0 (default is 1).

The SD card sizes must be specified, in bytes. This module can create
filesystems for multiple SD card capacities. Simply provide a list of
uniquely-named options that start with "size_", one for each SD card size.

The value for each of these options is the disk size (in bytes), optionally
followed by a comma and a custom extension. There can only be one un-named
entry, which will default to the extension "zd".

For example:
[sd_card_image]
; 3780mb
size_1=3964665000
; 1985mb
size_2=1977614336,zd2

The output files will be:

	(the 3780mb disk output)
	osXX.zd
	osXX.zsp

	(the 1985mb disk output)
	osXX.zd2
	osXX.zd2.zsp

A "keep_disk_image" option is available, which can be used to retain the
raw disk image file (basically a file that looks like a block device) that was
used to produce the ZD image, which you could flash with Linux using the "dd"
command.

For example:

[sd_card_image]
keep_disk_image=1
size_1=3964665000

The output files will be:

	osXX.zd
	osXX.zsp
	osXX.zd.disk.img.tar.gz

The raw image file is archived in tar (in sparse mode) and then compressed with
gzip. Tar preserves the sparseness of the file (the fact that some part of the
image is made up of unallocated disk blocks). To disable this
archiving/compression, set the compress_disk_image option to 0 (default is 1).