2
1. Format of the recipe files
3
2. Architecture specific recipes
7
1. FORMAT OF THE RECIPE FILES
8
-----------------------------
10
All new lines and tabulations in the recipe are converted to spaces.
11
Then two or more consecutive spaces are converted to one space.
12
Almost all tokens must be separated by spaces. An important exception
13
is the opening curly bracket ("{"), before it there must be _no_
16
In the following rules we denote spaces by "_".
18
<recipe>::=<header>_<partitions>
20
<header>::=<simple name>|<debconf name>
22
<simple name>::=<name>_:
24
<name> can be for example "Multi user system".
26
<debconf name>::=<debconf template>_::
28
The purpose of <debconf name> is to allow translation of the names of
29
the recipes into different languages.
31
<partitions>::=<partition>|<partition>_<partitions>
33
<partition>::=<limits>_<specifiers>_.
35
<limits>::=<minimal size>_<priority>_<maximal size>_<parted fs>
37
<minimal size> is the minimal allowed size of the partition in
38
megabytes. It is rounded to cylinder size, so if you make <minimal
39
size> to be 20 MB and the cylinder size is 12MB, then it is possible
40
for the partition to be only 12MB.
42
<maximal size> is the maximal size for the partition, i.e. a limit
43
size such that there is no sense to make this partition larger.
45
<priority> is some size usually between <minimal size> and <maximal
46
size>. It determines the priority of this partition in the contest
47
with the other partitions for size. Notice that if <priority> is too
48
small (relative to the priority of the other partitions) then this
49
partition will have size close to <minimal size>. That's why it is
50
recommended to give small partitions a <priority> larger than their
53
<parted fs> is the file system as known to parted of this partition.
56
<specifiers>::=<specifier>|<specifier>_<specifiers>
58
<specifier>::=<internal specifier>|<regular specifier>
60
<internal specifier>::=$primary{_}|$bootable{_}
62
$primary{_} says that the partition should be primary (if possible).
63
$bootable{_} says that the bootable flag will be set.
65
<regular specifier>::=<file name>{ <file contents> }
67
<file name> is a file to be created in the directory of the partition.
68
<file contents> is the information to write in this file.
71
2. ARCHITECTURE DEPENTENT RECIPES
72
---------------------------------
74
Some architectures have specific requirements for their partitions.
75
For example many of them require special partitions to support
78
Suppose that the architecture is powerpc/powermac_newworld. Then
79
partman-auto will look in the following places for recipes:
81
/lib/partman/recipes-powerpc-powermac_newworld/*
82
/lib/partman/recipes-powerpc/*
83
/lib/partman/recipes/*
85
Partman-auto will use the recipes from the first of these directories
92
Due to limitation of the algorithms in partman-auto, there must be at
93
least one partition with high maximal size so that the whole free
94
space can be used. Usually you can give the partition containing /home
95
a maximal size 1000000000 which is high enough for the present storage
96
devices. Do not use higher than 1000000000 numbers because the shell
97
arithmetic is limited to 31 bits (on i386).
103
On May 25th 2004, it was noted that on i386 systems, the very minimum size of
104
a Debian installation on a classical (/, /usr, /usr, /home) setup was:
105
48MB on / (6MB on /boot)
108
It is thus wise to use minimum values with this consideration in mind.