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