[linux.git] / fs / Kconfig.binfmt

config BINFMT_ELF
	bool "Kernel support for ELF binaries"
	depends on MMU && (BROKEN || !FRV)
	default y
	---help---
	  ELF (Executable and Linkable Format) is a format for libraries and
	  executables used across different architectures and operating
	  systems. Saying Y here will enable your kernel to run ELF binaries
	  and enlarge it by about 13 KB. ELF support under Linux has now all
	  but replaced the traditional Linux a.out formats (QMAGIC and ZMAGIC)
	  because it is portable (this does *not* mean that you will be able
	  to run executables from different architectures or operating systems
	  however) and makes building run-time libraries very easy. Many new
	  executables are distributed solely in ELF format. You definitely
	  want to say Y here.

	  Information about ELF is contained in the ELF HOWTO available from
	  <http://www.tldp.org/docs.html#howto>.

	  If you find that after upgrading from Linux kernel 1.2 and saying Y
	  here, you still can't run any ELF binaries (they just crash), then
	  you'll have to install the newest ELF runtime libraries, including
	  ld.so (check the file <file:Documentation/Changes> for location and
	  latest version).

config COMPAT_BINFMT_ELF
	bool
	depends on COMPAT && BINFMT_ELF

config BINFMT_ELF_FDPIC
	bool "Kernel support for FDPIC ELF binaries"
	default y
	depends on (FRV || BLACKFIN || (SUPERH32 && !MMU))
	help
	  ELF FDPIC binaries are based on ELF, but allow the individual load
	  segments of a binary to be located in memory independently of each
	  other. This makes this format ideal for use in environments where no
	  MMU is available as it still permits text segments to be shared,
	  even if data segments are not.

	  It is also possible to run FDPIC ELF binaries on MMU linux also.

config CORE_DUMP_DEFAULT_ELF_HEADERS
	bool "Write ELF core dumps with partial segments"
	default y
	depends on BINFMT_ELF && ELF_CORE
	help
	  ELF core dump files describe each memory mapping of the crashed
	  process, and can contain or omit the memory contents of each one.
	  The contents of an unmodified text mapping are omitted by default.

	  For an unmodified text mapping of an ELF object, including just
	  the first page of the file in a core dump makes it possible to
	  identify the build ID bits in the file, without paying the i/o
	  cost and disk space to dump all the text.  However, versions of
	  GDB before 6.7 are confused by ELF core dump files in this format.

	  The core dump behavior can be controlled per process using
	  the /proc/PID/coredump_filter pseudo-file; this setting is
	  inherited.  See Documentation/filesystems/proc.txt for details.

	  This config option changes the default setting of coredump_filter
	  seen at boot time.  If unsure, say Y.

config BINFMT_FLAT
	bool "Kernel support for flat binaries"
	depends on !MMU && (!FRV || BROKEN)
	help
	  Support uClinux FLAT format binaries.

config BINFMT_ZFLAT
	bool "Enable ZFLAT support"
	depends on BINFMT_FLAT
	select ZLIB_INFLATE
	help
	  Support FLAT format compressed binaries

config BINFMT_SHARED_FLAT
	bool "Enable shared FLAT support"
	depends on BINFMT_FLAT
	help
	  Support FLAT shared libraries

config HAVE_AOUT
       def_bool n

config BINFMT_AOUT
	tristate "Kernel support for a.out and ECOFF binaries"
	depends on HAVE_AOUT
	---help---
	  A.out (Assembler.OUTput) is a set of formats for libraries and
	  executables used in the earliest versions of UNIX.  Linux used
	  the a.out formats QMAGIC and ZMAGIC until they were replaced
	  with the ELF format.

	  The conversion to ELF started in 1995.  This option is primarily
	  provided for historical interest and for the benefit of those
	  who need to run binaries from that era.

	  Most people should answer N here.  If you think you may have
	  occasional use for this format, enable module support above
	  and answer M here to compile this support as a module called
	  binfmt_aout.

	  If any crucial components of your system (such as /sbin/init
	  or /lib/ld.so) are still in a.out format, you will have to
	  say Y here.

config OSF4_COMPAT
	bool "OSF/1 v4 readv/writev compatibility"
	depends on ALPHA && BINFMT_AOUT
	help
	  Say Y if you are using OSF/1 binaries (like Netscape and Acrobat)
	  with v4 shared libraries freely available from Compaq. If you're
	  going to use shared libraries from Tru64 version 5.0 or later, say N.

