summaryrefslogtreecommitdiffstats
path: root/sys-utils/setarch.8
blob: ea885c4ba6f771a489993fa8db5c1ac64477ac90 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
.TH SETARCH 8 "September 2011" "util-linux" "System Administration"
.SH NAME
setarch \- change reported architecture in new program environment and set personality flags
.SH SYNOPSIS
.B setarch
.I <arch>
.RI [ options ]
.RI [ program
.RI [ arguments ]]
.br
.B arch
.RI [ options ]
.RI [ program
.RI [ arguments ]]
.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
\fB\-v\fR, \fB\-\-verbose\fR
Be verbose.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help (it is also displayed when setarch takes no arguments).
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version information and exit.
.TP
\fB\-\-uname\-2.6\fR
Causes the program to see a kernel version number beginning with 2.6.
.TP
\fB\-3\fR, \fB\-\-3gb\fR
Specifies that processes should use a maximum of 3GB of address space on systems where it is supported (ADDR_LIMIT_3GB).
.TP
\fB\-\-4gb\fR
Ignored (for backward compatibility only).
.TP
\fB\-\-list\fR
List architectures that can be set.
.TP
\fB\-B\fR, \fB\-\-32bit\fR
Turns on ADDR_LIMIT_32BIT.
.TP
\fB\-F\fR, \fB\-\-fdpic\-funcptrs\fR
Userspace function pointers point to descriptors (turns on FDPIC_FUNCPTRS).
.TP
\fB\-I\fR, \fB\-\-short\-inode\fR
Turns on SHORT_INODE.
.TP
\fB\-L\fR, \fB\-\-addr\-compat\-layout\fR
Changes the way virtual memory is allocated (turns on the ADDR_COMPAT_LAYOUT).
.TP
\fB\-R\fR, \fB\-\-addr\-no\-randomize\fR
Disables randomization of the virtual address space (turns on ADDR_NO_RANDOMIZE).
.TP
\fB\-S\fR, \fB\-\-whole\-seconds\fR
Turns on WHOLE_SECONDS.
.TP
\fB\-T\fR, \fB\-\-sticky\-timeouts\fR
Turns on STICKY_TIMEOUTS.
.TP
\fB\-X\fR, \fB\-\-read\-implies\-exec\fR
Turns on READ_IMPLIES_EXEC.
.TP
\fB\-Z\fR, \fB\-\-mmap\-page\-zero\fR
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
.br
setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm
.SH AUTHOR
.MT sopwith@redhat.com
Elliot Lee
.ME
.br
.MT jnovy@redhat.com
Jindrich Novy
.ME
.SH AVAILABILITY
The setarch command is part of the util-linux package and is available from
.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .