Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | config BINFMT_ELF |
| 2 | bool "Kernel support for ELF binaries" |
Arnd Bergmann | a687a53 | 2018-03-07 23:30:54 +0100 | [diff] [blame] | 3 | depends on MMU |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 4 | select ELFCORE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 5 | default y |
| 6 | ---help--- |
| 7 | ELF (Executable and Linkable Format) is a format for libraries and |
| 8 | executables used across different architectures and operating |
| 9 | systems. Saying Y here will enable your kernel to run ELF binaries |
| 10 | and enlarge it by about 13 KB. ELF support under Linux has now all |
| 11 | but replaced the traditional Linux a.out formats (QMAGIC and ZMAGIC) |
| 12 | because it is portable (this does *not* mean that you will be able |
| 13 | to run executables from different architectures or operating systems |
| 14 | however) and makes building run-time libraries very easy. Many new |
| 15 | executables are distributed solely in ELF format. You definitely |
| 16 | want to say Y here. |
| 17 | |
| 18 | Information about ELF is contained in the ELF HOWTO available from |
| 19 | <http://www.tldp.org/docs.html#howto>. |
| 20 | |
| 21 | If you find that after upgrading from Linux kernel 1.2 and saying Y |
| 22 | here, you still can't run any ELF binaries (they just crash), then |
| 23 | you'll have to install the newest ELF runtime libraries, including |
| 24 | ld.so (check the file <file:Documentation/Changes> for location and |
| 25 | latest version). |
| 26 | |
Roland McGrath | b9d36d5 | 2008-01-30 13:31:46 +0100 | [diff] [blame] | 27 | config COMPAT_BINFMT_ELF |
| 28 | bool |
Alexey Dobriyan | 4cea5ce | 2008-10-15 22:04:17 -0700 | [diff] [blame] | 29 | depends on COMPAT && BINFMT_ELF |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 30 | select ELFCORE |
Roland McGrath | b9d36d5 | 2008-01-30 13:31:46 +0100 | [diff] [blame] | 31 | |
Paul Burton | 774c105 | 2014-09-11 08:30:16 +0100 | [diff] [blame] | 32 | config ARCH_BINFMT_ELF_STATE |
| 33 | bool |
| 34 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 35 | config BINFMT_ELF_FDPIC |
| 36 | bool "Kernel support for FDPIC ELF binaries" |
Nicolas Pitre | 382e67a | 2017-08-11 00:53:39 -0400 | [diff] [blame] | 37 | default y if !BINFMT_ELF |
Arnd Bergmann | a687a53 | 2018-03-07 23:30:54 +0100 | [diff] [blame] | 38 | depends on (ARM || (SUPERH32 && !MMU) || C6X) |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 39 | select ELFCORE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 40 | help |
| 41 | ELF FDPIC binaries are based on ELF, but allow the individual load |
| 42 | segments of a binary to be located in memory independently of each |
| 43 | other. This makes this format ideal for use in environments where no |
| 44 | MMU is available as it still permits text segments to be shared, |
| 45 | even if data segments are not. |
| 46 | |
| 47 | It is also possible to run FDPIC ELF binaries on MMU linux also. |
| 48 | |
Ralf Baechle | f43edca | 2016-05-23 16:22:26 -0700 | [diff] [blame] | 49 | config ELFCORE |
| 50 | bool |
| 51 | help |
| 52 | This option enables kernel/elfcore.o. |
| 53 | |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 54 | config CORE_DUMP_DEFAULT_ELF_HEADERS |
| 55 | bool "Write ELF core dumps with partial segments" |
Roland McGrath | 8950215 | 2010-10-27 15:34:09 -0700 | [diff] [blame] | 56 | default y |
David Brownell | 2d96d10 | 2009-01-09 16:40:52 -0800 | [diff] [blame] | 57 | depends on BINFMT_ELF && ELF_CORE |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 58 | help |
| 59 | ELF core dump files describe each memory mapping of the crashed |
| 60 | process, and can contain or omit the memory contents of each one. |
| 61 | The contents of an unmodified text mapping are omitted by default. |
| 62 | |
| 63 | For an unmodified text mapping of an ELF object, including just |
| 64 | the first page of the file in a core dump makes it possible to |
| 65 | identify the build ID bits in the file, without paying the i/o |
| 66 | cost and disk space to dump all the text. However, versions of |
| 67 | GDB before 6.7 are confused by ELF core dump files in this format. |
| 68 | |
| 69 | The core dump behavior can be controlled per process using |
| 70 | the /proc/PID/coredump_filter pseudo-file; this setting is |
| 71 | inherited. See Documentation/filesystems/proc.txt for details. |
| 72 | |
| 73 | This config option changes the default setting of coredump_filter |
Roland McGrath | 8950215 | 2010-10-27 15:34:09 -0700 | [diff] [blame] | 74 | seen at boot time. If unsure, say Y. |
Roland McGrath | 656eb2c | 2008-10-18 20:28:23 -0700 | [diff] [blame] | 75 | |
Josh Triplett | 2535e0d | 2013-04-30 15:27:44 -0700 | [diff] [blame] | 76 | config BINFMT_SCRIPT |
| 77 | tristate "Kernel support for scripts starting with #!" |
| 78 | default y |
| 79 | help |
| 80 | Say Y here if you want to execute interpreted scripts starting with |
| 81 | #! followed by the path to an interpreter. |
| 82 | |
| 83 | You can build this support as a module; however, until that module |
| 84 | gets loaded, you cannot run scripts. Thus, if you want to load this |
| 85 | module from an initramfs, the portion of the initramfs before loading |
| 86 | this module must consist of compiled binaries only. |
| 87 | |
| 88 | Most systems will not boot if you say M or N here. If unsure, say Y. |
| 89 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 90 | config BINFMT_FLAT |
Adrian Bunk | 3202e18 | 2008-04-29 00:59:02 -0700 | [diff] [blame] | 91 | bool "Kernel support for flat binaries" |
Nicolas Pitre | d782e42 | 2016-08-05 06:03:41 +0100 | [diff] [blame] | 92 | depends on !MMU || ARM || M68K |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 93 | help |
| 94 | Support uClinux FLAT format binaries. |
| 95 | |
| 96 | config BINFMT_ZFLAT |
| 97 | bool "Enable ZFLAT support" |
| 98 | depends on BINFMT_FLAT |
| 99 | select ZLIB_INFLATE |
| 100 | help |
| 101 | Support FLAT format compressed binaries |
| 102 | |
| 103 | config BINFMT_SHARED_FLAT |
| 104 | bool "Enable shared FLAT support" |
| 105 | depends on BINFMT_FLAT |
| 106 | help |
| 107 | Support FLAT shared libraries |
| 108 | |
David Woodhouse | e17c6d5 | 2008-06-17 12:19:34 +0100 | [diff] [blame] | 109 | config HAVE_AOUT |
| 110 | def_bool n |
| 111 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | config BINFMT_AOUT |
| 113 | tristate "Kernel support for a.out and ECOFF binaries" |
David Woodhouse | e17c6d5 | 2008-06-17 12:19:34 +0100 | [diff] [blame] | 114 | depends on HAVE_AOUT |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 115 | ---help--- |
| 116 | A.out (Assembler.OUTput) is a set of formats for libraries and |
| 117 | executables used in the earliest versions of UNIX. Linux used |
| 118 | the a.out formats QMAGIC and ZMAGIC until they were replaced |
| 119 | with the ELF format. |
| 120 | |
| 121 | The conversion to ELF started in 1995. This option is primarily |
| 122 | provided for historical interest and for the benefit of those |
| 123 | who need to run binaries from that era. |
| 124 | |
| 125 | Most people should answer N here. If you think you may have |
| 126 | occasional use for this format, enable module support above |
| 127 | and answer M here to compile this support as a module called |
| 128 | binfmt_aout. |
| 129 | |
| 130 | If any crucial components of your system (such as /sbin/init |
| 131 | or /lib/ld.so) are still in a.out format, you will have to |
| 132 | say Y here. |
| 133 | |
| 134 | config OSF4_COMPAT |
| 135 | bool "OSF/1 v4 readv/writev compatibility" |
| 136 | depends on ALPHA && BINFMT_AOUT |
| 137 | help |
| 138 | Say Y if you are using OSF/1 binaries (like Netscape and Acrobat) |
| 139 | with v4 shared libraries freely available from Compaq. If you're |
| 140 | going to use shared libraries from Tru64 version 5.0 or later, say N. |
| 141 | |
| 142 | config BINFMT_EM86 |
| 143 | tristate "Kernel support for Linux/Intel ELF binaries" |
| 144 | depends on ALPHA |
| 145 | ---help--- |
| 146 | Say Y here if you want to be able to execute Linux/Intel ELF |
| 147 | binaries just like native Alpha binaries on your Alpha machine. For |
| 148 | this to work, you need to have the emulator /usr/bin/em86 in place. |
| 149 | |
| 150 | You can get the same functionality by saying N here and saying Y to |
| 151 | "Kernel support for MISC binaries". |
| 152 | |
| 153 | You may answer M to compile the emulation support as a module and |
| 154 | later load the module when you want to use a Linux/Intel binary. The |
| 155 | module will be called binfmt_em86. If unsure, say Y. |
| 156 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | config BINFMT_MISC |
| 158 | tristate "Kernel support for MISC binaries" |
| 159 | ---help--- |
| 160 | If you say Y here, it will be possible to plug wrapper-driven binary |
| 161 | formats into the kernel. You will like this especially when you use |
| 162 | programs that need an interpreter to run like Java, Python, .NET or |
| 163 | Emacs-Lisp. It's also useful if you often run DOS executables under |
| 164 | the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from |
| 165 | <http://www.tldp.org/docs.html#howto>). Once you have |
| 166 | registered such a binary class with the kernel, you can start one of |
| 167 | those programs simply by typing in its name at a shell prompt; Linux |
| 168 | will automatically feed it to the correct interpreter. |
| 169 | |
| 170 | You can do other nice things, too. Read the file |
| 171 | <file:Documentation/binfmt_misc.txt> to learn how to use this |
Mauro Carvalho Chehab | 8c27ceff3 | 2016-10-18 10:12:27 -0200 | [diff] [blame] | 172 | feature, <file:Documentation/admin-guide/java.rst> for information about how |
| 173 | to include Java support. and <file:Documentation/admin-guide/mono.rst> for |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 174 | information about how to include Mono-based .NET support. |
| 175 | |
| 176 | To use binfmt_misc, you will need to mount it: |
| 177 | mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc |
| 178 | |
| 179 | You may say M here for module support and later load the module when |
| 180 | you have use for it; the module is called binfmt_misc. If you |
| 181 | don't know what to answer at this point, say Y. |
Alex Kelly | 046d662 | 2012-10-04 17:15:23 -0700 | [diff] [blame] | 182 | |
| 183 | config COREDUMP |
| 184 | bool "Enable core dump support" if EXPERT |
| 185 | default y |
| 186 | help |
| 187 | This option enables support for performing core dumps. You almost |
| 188 | certainly want to say Y here. Not necessary on systems that never |
| 189 | need debugging or only ever run flawless code. |