xref: /openbmc/linux/fs/Kconfig.binfmt (revision d782e426b835bd2e79d868eb4af8510ed79e0aee)
11da177e4SLinus Torvaldsconfig BINFMT_ELF
21da177e4SLinus Torvalds	bool "Kernel support for ELF binaries"
32919b510SDavid Howells	depends on MMU && (BROKEN || !FRV)
4f43edca7SRalf Baechle	select ELFCORE
51da177e4SLinus Torvalds	default y
61da177e4SLinus Torvalds	---help---
71da177e4SLinus Torvalds	  ELF (Executable and Linkable Format) is a format for libraries and
81da177e4SLinus Torvalds	  executables used across different architectures and operating
91da177e4SLinus Torvalds	  systems. Saying Y here will enable your kernel to run ELF binaries
101da177e4SLinus Torvalds	  and enlarge it by about 13 KB. ELF support under Linux has now all
111da177e4SLinus Torvalds	  but replaced the traditional Linux a.out formats (QMAGIC and ZMAGIC)
121da177e4SLinus Torvalds	  because it is portable (this does *not* mean that you will be able
131da177e4SLinus Torvalds	  to run executables from different architectures or operating systems
141da177e4SLinus Torvalds	  however) and makes building run-time libraries very easy. Many new
151da177e4SLinus Torvalds	  executables are distributed solely in ELF format. You definitely
161da177e4SLinus Torvalds	  want to say Y here.
171da177e4SLinus Torvalds
181da177e4SLinus Torvalds	  Information about ELF is contained in the ELF HOWTO available from
191da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>.
201da177e4SLinus Torvalds
211da177e4SLinus Torvalds	  If you find that after upgrading from Linux kernel 1.2 and saying Y
221da177e4SLinus Torvalds	  here, you still can't run any ELF binaries (they just crash), then
231da177e4SLinus Torvalds	  you'll have to install the newest ELF runtime libraries, including
241da177e4SLinus Torvalds	  ld.so (check the file <file:Documentation/Changes> for location and
251da177e4SLinus Torvalds	  latest version).
261da177e4SLinus Torvalds
27b9d36d5dSRoland McGrathconfig COMPAT_BINFMT_ELF
28b9d36d5dSRoland McGrath	bool
294cea5cebSAlexey Dobriyan	depends on COMPAT && BINFMT_ELF
30f43edca7SRalf Baechle	select ELFCORE
31b9d36d5dSRoland McGrath
32774c105eSPaul Burtonconfig ARCH_BINFMT_ELF_STATE
33774c105eSPaul Burton	bool
34774c105eSPaul Burton
351da177e4SLinus Torvaldsconfig BINFMT_ELF_FDPIC
361da177e4SLinus Torvalds	bool "Kernel support for FDPIC ELF binaries"
371da177e4SLinus Torvalds	default y
38fce24476SMark Salter	depends on (FRV || BLACKFIN || (SUPERH32 && !MMU) || C6X)
39f43edca7SRalf Baechle	select ELFCORE
401da177e4SLinus Torvalds	help
411da177e4SLinus Torvalds	  ELF FDPIC binaries are based on ELF, but allow the individual load
421da177e4SLinus Torvalds	  segments of a binary to be located in memory independently of each
431da177e4SLinus Torvalds	  other. This makes this format ideal for use in environments where no
441da177e4SLinus Torvalds	  MMU is available as it still permits text segments to be shared,
451da177e4SLinus Torvalds	  even if data segments are not.
461da177e4SLinus Torvalds
471da177e4SLinus Torvalds	  It is also possible to run FDPIC ELF binaries on MMU linux also.
481da177e4SLinus Torvalds
49f43edca7SRalf Baechleconfig ELFCORE
50f43edca7SRalf Baechle	bool
51f43edca7SRalf Baechle	help
52f43edca7SRalf Baechle	  This option enables kernel/elfcore.o.
53f43edca7SRalf Baechle
54656eb2cdSRoland McGrathconfig CORE_DUMP_DEFAULT_ELF_HEADERS
55656eb2cdSRoland McGrath	bool "Write ELF core dumps with partial segments"
5689502155SRoland McGrath	default y
572d96d105SDavid Brownell	depends on BINFMT_ELF && ELF_CORE
58656eb2cdSRoland McGrath	help
59656eb2cdSRoland McGrath	  ELF core dump files describe each memory mapping of the crashed
60656eb2cdSRoland McGrath	  process, and can contain or omit the memory contents of each one.
61656eb2cdSRoland McGrath	  The contents of an unmodified text mapping are omitted by default.
62656eb2cdSRoland McGrath
63656eb2cdSRoland McGrath	  For an unmodified text mapping of an ELF object, including just
64656eb2cdSRoland McGrath	  the first page of the file in a core dump makes it possible to
65656eb2cdSRoland McGrath	  identify the build ID bits in the file, without paying the i/o
66656eb2cdSRoland McGrath	  cost and disk space to dump all the text.  However, versions of
67656eb2cdSRoland McGrath	  GDB before 6.7 are confused by ELF core dump files in this format.
68656eb2cdSRoland McGrath
69656eb2cdSRoland McGrath	  The core dump behavior can be controlled per process using
70656eb2cdSRoland McGrath	  the /proc/PID/coredump_filter pseudo-file; this setting is
71656eb2cdSRoland McGrath	  inherited.  See Documentation/filesystems/proc.txt for details.
72656eb2cdSRoland McGrath
73656eb2cdSRoland McGrath	  This config option changes the default setting of coredump_filter
7489502155SRoland McGrath	  seen at boot time.  If unsure, say Y.
75656eb2cdSRoland McGrath
762535e0d7SJosh Triplettconfig BINFMT_SCRIPT
772535e0d7SJosh Triplett	tristate "Kernel support for scripts starting with #!"
782535e0d7SJosh Triplett	default y
792535e0d7SJosh Triplett	help
802535e0d7SJosh Triplett	  Say Y here if you want to execute interpreted scripts starting with
812535e0d7SJosh Triplett	  #! followed by the path to an interpreter.
822535e0d7SJosh Triplett
832535e0d7SJosh Triplett	  You can build this support as a module; however, until that module
842535e0d7SJosh Triplett	  gets loaded, you cannot run scripts.  Thus, if you want to load this
852535e0d7SJosh Triplett	  module from an initramfs, the portion of the initramfs before loading
862535e0d7SJosh Triplett	  this module must consist of compiled binaries only.
872535e0d7SJosh Triplett
882535e0d7SJosh Triplett	  Most systems will not boot if you say M or N here.  If unsure, say Y.
892535e0d7SJosh Triplett
901da177e4SLinus Torvaldsconfig BINFMT_FLAT
913202e181SAdrian Bunk	bool "Kernel support for flat binaries"
92*d782e426SNicolas Pitre	depends on !MMU || ARM || M68K
93002d2f01SNicolas Pitre	depends on !FRV || BROKEN
941da177e4SLinus Torvalds	help
951da177e4SLinus Torvalds	  Support uClinux FLAT format binaries.
961da177e4SLinus Torvalds
971da177e4SLinus Torvaldsconfig BINFMT_ZFLAT
981da177e4SLinus Torvalds	bool "Enable ZFLAT support"
991da177e4SLinus Torvalds	depends on BINFMT_FLAT
1001da177e4SLinus Torvalds	select ZLIB_INFLATE
1011da177e4SLinus Torvalds	help
1021da177e4SLinus Torvalds	  Support FLAT format compressed binaries
1031da177e4SLinus Torvalds
1041da177e4SLinus Torvaldsconfig BINFMT_SHARED_FLAT
1051da177e4SLinus Torvalds	bool "Enable shared FLAT support"
1061da177e4SLinus Torvalds	depends on BINFMT_FLAT
1071da177e4SLinus Torvalds	help
1081da177e4SLinus Torvalds	  Support FLAT shared libraries
1091da177e4SLinus Torvalds
110e17c6d56SDavid Woodhouseconfig HAVE_AOUT
111e17c6d56SDavid Woodhouse       def_bool n
112e17c6d56SDavid Woodhouse
1131da177e4SLinus Torvaldsconfig BINFMT_AOUT
1141da177e4SLinus Torvalds	tristate "Kernel support for a.out and ECOFF binaries"
115e17c6d56SDavid Woodhouse	depends on HAVE_AOUT
1161da177e4SLinus Torvalds	---help---
1171da177e4SLinus Torvalds	  A.out (Assembler.OUTput) is a set of formats for libraries and
1181da177e4SLinus Torvalds	  executables used in the earliest versions of UNIX.  Linux used
1191da177e4SLinus Torvalds	  the a.out formats QMAGIC and ZMAGIC until they were replaced
1201da177e4SLinus Torvalds	  with the ELF format.
1211da177e4SLinus Torvalds
1221da177e4SLinus Torvalds	  The conversion to ELF started in 1995.  This option is primarily
1231da177e4SLinus Torvalds	  provided for historical interest and for the benefit of those
1241da177e4SLinus Torvalds	  who need to run binaries from that era.
1251da177e4SLinus Torvalds
1261da177e4SLinus Torvalds	  Most people should answer N here.  If you think you may have
1271da177e4SLinus Torvalds	  occasional use for this format, enable module support above
1281da177e4SLinus Torvalds	  and answer M here to compile this support as a module called
1291da177e4SLinus Torvalds	  binfmt_aout.
1301da177e4SLinus Torvalds
1311da177e4SLinus Torvalds	  If any crucial components of your system (such as /sbin/init
1321da177e4SLinus Torvalds	  or /lib/ld.so) are still in a.out format, you will have to
1331da177e4SLinus Torvalds	  say Y here.
1341da177e4SLinus Torvalds
1351da177e4SLinus Torvaldsconfig OSF4_COMPAT
1361da177e4SLinus Torvalds	bool "OSF/1 v4 readv/writev compatibility"
1371da177e4SLinus Torvalds	depends on ALPHA && BINFMT_AOUT
1381da177e4SLinus Torvalds	help
1391da177e4SLinus Torvalds	  Say Y if you are using OSF/1 binaries (like Netscape and Acrobat)
1401da177e4SLinus Torvalds	  with v4 shared libraries freely available from Compaq. If you're
1411da177e4SLinus Torvalds	  going to use shared libraries from Tru64 version 5.0 or later, say N.
1421da177e4SLinus Torvalds
1431da177e4SLinus Torvaldsconfig BINFMT_EM86
1441da177e4SLinus Torvalds	tristate "Kernel support for Linux/Intel ELF binaries"
1451da177e4SLinus Torvalds	depends on ALPHA
1461da177e4SLinus Torvalds	---help---
1471da177e4SLinus Torvalds	  Say Y here if you want to be able to execute Linux/Intel ELF
1481da177e4SLinus Torvalds	  binaries just like native Alpha binaries on your Alpha machine. For
1491da177e4SLinus Torvalds	  this to work, you need to have the emulator /usr/bin/em86 in place.
1501da177e4SLinus Torvalds
1511da177e4SLinus Torvalds	  You can get the same functionality by saying N here and saying Y to
1521da177e4SLinus Torvalds	  "Kernel support for MISC binaries".
1531da177e4SLinus Torvalds
1541da177e4SLinus Torvalds	  You may answer M to compile the emulation support as a module and
1551da177e4SLinus Torvalds	  later load the module when you want to use a Linux/Intel binary. The
1561da177e4SLinus Torvalds	  module will be called binfmt_em86. If unsure, say Y.
1571da177e4SLinus Torvalds
1581da177e4SLinus Torvaldsconfig BINFMT_MISC
1591da177e4SLinus Torvalds	tristate "Kernel support for MISC binaries"
1601da177e4SLinus Torvalds	---help---
1611da177e4SLinus Torvalds	  If you say Y here, it will be possible to plug wrapper-driven binary
1621da177e4SLinus Torvalds	  formats into the kernel. You will like this especially when you use
1631da177e4SLinus Torvalds	  programs that need an interpreter to run like Java, Python, .NET or
1641da177e4SLinus Torvalds	  Emacs-Lisp. It's also useful if you often run DOS executables under
1651da177e4SLinus Torvalds	  the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from
1661da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>). Once you have
1671da177e4SLinus Torvalds	  registered such a binary class with the kernel, you can start one of
1681da177e4SLinus Torvalds	  those programs simply by typing in its name at a shell prompt; Linux
1691da177e4SLinus Torvalds	  will automatically feed it to the correct interpreter.
1701da177e4SLinus Torvalds
1711da177e4SLinus Torvalds	  You can do other nice things, too. Read the file
1721da177e4SLinus Torvalds	  <file:Documentation/binfmt_misc.txt> to learn how to use this
1731da177e4SLinus Torvalds	  feature, <file:Documentation/java.txt> for information about how
1741da177e4SLinus Torvalds	  to include Java support. and <file:Documentation/mono.txt> for
1751da177e4SLinus Torvalds          information about how to include Mono-based .NET support.
1761da177e4SLinus Torvalds
1771da177e4SLinus Torvalds          To use binfmt_misc, you will need to mount it:
1781da177e4SLinus Torvalds		mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc
1791da177e4SLinus Torvalds
1801da177e4SLinus Torvalds	  You may say M here for module support and later load the module when
1811da177e4SLinus Torvalds	  you have use for it; the module is called binfmt_misc. If you
1821da177e4SLinus Torvalds	  don't know what to answer at this point, say Y.
183046d662fSAlex Kelly
184046d662fSAlex Kellyconfig COREDUMP
185046d662fSAlex Kelly	bool "Enable core dump support" if EXPERT
186046d662fSAlex Kelly	default y
187046d662fSAlex Kelly	help
188046d662fSAlex Kelly	  This option enables support for performing core dumps. You almost
189046d662fSAlex Kelly	  certainly want to say Y here. Not necessary on systems that never
190046d662fSAlex Kelly	  need debugging or only ever run flawless code.
191