summaryrefslogtreecommitdiffstats
path: root/sys-utils/setarch.8
diff options
context:
space:
mode:
authorKarel Zak2007-07-02 13:48:15 +0200
committerKarel Zak2007-07-02 13:48:15 +0200
commit8b3a46d2b023e3f4d5cd6778cdf17ecd3d5911d7 (patch)
treee7a428fab949cf0bc75a4342628e32c5e2d9cba9 /sys-utils/setarch.8
parentbuild-sys: cleanup architecture conditionals (diff)
downloadkernel-qcow2-util-linux-8b3a46d2b023e3f4d5cd6778cdf17ecd3d5911d7.tar.gz
kernel-qcow2-util-linux-8b3a46d2b023e3f4d5cd6778cdf17ecd3d5911d7.tar.xz
kernel-qcow2-util-linux-8b3a46d2b023e3f4d5cd6778cdf17ecd3d5911d7.zip
sys-utils: added setarch command
This patch merges setarch command to util-linux-ng code. Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/setarch.8')
-rw-r--r--sys-utils/setarch.865
1 files changed, 65 insertions, 0 deletions
diff --git a/sys-utils/setarch.8 b/sys-utils/setarch.8
new file mode 100644
index 000000000..57bb6f7fe
--- /dev/null
+++ b/sys-utils/setarch.8
@@ -0,0 +1,65 @@
+.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"
+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
+setarch is part of the util-linux-ng package and is available from
+ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.