Thomas Gleixner | ec8f24b | 2019-05-19 13:07:45 +0100 | [diff] [blame] | 1 | # SPDX-License-Identifier: GPL-2.0-only |
Christoph Hellwig | 006477f | 2018-07-31 13:39:34 +0200 | [diff] [blame] | 2 | |
| 3 | menu "Executable file formats" |
| 4 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 5 | config BINFMT_ELF |
| 6 | bool "Kernel support for ELF binaries" |
Arnd Bergmann | a687a53 | 2018-03-07 23:30:54 +0100 | [diff] [blame] | 7 | depends on MMU |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 8 | select ELFCORE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 9 | default y |
Masahiro Yamada | a7f7f62 | 2020-06-14 01:50:22 +0900 | [diff] [blame] | 10 | help |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | |
Kees Cook | 9e1a3ce | 2022-02-23 19:32:10 -0800 | [diff] [blame] | 31 | config BINFMT_ELF_KUNIT_TEST |
| 32 | bool "Build KUnit tests for ELF binary support" if !KUNIT_ALL_TESTS |
| 33 | depends on KUNIT=y && BINFMT_ELF=y |
| 34 | default KUNIT_ALL_TESTS |
| 35 | help |
| 36 | This builds the ELF loader KUnit tests, which try to gather |
| 37 | prior bug fixes into a regression test collection. This is really |
| 38 | only needed for debugging. Note that with CONFIG_COMPAT=y, the |
| 39 | compat_binfmt_elf KUnit test is also created. |
| 40 | |
Roland McGrath | b9d36d5 | 2008-01-30 13:31:46 +0100 | [diff] [blame] | 41 | config COMPAT_BINFMT_ELF |
Al Viro | 41026c3 | 2020-12-02 23:56:34 -0500 | [diff] [blame] | 42 | def_bool y |
Alexey Dobriyan | 4cea5ce | 2008-10-15 22:04:17 -0700 | [diff] [blame] | 43 | depends on COMPAT && BINFMT_ELF |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 44 | select ELFCORE |
Roland McGrath | b9d36d5 | 2008-01-30 13:31:46 +0100 | [diff] [blame] | 45 | |
Paul Burton | 774c105 | 2014-09-11 08:30:16 +0100 | [diff] [blame] | 46 | config ARCH_BINFMT_ELF_STATE |
| 47 | bool |
| 48 | |
Catalin Marinas | b62a8486 | 2022-01-31 16:54:52 +0000 | [diff] [blame] | 49 | config ARCH_BINFMT_ELF_EXTRA_PHDRS |
| 50 | bool |
| 51 | |
Dave Martin | fe0f676 | 2020-03-16 16:50:46 +0000 | [diff] [blame] | 52 | config ARCH_HAVE_ELF_PROT |
| 53 | bool |
| 54 | |
Dave Martin | db751e3 | 2020-03-16 16:50:43 +0000 | [diff] [blame] | 55 | config ARCH_USE_GNU_PROPERTY |
| 56 | bool |
| 57 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 58 | config BINFMT_ELF_FDPIC |
| 59 | bool "Kernel support for FDPIC ELF binaries" |
Nicolas Pitre | 382e67a | 2017-08-11 00:53:39 -0400 | [diff] [blame] | 60 | default y if !BINFMT_ELF |
Max Filippov | e3ddb8b | 2022-06-03 11:31:14 -0700 | [diff] [blame] | 61 | depends on ARM || ((M68K || SUPERH || XTENSA) && !MMU) |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 62 | select ELFCORE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 63 | help |
| 64 | ELF FDPIC binaries are based on ELF, but allow the individual load |
| 65 | segments of a binary to be located in memory independently of each |
| 66 | other. This makes this format ideal for use in environments where no |
| 67 | MMU is available as it still permits text segments to be shared, |
| 68 | even if data segments are not. |
| 69 | |
| 70 | It is also possible to run FDPIC ELF binaries on MMU linux also. |
| 71 | |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 72 | config ELFCORE |
| 73 | bool |
| 74 | help |
| 75 | This option enables kernel/elfcore.o. |
| 76 | |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 77 | config CORE_DUMP_DEFAULT_ELF_HEADERS |
| 78 | bool "Write ELF core dumps with partial segments" |
Roland McGrath | 8950215 | 2010-10-27 15:34:09 -0700 | [diff] [blame] | 79 | default y |
David Brownell | 2d96d10 | 2009-01-09 16:40:52 -0800 | [diff] [blame] | 80 | depends on BINFMT_ELF && ELF_CORE |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 81 | help |
| 82 | ELF core dump files describe each memory mapping of the crashed |
| 83 | process, and can contain or omit the memory contents of each one. |
| 84 | The contents of an unmodified text mapping are omitted by default. |
| 85 | |
| 86 | For an unmodified text mapping of an ELF object, including just |
| 87 | the first page of the file in a core dump makes it possible to |
| 88 | identify the build ID bits in the file, without paying the i/o |
| 89 | cost and disk space to dump all the text. However, versions of |
| 90 | GDB before 6.7 are confused by ELF core dump files in this format. |
| 91 | |
| 92 | The core dump behavior can be controlled per process using |
| 93 | the /proc/PID/coredump_filter pseudo-file; this setting is |
Mauro Carvalho Chehab | 0c1bc6b | 2020-04-14 18:48:37 +0200 | [diff] [blame] | 94 | inherited. See Documentation/filesystems/proc.rst for details. |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 95 | |
| 96 | This config option changes the default setting of coredump_filter |
Roland McGrath | 8950215 | 2010-10-27 15:34:09 -0700 | [diff] [blame] | 97 | seen at boot time. If unsure, say Y. |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 98 | |
Josh Triplett | 2535e0d | 2013-04-30 15:27:44 -0700 | [diff] [blame] | 99 | config BINFMT_SCRIPT |
| 100 | tristate "Kernel support for scripts starting with #!" |
| 101 | default y |
| 102 | help |
| 103 | Say Y here if you want to execute interpreted scripts starting with |
| 104 | #! followed by the path to an interpreter. |
| 105 | |
| 106 | You can build this support as a module; however, until that module |
| 107 | gets loaded, you cannot run scripts. Thus, if you want to load this |
| 108 | module from an initramfs, the portion of the initramfs before loading |
| 109 | this module must consist of compiled binaries only. |
| 110 | |
| 111 | Most systems will not boot if you say M or N here. If unsure, say Y. |
| 112 | |
Christoph Hellwig | aef0f78 | 2019-06-13 09:08:57 +0200 | [diff] [blame] | 113 | config ARCH_HAS_BINFMT_FLAT |
| 114 | bool |
| 115 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 116 | config BINFMT_FLAT |
Adrian Bunk | 3202e18 | 2008-04-29 00:59:02 -0700 | [diff] [blame] | 117 | bool "Kernel support for flat binaries" |
Christoph Hellwig | aef0f78 | 2019-06-13 09:08:57 +0200 | [diff] [blame] | 118 | depends on ARCH_HAS_BINFMT_FLAT |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 119 | help |
| 120 | Support uClinux FLAT format binaries. |
| 121 | |
Christoph Hellwig | bdd15a2 | 2019-06-13 09:08:51 +0200 | [diff] [blame] | 122 | config BINFMT_FLAT_ARGVP_ENVP_ON_STACK |
| 123 | bool |
| 124 | |
Christoph Hellwig | 1d52dca | 2019-06-13 09:08:50 +0200 | [diff] [blame] | 125 | config BINFMT_FLAT_OLD_ALWAYS_RAM |
| 126 | bool |
| 127 | |
Damien Le Moal | 04d82a6 | 2021-04-17 10:10:08 +0900 | [diff] [blame] | 128 | config BINFMT_FLAT_NO_DATA_START_OFFSET |
| 129 | bool |
| 130 | |
Christoph Hellwig | cf9a566 | 2019-06-13 09:08:58 +0200 | [diff] [blame] | 131 | config BINFMT_FLAT_OLD |
| 132 | bool "Enable support for very old legacy flat binaries" |
| 133 | depends on BINFMT_FLAT |
| 134 | help |
| 135 | Support decade old uClinux FLAT format binaries. Unless you know |
| 136 | you have some of those say N here. |
| 137 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 138 | config BINFMT_ZFLAT |
| 139 | bool "Enable ZFLAT support" |
| 140 | depends on BINFMT_FLAT |
| 141 | select ZLIB_INFLATE |
| 142 | help |
| 143 | Support FLAT format compressed binaries |
| 144 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 145 | config BINFMT_MISC |
| 146 | tristate "Kernel support for MISC binaries" |
Masahiro Yamada | a7f7f62 | 2020-06-14 01:50:22 +0900 | [diff] [blame] | 147 | help |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | If you say Y here, it will be possible to plug wrapper-driven binary |
| 149 | formats into the kernel. You will like this especially when you use |
| 150 | programs that need an interpreter to run like Java, Python, .NET or |
| 151 | Emacs-Lisp. It's also useful if you often run DOS executables under |
| 152 | the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from |
| 153 | <http://www.tldp.org/docs.html#howto>). Once you have |
| 154 | registered such a binary class with the kernel, you can start one of |
| 155 | those programs simply by typing in its name at a shell prompt; Linux |
| 156 | will automatically feed it to the correct interpreter. |
| 157 | |
| 158 | You can do other nice things, too. Read the file |
Mauro Carvalho Chehab | 34962fb | 2018-05-08 15:14:57 -0300 | [diff] [blame] | 159 | <file:Documentation/admin-guide/binfmt-misc.rst> to learn how to use this |
Mauro Carvalho Chehab | 8c27ceff3 | 2016-10-18 10:12:27 -0200 | [diff] [blame] | 160 | feature, <file:Documentation/admin-guide/java.rst> for information about how |
| 161 | to include Java support. and <file:Documentation/admin-guide/mono.rst> for |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 162 | information about how to include Mono-based .NET support. |
| 163 | |
| 164 | To use binfmt_misc, you will need to mount it: |
| 165 | mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc |
| 166 | |
| 167 | You may say M here for module support and later load the module when |
| 168 | you have use for it; the module is called binfmt_misc. If you |
| 169 | don't know what to answer at this point, say Y. |
Alex Kelly | 046d662 | 2012-10-04 17:15:23 -0700 | [diff] [blame] | 170 | |
| 171 | config COREDUMP |
| 172 | bool "Enable core dump support" if EXPERT |
| 173 | default y |
| 174 | help |
| 175 | This option enables support for performing core dumps. You almost |
| 176 | certainly want to say Y here. Not necessary on systems that never |
| 177 | need debugging or only ever run flawless code. |
Christoph Hellwig | 006477f | 2018-07-31 13:39:34 +0200 | [diff] [blame] | 178 | |
| 179 | endmenu |