You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: en/embox_build_en.md
+14-15Lines changed: 14 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Building
2
2
3
3
## Project configuration
4
-
Configuration is the list of modules and their parameters on the one side, and set of requirements to system functionality on the other. Check the "Modular structure of Embox" section for more details. The current configuration is in the files of "conf/" directory.
4
+
A configuration is the list of modules and their parameters on the one side, and set of requirements to system functionality on the other. Check the "Modular structure of Embox" section for more details. The current configuration is in the files of "conf/" directory.
5
5
6
6
## Choice of configuration
7
-
To set the configuration with desired properties, it's necessary to describe these properties in the "conf/" directory. But if the similar configuration is already exists, it'll be easy for you to use the existing description as a base for making your own configuration.
7
+
To set the configuration with desired properties, it's necessary to describe these properties in the "conf/" directory. But if the similar configuration is already exists, it'll be more easy for you to use the existing description as a base for making your own configuration.
8
8
9
9
You can see the existing configuration, using the next command:
10
10
```
@@ -14,9 +14,9 @@ After it's possible to load the chosen configuration the next way:
14
14
```
15
15
$ make confload-<template>
16
16
```
17
-
To pay attention: after using the "make confload-" command, your "conf/" directory will get files of chosen configuration. And files, that were in this directory before will be deleted.
17
+
To pay attention: after running the "make confload-", your "conf/" directory will have files of chosen configuration. And files, that were in this directory before will be deleted.
18
18
19
-
For example:
19
+
In the next example we choose the existing "platform/quake3/qemu" configuration from the list:
20
20
```
21
21
$ make confload
22
22
List of available templates:
@@ -27,10 +27,9 @@ For example:
27
27
28
28
$ make confload-platform/quake3/qemu
29
29
```
30
-
In the example above we choose the existing "platform/quake3/qemu" configuration from the list.
31
30
32
31
## Building made of existing configuration
33
-
To build the image, it's necessary to set the chosen configuration as a current one how it was shown in the previous example. And then to run the next command:
32
+
To build the image, it's necessary to set the chosen configuration as a current one how it was shown in the previous example. And then to run:
34
33
```
35
34
$ make
36
35
```
@@ -43,29 +42,29 @@ For instance:
43
42
Build complete
44
43
```
45
44
46
-
## Changing the characteristics of the system
47
-
Using the "conf/" file you can change the configuration after making modifications. We remind you: if to run "make confload-" or make cleaning, that connected with current configuration (e. g. "make distclean"), current changes will be lost.
45
+
## Changing system characteristics
46
+
After selection of configuration you can change it, using "conf/" file. We remind you: if to run "make confload-" or make cleaning, that connected with current configuration (e. g. "make distclean"), current changes will be lost.
48
47
49
-
### Changing the functionality of the system
48
+
### Changing system functionality
50
49
#### Modification of the modules list
51
-
"Mods.conf" file has the description of system functionality, so you should use this file if you want to change functionality. For instance, to add a new command to the list, it's necessary to insert to "mods.conf" file the next line:
50
+
"Mods.conf" file contains a description of system functionality, so you should use this file if you want to change functionality. For example, to add a new command to the list, it's necessary to insert to "mods.conf" file the next line:
52
51
```
53
52
include <PACKAGE_NAME>.<MODULE_NAME>
54
53
```
55
-
For example:
54
+
For instance:
56
55
```
57
56
include embox.cmds.help
58
57
```
59
58
The same way also works in case of standard modules.
60
59
61
-
#### Parameters of module
62
-
To change the parameters of module, it's necessary to set name of option and desired value in brackets. For example: to change size of thread stack, you need to set (to add) the *thread_stack_size* parameter in the *embox.kernel.thread.core* module:
60
+
#### Module parameters
61
+
To set size of thread stack, you need to change (or to add) the *thread_stack_size* parameter in the *embox.kernel.thread.core* module:
63
62
```
64
63
include embox.kernel.thread.core(thread_stack_size=0x4000)
65
64
```
66
65
67
-
#### Порядок загрузки
68
-
Также можно повлиять на порядок загрузки модулей системы в конфигурации. Для этого используется атрибут «@Runlevel(level)» (например: *@Runlevel(2)*), но обычно этого не требуется, поскольку модули загружаются по зависимостям между ними.
66
+
#### Load order
67
+
Также можно повлиять на порядок загрузки модулей системы в конфигурации. Для этого используется атрибут «@Runlevel(level)» (например: *@Runlevel(2)*), но обычно этого не требуется, поскольку модули загружаются по зависимостям между ними.You can manage the order, in which the modules of system load in configuration. Use the «@Runlevel(level)» (e. g. *@Runlevel(2)*) attribute for this purpose, but usually it's not required, because modules are loading according to dependencies (if some module *B* depends on some module *A*, then *A* will be loaded before *B*).
0 commit comments