sys-utils/setarch.8

   1 .TH SETARCH 8 "Jun 2007" setarch "Linux Programmer's Manual"
   2 .SH NAME
   3 setarch \- change reported architecture in new program environment and set personality flags
   4 .SH SYNOPSIS
   5 .B setarch
   6 .I arch
   7 .RI [ options ]
   8 .RI [ program
   9 .RI [ arguments ]]
  10 .br
  11 .I arch
  12 .RI [ options ]
  13 .RI [ program
  14 .RI [ arguments ]]
  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
  26 .I "\-v," "\-\-verbose"
  27 Be verbose.
  28 .TP
  29 .I "\-h," "\-\-help"
  30 Display help (it is also displayed when setarch takes no arguments).
  31 .TP
  32 .I "\-3," "\-\-3gb"
  33 Specifies that processes should use a maximum of 3GB of address space on systems where it is supported (ADDR_LIMIT_3GB).
  34 .TP
  35 .I "\-B," "\-\-32bit"
  36 Turns on ADDR_LIMIT_32BIT.
  37 .TP
  38 .I "\-F," "\-\-fdpic-funcptrs"
  39 Userspace function pointers point to descriptors (turns on FDPIC_FUNCPTRS).
  40 .TP
  41 .I "\-I," "\-\-short-inode"
  42 Turns on SHORT_INODE.
  43 .TP
  44 .I "\-L," "\-\-addr-compat-layout"
  45 Changes the way virtual memory is allocated (turns on the ADDR_COMPAT_LAYOUT).
  46 .TP
  47 .I "\-R," "\-\-addr-no-randomize"
  48 Disables randomization of the virtual address space (turns on ADDR_NO_RANDOMIZE).
  49 .TP
  50 .I "\-S," "\-\-whole-seconds"
  51 Turns on WHOLE_SECONDS.
  52 .TP
  53 .I "\-T," "\-\-sticky-timeouts"
  54 Turns on STICKY_TIMEOUTS.
  55 .TP
  56 .I "\-X" "\-\-read-implies-exec"
  57 Turns on READ_IMPLIES_EXEC.
  58 .TP
  59 .I "\-Z," "mmap-page-zero"
  60 Turns on MMAP_PAGE_ZERO.
  61 .SH EXAMPLES
  62 setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm
  63 .br
  64 setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm
  65 .br
  66 setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm
  67 .SH AUTHOR
  68 Elliot Lee <sopwith@redhat.com>
  69 .br
  70 Jindrich Novy <jnovy@redhat.com>
  71 .SH AVAILABILITY
  72 The setarch command is part of the util-linux-ng package and is available from
  73 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.