setarch modifies execution domains and process personality flags.
The execution domains currently only affects the output of uname -m.
For example, on an AMD64 system, running setarch i386 program will
cause program to see i686 instead of x86_64 as the machine type. It
can also be used to set various personality options. The default
program is /bin/sh.
Since version 2.33 the arch command line argument is optional and
setarch may be used to change personality flags (ADDR_LIMIT_*,
SHORT_INODE, etc) without modification of the execution domain.
--list List the architectures that setarch knows about. Whether
setarch can actually set each of these architectures depends
on the running kernel.
Causes the program to see a kernel version number beginning
with 2.6. Turns on UNAME26.
Specifies program should use a maximum of 3GB of address
space. Supported on x86. Turns on ADDR_LIMIT_3GB.
--4gb This option has no effect. It is retained for backward
compatibility only, and may be removed in future releases.
Limit the address space to 32 bits to emulate hardware.
Supported on ARM and Alpha. Turns on ADDR_LIMIT_32BIT.
Treat user-space function pointers to signal handlers as
pointers to address descriptors. This option has no effect on
architectures that do not support FDPIC ELF binaries. In
kernel v4.14 support is limited to ARM, Blackfin, Fujitsu FR-
V, and SuperH CPU architectures.
Obsolete bug emulation flag. Turns on SHORT_INODE.
Provide legacy virtual address space layout. Use when the
program binary does not have PT_GNU_STACK ELF header. Turns
Disables randomization of the virtual address space. Turns on
Obsolete bug emulation flag. Turns on WHOLE_SECONDS.
This makes select(2), pselect(2), and ppoll(2) system calls
preserve the timeout value instead of modifying it to reflect
the amount of time not slept when interrupted by a signal
handler. Use when program depends on this behavior. For more
details see the timeout description in select(2) manual page.
Turns on STICKY_TIMEOUTS.
If this is set then mmap(3p) PROT_READ will also add the
PROT_EXEC bit - as expected by legacy x86 binaries. Notice
that the ELF loader will automatically set this bit when it
encounters a legacy binary. Turns on READ_IMPLIES_EXEC.
SVr4 bug emulation that will set mmap(3p) page zero as read-
only. Use when program depends on this behavior, and the
source code is not available to be fixed. Turns on
Display version information and exit.
Display help text and exit.
This page is part of the util-linux (a random collection of Linux
utilities) project. Information about the project can be found at
⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
bug report for this manual page, send it to
email@example.com. This page was obtained from the
project's upstream Git repository
2020-07-14. (At that time, the date of the most recent commit that
was found in the repository was 2020-07-14.) If you discover any
rendering problems in this HTML version of the page, or you believe
there is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
util-linux December 2017 SETARCH(8)