summaryrefslogtreecommitdiff
path: root/docs/make-tips.txt
blob: 787121cb4fbf0e7d40b77b53e602c029c2804fa6 (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
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
// -*- mode:doc; -*-
// vim: set syntax=asciidoc:

[[make-tips]]
'make' tips
-----------

This is a collection of tips that help you make the most of OpenADK.

.Configuration searches:

The +make menuconfig+ command offer a search tool. 
The search tool is called by pressing +/+;
The result of the search shows the help message of the matching items.

.Display all commands executed by make:

--------------------
 $ make v
--------------------

or

--------------------
 $ make VERBOSE=1 <target>
--------------------

.Display all available targets:

--------------------
 $ make help
--------------------

.Cleaning:

There are different cleaning targets available. If a full clean is
necessary, you normally will get a message from OpenADK.
To delete all build products (including build directories, target, host
and pkg trees, the firmware and the toolchain for all targets):

--------------------
 $ make cleandir
--------------------

If you only want to clean your specific configured target, just use:

--------------------
 $ make cleantarget
--------------------

If you even want to clean any downloaded source:

--------------------
 $ make distclean
--------------------

If you only want to clean the kernel build, because you added or
removed some patch, just do:

--------------------
 $ make cleankernel
--------------------

This is automatically triggered if you change the kernel version in 
your configuration.

If you just want to clean all packages and wants to rebuild the firmware,
(the tools/toolchain is not deleted) just use:

--------------------
 $ make clean
--------------------

.Resetting OpenADK for a new target:

You can either delete the configuration and start from scratch:

--------------------
 $ rm .config*
 $ make menuconfig
--------------------

Or you can save your existing configuration and switch to a new
one with:

--------------------
 $ make switch
--------------------

Afterwards you can switch back to your old configuration, you just
need to remember, which architecture and system you had configured:

--------------------
 $ make switch ARCH=<arch> SYSTEM=<system>
--------------------

OpenADK is designed to have multiple architectures and embedded system
combinations configured and build without a need to rebuild everything
from scratch. There is no limit, you just need to have enough disk space.