config BINFMT_EM86
	tristate "Kernel support for Linux/Intel ELF binaries"
	depends on ALPHA
	---help---
	  Say Y here if you want to be able to execute Linux/Intel ELF
	  binaries just like native Alpha binaries on your Alpha machine. For
	  this to work, you need to have the emulator /usr/bin/em86 in place.

	  You can get the same functionality by saying N here and saying Y to
	  "Kernel support for MISC binaries".

	  You may answer M to compile the emulation support as a module and
	  later load the module when you want to use a Linux/Intel binary. The
	  module will be called binfmt_em86. If unsure, say Y.

config BINFMT_SOM
	tristate "Kernel support for SOM binaries"
	depends on PARISC && HPUX
	help
	  SOM is a binary executable format inherited from HP/UX.  Say
	  Y here to be able to load and execute SOM binaries directly.

config BINFMT_MISC
	tristate "Kernel support for MISC binaries"
	---help---
	  If you say Y here, it will be possible to plug wrapper-driven binary
	  formats into the kernel. You will like this especially when you use
	  programs that need an interpreter to run like Java, Python, .NET or
	  Emacs-Lisp. It's also useful if you often run DOS executables under
	  the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from
	  <http://www.tldp.org/docs.html#howto>). Once you have
	  registered such a binary class with the kernel, you can start one of
	  those programs simply by typing in its name at a shell prompt; Linux
	  will automatically feed it to the correct interpreter.

	  You can do other nice things, too. Read the file
	  <file:Documentation/binfmt_misc.txt> to learn how to use this
	  feature, <file:Documentation/java.txt> for information about how
	  to include Java support. and <file:Documentation/mono.txt> for
          information about how to include Mono-based .NET support.

          To use binfmt_misc, you will need to mount it:
		mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc

	  You may say M here for module support and later load the module when
	  you have use for it; the module is called binfmt_misc. If you
	  don't know what to answer at this point, say Y.
Commit	Line	Data
1da177e4 LT	1	config BINFMT_ELF
1da177e4 LT	2	bool "Kernel support for ELF binaries"
2919b510	3	depends on MMU && (BROKEN \|\| !FRV)
1da177e4 LT	4	default y
	5	---help---
	6	ELF (Executable and Linkable Format) is a format for libraries and
	7	executables used across different architectures and operating
	8	systems. Saying Y here will enable your kernel to run ELF binaries
	9	and enlarge it by about 13 KB. ELF support under Linux has now all
	10	but replaced the traditional Linux a.out formats (QMAGIC and ZMAGIC)
	11	because it is portable (this does not mean that you will be able
	12	to run executables from different architectures or operating systems
	13	however) and makes building run-time libraries very easy. Many new
	14	executables are distributed solely in ELF format. You definitely
	15	want to say Y here.
	16
	17	Information about ELF is contained in the ELF HOWTO available from
	18	<http://www.tldp.org/docs.html#howto>.
	19
	20	If you find that after upgrading from Linux kernel 1.2 and saying Y
	21	here, you still can't run any ELF binaries (they just crash), then
	22	you'll have to install the newest ELF runtime libraries, including
	23	ld.so (check the file <file:Documentation/Changes> for location and
	24	latest version).
	25
b9d36d5d RM	26	config COMPAT_BINFMT_ELF
b9d36d5d RM	27	bool
4cea5ceb	28	depends on COMPAT && BINFMT_ELF
b9d36d5d	29
1da177e4 LT	30	config BINFMT_ELF_FDPIC
	31	bool "Kernel support for FDPIC ELF binaries"
	32	default y
3bc24a1a	33	depends on (FRV \|\| BLACKFIN \|\| (SUPERH32 && !MMU))
1da177e4 LT	34	help
	35	ELF FDPIC binaries are based on ELF, but allow the individual load
	36	segments of a binary to be located in memory independently of each
	37	other. This makes this format ideal for use in environments where no
	38	MMU is available as it still permits text segments to be shared,
	39	even if data segments are not.
	40
	41	It is also possible to run FDPIC ELF binaries on MMU linux also.
	42
656eb2cd RM	43	config CORE_DUMP_DEFAULT_ELF_HEADERS
656eb2cd RM	44	bool "Write ELF core dumps with partial segments"
89502155	45	default y
2d96d105	46	depends on BINFMT_ELF && ELF_CORE
656eb2cd RM	47	help
	48	ELF core dump files describe each memory mapping of the crashed
	49	process, and can contain or omit the memory contents of each one.
	50	The contents of an unmodified text mapping are omitted by default.
	51
	52	For an unmodified text mapping of an ELF object, including just
	53	the first page of the file in a core dump makes it possible to
	54	identify the build ID bits in the file, without paying the i/o
	55	cost and disk space to dump all the text. However, versions of
	56	GDB before 6.7 are confused by ELF core dump files in this format.
	57
	58	The core dump behavior can be controlled per process using
	59	the /proc/PID/coredump_filter pseudo-file; this setting is
	60	inherited. See Documentation/filesystems/proc.txt for details.
	61
	62	This config option changes the default setting of coredump_filter
