summaryrefslogtreecommitdiffstats
path: root/sys-utils/setarch.8
diff options
context:
space:
mode:
authorBenno Schulenberg2014-07-20 23:15:47 +0200
committerKarel Zak2014-07-21 10:29:44 +0200
commitc372860ddb4a768f7f6c50cd26d60119370d5cd5 (patch)
treef2ae750a95e2a31cecf58f547303122c0924f4f5 /sys-utils/setarch.8
parentdocs: bring five more man pages closer to standard formatting (diff)
downloadkernel-qcow2-util-linux-c372860ddb4a768f7f6c50cd26d60119370d5cd5.tar.gz
kernel-qcow2-util-linux-c372860ddb4a768f7f6c50cd26d60119370d5cd5.tar.xz
kernel-qcow2-util-linux-c372860ddb4a768f7f6c50cd26d60119370d5cd5.zip
docs: bring eight more man pages closer to standard formatting
Also, for chcpu, the options -c, -d, -e and -g are mutually exclusive, and for the mode argument the option -p is not optional. For ldattach, use the standard options separator ", " instead of the unusual " | ". And add the missing --version to several of the pages. Besides, improve the wording and the consistency of the spacing. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
Diffstat (limited to 'sys-utils/setarch.8')
-rw-r--r--sys-utils/setarch.845
1 files changed, 22 insertions, 23 deletions
diff --git a/sys-utils/setarch.8 b/sys-utils/setarch.8
index f8c748fbe..ad9d4c29d 100644
--- a/sys-utils/setarch.8
+++ b/sys-utils/setarch.8
@@ -1,50 +1,43 @@
-.TH SETARCH 8 "September 2011" "util-linux" "System Administration"
+.TH SETARCH 8 "July 2014" "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 ]
+.I arch
+[options]
.RI [ program
.RI [ arguments ]]
+.sp
+.B setarch
+.BR \-\-list | \-h | \-V
.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
+currently only affects the output of \fBuname -m\fR.
+For example, on an AMD64 system, running 'setarch i386 program' will cause 'program' to see
.IR i686
-(or other relevant arch) instead of
+instead of
.IR x86_64
-as machine type. It also allows to set various personality options. The default
+as the 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 text and exit.
-(The help text is also displayed when \fBsetarch\fR receives no arguments.)
-.TP
-\fB\-V\fR, \fB\-\-version\fR
-Display version information and exit.
+\fB\-\-list\fR
+List the architectures that can be set.
.TP
\fB\-\-uname\-2.6\fR
Causes the program to see a kernel version number beginning with 2.6.
.TP
+.BR \-v , " \-\-verbose"
+Be verbose.
+.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
@@ -71,6 +64,12 @@ Turns on READ_IMPLIES_EXEC.
.TP
\fB\-Z\fR, \fB\-\-mmap\-page\-zero\fR
Turns on MMAP_PAGE_ZERO.
+.TP
+.BR \-V , " \-\-version"
+Display version information and exit.
+.TP
+.BR \-h , " \-\-help"
+Display help text and exit.
.SH EXAMPLES
setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm
.br