sys-utils/setarch.8

.TH SETARCH 8 "Jun 2007" setarch "Linux Programmer's Manual"
.SH NAME
setarch \- change reported architecture in new program environment and set personality flags
.SH SYNOPSIS
\fBsetarch\fR <\fIarch\fR> [\fBoptions\fR] [\fIprogram\fR [\fBarguments\fR]]

\fIarch\fR [\fBoptions\fR] [\fIprogram\fR [\fBarguments\fR]]

.SH DESCRIPTION
.B setarch
This utility currently only affects the output of uname -m. For example, on an AMD64 system, running 'setarch i386 program' will cause 'program' to see
.IR i686
(or other relevant arch) instead of
.IR x86_64
as machine type. It also allows to set various personality options. The default
.B program
is /bin/sh.
.SH OPTIONS
.TP
.I "\-v"
Be verbose.
.TP
.I "\-h," "\-\-help"
Display help (it is also displayed when setarch takes no arguments).
.TP
.I "\-3," "\-\-3gb"
Specifies that processes should use a maximum of 3GB of address space on systems where it is supported (ADDR_LIMIT_3GB).
.TP
.I "\-B"
Turns on ADDR_LIMIT_32BIT.
.TP
.I "\-F"
Userspace function pointers point to descriptors (turns on FDPIC_FUNCPTRS).
.TP
.I "\-I"
Turns on SHORT_INODE.
.TP
.I "\-L"
Changes the way virtual memory is allocated (turns on the ADDR_COMPAT_LAYOUT).
.TP
.I "\-R"
Disables randomization of the virtual address space (turns on ADDR_NO_RANDOMIZE).
.TP
.I "\-S"
Turns on WHOLE_SECONDS.
.TP
.I "\-T"
Turns on STICKY_TIMEOUTS.
.TP
.I "\-X"
Turns on READ_IMPLIES_EXEC.
.TP
.I "\-Z"
Turns on MMAP_PAGE_ZERO.
.SH EXAMPLES
setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm
.br
setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm
.SH AUTHOR
Elliot Lee <sopwith@redhat.com>
.br
Jindrich Novy <jnovy@redhat.com>
.SH AVAILABILITY
The setarch command is part of the util-linux-ng package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.