Date: Fri, 5 May 2017 17:23:57 +0000 (UTC) From: Konstantin Belousov <kib@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r317840 - head/share/man/man7 Message-ID: <201705051723.v45HNvWD069410@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: kib Date: Fri May 5 17:23:57 2017 New Revision: 317840 URL: https://svnweb.freebsd.org/changeset/base/317840 Log: Fix some grammar, fix some markup, bump copyright year, provide more exact claims in some cases. Discussed with: bde (most parts) Sponsored by: The FreeBSD Foundation MFC after: 2 weeks Modified: head/share/man/man7/arch.7 Modified: head/share/man/man7/arch.7 ============================================================================== --- head/share/man/man7/arch.7 Fri May 5 17:22:00 2017 (r317839) +++ head/share/man/man7/arch.7 Fri May 5 17:23:57 2017 (r317840) @@ -1,4 +1,4 @@ -.\" Copyright (c) 2016 The FreeBSD Foundation. All rights reserved. +.\" Copyright (c) 2016-2017 The FreeBSD Foundation. All rights reserved. .\" .\" This documentation was created by Ed Maste under sponsorship of .\" The FreeBSD Foundation. @@ -26,7 +26,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 4, 2017 +.Dd May 5, 2017 .Dt ARCH 7 .Os .Sh NAME @@ -41,15 +41,14 @@ The architecture details in this documen .Fx 10.0 and later, unless otherwise noted. .Pp -FreeBSD uses flat address space for program execution, where -pointers have the same binary representation as -.Vt unsigned long -variables, and -.Vt uintptr_t +.Fx +uses flat address space for program execution, +where variables of types +.Vt unsigned long , +.Vt uintptr_t , and .Vt size_t -types are synonyms for -.Vt unsigned long . +and the pointers all have the same representation. .Pp In order to maximize compatibility with future pointer integrity mechanisms, manipulations of pointers as integers should be performed via @@ -110,9 +109,10 @@ architectures, the final release. .It riscv64sf Ta 12.0 .It sparc64 Ta 5.0 .El - .Ss Type sizes -All FreeBSD architectures use some variant of the ELF (see +All +.Fx +architectures use some variant of the ELF (see .Xr elf 5 ) .Sy Application Binary Interface (ABI) for the machine processor. @@ -132,13 +132,15 @@ and .Vt void * are 8 bytes. .El -Compilers define +Compilers define the .Dv _LP64 symbol when compiling for an .Dv LP64 ABI. .Pp -Some machines support more that one FreeBSD ABI. +Some machines support more that one +.Fx +ABI. Typically these are 64-bit machines, where the .Dq native .Dv LP64 @@ -147,7 +149,7 @@ execution environment is accompanied by .Dv ILP32 environment, which was historical 32-bit predecessor for 64-bit evolution. Examples are: -.Bl -column -offset indent "powerpc64" "Sy ILP32 counterpart" +.Bl -column -offset indent "Dv powerpc64" "Sy ILP32 counterpart" .It Sy LP64 Ta Sy ILP32 counterpart .It Dv amd64 Ta Dv i386 .It Dv powerpc64 Ta Dv powerpc @@ -172,7 +174,10 @@ On all supported architectures: .El Integers are represented as two-complement. Alignment of integer and pointer types is natural, that is, -the address of the variable must be congruent to zero modulo type size. +the address of the variable must be congruent to zero modulo the type size. +Most ILP32 ABIs, except +.Dv arm , +require only 4-byte alignment for 64-bit integers. .Pp Machine-dependent type sizes: .Bl -column -offset indent "Sy Architecture" "Sy void *" "Sy long double" "Sy time_t"
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201705051723.v45HNvWD069410>