From owner-svn-src-head@freebsd.org Fri May 5 17:23:59 2017 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1ED57D5FD39; Fri, 5 May 2017 17:23:59 +0000 (UTC) (envelope-from kib@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id D6283109A; Fri, 5 May 2017 17:23:58 +0000 (UTC) (envelope-from kib@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v45HNvr7069411; Fri, 5 May 2017 17:23:57 GMT (envelope-from kib@FreeBSD.org) Received: (from kib@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v45HNvWD069410; Fri, 5 May 2017 17:23:57 GMT (envelope-from kib@FreeBSD.org) Message-Id: <201705051723.v45HNvWD069410@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: kib set sender to kib@FreeBSD.org using -f From: Konstantin Belousov Date: Fri, 5 May 2017 17:23:57 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r317840 - head/share/man/man7 X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 May 2017 17:23:59 -0000 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"