89502155	63	seen at boot time. If unsure, say Y.
656eb2cd	64
1da177e4	65	config BINFMT_FLAT
3202e181	66	bool "Kernel support for flat binaries"
b8c141e8	67	depends on !MMU && (!FRV \|\| BROKEN)
1da177e4 LT	68	help
	69	Support uClinux FLAT format binaries.
	70
	71	config BINFMT_ZFLAT
	72	bool "Enable ZFLAT support"
	73	depends on BINFMT_FLAT
	74	select ZLIB_INFLATE
	75	help
	76	Support FLAT format compressed binaries
	77
	78	config BINFMT_SHARED_FLAT
	79	bool "Enable shared FLAT support"
	80	depends on BINFMT_FLAT
	81	help
	82	Support FLAT shared libraries
	83
e17c6d56 DW	84	config HAVE_AOUT
	85	def_bool n
	86
1da177e4 LT	87	config BINFMT_AOUT
1da177e4 LT	88	tristate "Kernel support for a.out and ECOFF binaries"
e17c6d56	89	depends on HAVE_AOUT
1da177e4 LT	90	---help---
	91	A.out (Assembler.OUTput) is a set of formats for libraries and
	92	executables used in the earliest versions of UNIX. Linux used
	93	the a.out formats QMAGIC and ZMAGIC until they were replaced
	94	with the ELF format.
	95
	96	The conversion to ELF started in 1995. This option is primarily
	97	provided for historical interest and for the benefit of those
	98	who need to run binaries from that era.
	99
	100	Most people should answer N here. If you think you may have
	101	occasional use for this format, enable module support above
	102	and answer M here to compile this support as a module called
	103	binfmt_aout.
	104
	105	If any crucial components of your system (such as /sbin/init
	106	or /lib/ld.so) are still in a.out format, you will have to
	107	say Y here.
	108
	109	config OSF4_COMPAT
	110	bool "OSF/1 v4 readv/writev compatibility"
	111	depends on ALPHA && BINFMT_AOUT
	112	help
	113	Say Y if you are using OSF/1 binaries (like Netscape and Acrobat)
	114	with v4 shared libraries freely available from Compaq. If you're
	115	going to use shared libraries from Tru64 version 5.0 or later, say N.
	116
	117	config BINFMT_EM86
	118	tristate "Kernel support for Linux/Intel ELF binaries"
	119	depends on ALPHA
	120	---help---
	121	Say Y here if you want to be able to execute Linux/Intel ELF
	122	binaries just like native Alpha binaries on your Alpha machine. For
	123	this to work, you need to have the emulator /usr/bin/em86 in place.
	124
	125	You can get the same functionality by saying N here and saying Y to
	126	"Kernel support for MISC binaries".
	127
	128	You may answer M to compile the emulation support as a module and
	129	later load the module when you want to use a Linux/Intel binary. The
	130	module will be called binfmt_em86. If unsure, say Y.
	131
	132	config BINFMT_SOM
	133	tristate "Kernel support for SOM binaries"
	134	depends on PARISC && HPUX
	135	help
	136	SOM is a binary executable format inherited from HP/UX. Say
	137	Y here to be able to load and execute SOM binaries directly.
	138
	139	config BINFMT_MISC
	140	tristate "Kernel support for MISC binaries"
	141	---help---
	142	If you say Y here, it will be possible to plug wrapper-driven binary
	143	formats into the kernel. You will like this especially when you use
	144	programs that need an interpreter to run like Java, Python, .NET or
	145	Emacs-Lisp. It's also useful if you often run DOS executables under
	146	the Linux DOS emulator DOSEMU (read the DOSEMU-HOWTO, available from
	147	<http://www.tldp.org/docs.html#howto>). Once you have
	148	registered such a binary class with the kernel, you can start one of
	149	those programs simply by typing in its name at a shell prompt; Linux
	150	will automatically feed it to the correct interpreter.
	151
	152	You can do other nice things, too. Read the file
	153	<file:Documentation/binfmt_misc.txt> to learn how to use this
154	feature, <file:Documentation/java.txt> for information about how
155	to include Java support. and <file:Documentation/mono.txt> for
156	information about how to include Mono-based .NET support.
157
158	To use binfmt_misc, you will need to mount it:
159	mount binfmt_misc -t binfmt_misc /proc/sys/fs/binfmt_misc
160
161	You may say M here for module support and later load the module when
162	you have use for it; the module is called binfmt_misc. If you
163	don't know what to answer at this point, say Y.