GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AOUT (4)

NAME

aout - kernel support for executing binary files in legacy a.out format

CONTENTS

Synopsis
Description
See Also
History
Authors
Bugs

SYNOPSIS

kldload a.out

DESCRIPTION

The a.out(5) executable format was used before the release of
.Fx 3.0 . Since i386 was the only supported architecture at that time, a.out(5) executables can only be activated on platforms that support execution of i386 code, such as i386, amd64 and (partially) ia64.

To add kernel support for old syscalls and old syscall invocation methods, place the following options in the kernel configuration file:



.Cd options COMPAT_43

.Cd options COMPAT_FREEBSD32

The COMPAT_FREEBSD32 option is only required on 64-bit CPU architectures.

The aout.ko module needs to be loaded with the kldload(8) utility in order to support the a.out(5) image activator:


 kldload aout

Alternatively, to load the module at boot time, place the following line in loader.conf(5):

aout_load="YES"

The a.out(5) format was mainstream quite a long time ago. Reasonable default settings and security requirements of modern operating systems today contradict the default environment of that time and require adjustments of the system to mimic natural environment for old binaries.

The following sysctl(8) tunables are useful for this:
  Set to 1 to allow mapping of process pages at address 0. Some very old ZMAGIC executable images require text mapping at address 0.
  Old versions of
.Fx used signed 16-bit type for
.Vt pid_t . Current kernels use 32-bit type for
.Vt pid_t , and allow process id’s up to 99999. Such values cannot be represented by old
.Vt pid_t , mostly causing issues for processes using wait(2) syscalls, for example shells. Set the sysctl to 30000 to work around the problem.
  Set to 1 to force any accessible memory mapping performed by 32-bit process to allow execution, see mmap(2). Old i386 CPUs did not have a bit in PTE which disallowed execution from the page, so many old programs did not specify PROT_EXEC even for mapping of executable code. The sysctl forces PROT_EXEC if mapping has any access allowed at all. The setting is only needed if the host architecture allows non-executable mappings.

SEE ALSO

execve(2), a.out(5), elf(5), sysctl(8).

HISTORY

The a.out(5) executable format was used on ancient AT&T and served as the main executable format for
.Fx from the beginning up to
.Fx 2.2.9 . In
.Fx 3.0 it was superseded by elf(5).

AUTHORS

The aout manual page was written by
.An Konstantin Belousov Aq kib@FreeBSD.org .

BUGS

On 64bit architectures, not all wrappers for older syscalls are implemented.
Search for    or go to Top of page |  Section 4 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.