Commit | Line | Data |
---|---|---|
ec8f24b7 | 1 | # SPDX-License-Identifier: GPL-2.0-only |
006477f4 CH |
2 | |
3 | menu "Executable file formats" | |
4 | ||
1da177e4 LT |
5 | config BINFMT_ELF |
6 | bool "Kernel support for ELF binaries" | |
a687a533 | 7 | depends on MMU |
f43edca7 | 8 | select ELFCORE |
1da177e4 | 9 | default y |
a7f7f624 | 10 | help |
1da177e4 LT |
11 | ELF (Executable and Linkable Format) is a format for libraries and |
12 | executables used across different architectures and operating | |
13 | systems. Saying Y here will enable your kernel to run ELF binaries | |
14 | and enlarge it by about 13 KB. ELF support under Linux has now all | |
15 | but replaced the traditional Linux a.out formats (QMAGIC and ZMAGIC) | |
16 | because it is portable (this does *not* mean that you will be able | |
17 | to run executables from different architectures or operating systems | |
18 | however) and makes building run-time libraries very easy. Many new | |
19 | executables are distributed solely in ELF format. You definitely | |
20 | want to say Y here. | |
21 | ||
22 | Information about ELF is contained in the ELF HOWTO available from | |
23 | <http://www.tldp.org/docs.html#howto>. | |
24 | ||
25 | If you find that after upgrading from Linux kernel 1.2 and saying Y | |
26 | here, you still can't run any ELF binaries (they just crash), then | |
27 | you'll have to install the newest ELF runtime libraries, including | |
28 | ld.so (check the file <file:Documentation/Changes> for location and | |
29 | latest version). | |
30 | ||
b9d36d5d | 31 | config COMPAT_BINFMT_ELF |
41026c34 | 32 | def_bool y |
4cea5ceb | 33 | depends on COMPAT && BINFMT_ELF |
f43edca7 | 34 | select ELFCORE |
b9d36d5d | 35 | |
774c105e PB |
36 | config ARCH_BINFMT_ELF_STATE |
37 | bool | |
38 | ||
b62a8486 CM |
39 | config ARCH_BINFMT_ELF_EXTRA_PHDRS |
40 | bool | |
41 | ||
fe0f6766 DM |
42 | config ARCH_HAVE_ELF_PROT |
43 | bool | |
44 | ||
db751e30 DM |
45 | config ARCH_USE_GNU_PROPERTY |
46 | bool | |
47 | ||
1da177e4 LT |
48 | config BINFMT_ELF_FDPIC |
49 | bool "Kernel support for FDPIC ELF binaries" | |
382e67ae | 50 | default y if !BINFMT_ELF |
a579fcfa | 51 | depends on (ARM || (SUPERH && !MMU)) |
f43edca7 | 52 | select ELFCORE |
1da177e4 LT |
53 | help |
54 | ELF FDPIC binaries are based on ELF, but allow the individual load | |
55 | segments of a binary to be located in memory independently of each | |
56 | other. This makes this format ideal for use in environments where no | |
57 | MMU is available as it still permits text segments to be shared, | |
58 | even if data segments are not. | |
59 | ||
60 | It is also possible to run FDPIC ELF binaries on MMU linux also. | |
61 | ||
f43edca7 RB |
62 | config ELFCORE |
63 | bool | |
64 | help | |
65 | This option enables kernel/elfcore.o. | |
66 | ||
656eb2cd RM |
67 | config CORE_DUMP_DEFAULT_ELF_HEADERS |
68 | bool "Write ELF core dumps with partial segments" | |
89502155 | 69 | default y |
2d96d105 | 70 | depends on BINFMT_ELF && ELF_CORE |
656eb2cd RM |
71 | help |
72 | ELF core dump files describe each memory mapping of the crashed | |
73 | process, and can contain or omit the memory contents of each one. | |
74 | The contents of an unmodified text mapping are omitted by default. | |
75 | ||
76 | For an unmodified text mapping of an ELF object, including just | |
77 | the first page of the file in a core dump makes it possible to | |
78 | identify the build ID bits in the file, without paying the i/o | |
79 | cost and disk space to dump all the text. However, versions of | |
80 | GDB before 6.7 are confused by ELF core dump files in this format. | |
81 | ||
82 | The core dump behavior can be controlled per process using | |
83 | the /proc/PID/coredump_filter pseudo-file; this setting is | |
0c1bc6b8 | 84 | inherited. See Documentation/filesystems/proc.rst for details. |
656eb2cd RM |
85 | |
86 | This config option changes the default setting of coredump_filter | |
89502155 | 87 | seen at boot time. If unsure, say Y. |
656eb2cd | 88 | |
2535e0d7 JT |
89 | config BINFMT_SCRIPT |
90 | tristate "Kernel support for scripts starting with #!" | |
91 | default y | |
92 | help | |
93 | Say Y here if you want to execute interpreted scripts starting with | |
94 | #! followed by the path to an interpreter. | |
95 | ||
96 | You can build this support as a module; however, until that module | |
97 | gets loaded, you cannot run scripts. Thus, if you want to load this | |
98 | module from an initramfs, the portion of the initramfs before loading | |
99 | this module must consist of compiled binaries only. | |
100 | ||
101 | Most systems will not boot if you say M or N here. If unsure, say Y. | |
102 | ||
aef0f78e CH |
103 | config ARCH_HAS_BINFMT_FLAT |
104 | bool | |
105 | ||
1da177e4 | 106 | config BINFMT_FLAT |
3202e181 | 107 | bool "Kernel support for flat binaries" |
aef0f78e | 108 | depends on ARCH_HAS_BINFMT_FLAT |
1da177e4 LT |
109 | help |
110 | Support uClinux FLAT format binaries. | |
111 | ||
bdd15a28 CH |
112 | config BINFMT_FLAT_ARGVP_ENVP_ON_STACK |
113 | bool | |
114 | ||
1d52dca1 CH |
115 | config BINFMT_FLAT_OLD_ALWAYS_RAM |
116 | bool | |
117 | ||
04d82a6d DLM |
118 | config BINFMT_FLAT_NO_DATA_START_OFFSET |
119 | bool | |
120 | ||
cf9a566c CH |
121 | config BINFMT_FLAT_OLD |
122 | bool "Enable support for very old legacy flat binaries" | |
123 | depends on BINFMT_FLAT | |
124 | help | |
125 | Support decade old uClinux FLAT format binaries. Unless you know | |
126 | you have some of those say N here. | |
127 | ||
1da177e4 LT |
128 | config BINFMT_ZFLAT |
129 | bool "Enable ZFLAT support" | |
130 | depends on BINFMT_FLAT | |
131 | select ZLIB_INFLATE | |
132 | help | |
133 | Support FLAT format compressed binaries | |
134 | ||
135 | config BINFMT_SHARED_FLAT | |
136 | bool "Enable shared FLAT support" | |
137 | depends on BINFMT_FLAT | |
138 | help | |
139 | Support FLAT shared libraries | |
140 | ||
e17c6d56 DW |
141 | config HAVE_AOUT |
142 | def_bool n | |
143 | ||
1da177e4 LT |
144 | config BINFMT_AOUT |
145 | tristate "Kernel support for a.out and ECOFF binaries" | |
e17c6d56 | 146 | depends on HAVE_AOUT |
a7f7f624 | 147 | help |
1da177e4 LT |
148 | A.out (Assembler.OUTput) is a set of formats for libraries and |
149 | executables used in the earliest versions of UNIX. Linux used | |
150 | the a.out formats QMAGIC and ZMAGIC until they were replaced | |
151 | with the ELF format. | |
152 | ||
153 | The conversion to ELF started in 1995. This option is primarily | |
154 | provided for historical interest and for the benefit of those | |
155 | who need to run binaries from that era. | |
156 | ||
157 | Most people should answer N here. If you think you may have | |
158 | occasional use for this format, enable module support above | |
159 | and answer M here to compile this support as a module called | |
160 | binfmt_aout. | |
161 | ||
162 | If any crucial components of your system (such as /sbin/init | |
163 | or /lib/ld.so) are still in a.out format, you will have to | |
164 | say Y here. | |
165 | ||
166 | config OSF4_COMPAT | |
167 | bool "OSF/1 v4 readv/writev compatibility" | |
168 | depends on ALPHA && BINFMT_AOUT | |
169 | help | |
170 | Say Y if you are using OSF/1 binaries (like Netscape and Acrobat) | |
171 | with v4 shared libraries freely available from Compaq. If you're | |
172 | going to use shared libraries from Tru64 version 5.0 or later, say N. | |
173 | ||
1da177e4 LT |
174 | config BINFMT_MISC |
175 | tristate "Kernel support for MISC binaries" | |
a7f7f624 | 176 | help |
1da177e4 LT |
177 | If you say Y here, it will be possible to plug wrapper-driven binary |
178 | formats into the kernel. You will like this especially when you use | |
179 | programs that need an interpreter to run like Java, Python, .NET or | |
180 | Emacs-Lisp. It's also useful if you often run DOS executables under | |
181 | the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from | |
182 | <http://www.tldp.org/docs.html#howto>). Once you have | |
183 | registered such a binary class with the kernel, you can start one of | |
184 | those programs simply by typing in its name at a shell prompt; Linux | |
185 | will automatically feed it to the correct interpreter. | |
186 | ||
187 | You can do other nice things, too. Read the file | |
34962fb8 | 188 | <file:Documentation/admin-guide/binfmt-misc.rst> to learn how to use this |
8c27ceff MCC |
189 | feature, <file:Documentation/admin-guide/java.rst> for information about how |
190 | to include Java support. and <file:Documentation/admin-guide/mono.rst> for | |
1da177e4 LT |
191 | information about how to include Mono-based .NET support. |
192 | ||
193 | To use binfmt_misc, you will need to mount it: | |
194 | mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc | |
195 | ||
196 | You may say M here for module support and later load the module when | |
197 | you have use for it; the module is called binfmt_misc. If you | |
198 | don't know what to answer at this point, say Y. | |
046d662f AK |
199 | |
200 | config COREDUMP | |
201 | bool "Enable core dump support" if EXPERT | |
202 | default y | |
203 | help | |
204 | This option enables support for performing core dumps. You almost | |
205 | certainly want to say Y here. Not necessary on systems that never | |
206 | need debugging or only ever run flawless code. | |
006477f4 CH |
207 | |
208 | endmenu |