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