From owner-freebsd-doc  Sun Jan 20  7:30: 7 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 13CFD37B41D
	for <freebsd-doc@freebsd.org>; Sun, 20 Jan 2002 07:30:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g0KFU1O84634;
	Sun, 20 Jan 2002 07:30:01 -0800 (PST)
	(envelope-from gnats)
Received: from c164-147.pro.thalamus.se (c164-147.pro.thalamus.se [212.31.164.147])
	by hub.freebsd.org (Postfix) with ESMTP id DE94B37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Jan 2002 07:24:44 -0800 (PST)
Received: (from redpixel@localhost)
	by c164-147.pro.thalamus.se (8.11.6/8.11.6) id g0KFOiY42115;
	Sun, 20 Jan 2002 16:24:44 +0100 (CET)
	(envelope-from redpixel)
Message-Id: <200201201524.g0KFOiY42115@c164-147.pro.thalamus.se>
Date: Sun, 20 Jan 2002 16:24:44 +0100 (CET)
From: Martin Faxer <redpixel@c164-147.pro.thalamus.se>
Reply-To: Martin Faxer <redpixel@c164-147.pro.thalamus.se>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/34088: a.out(5) fails to explain what bss is
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         34088
>Category:       docs
>Synopsis:       a.out(5) fails to explain what bss is
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 20 07:30:00 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Martin Faxer <gmh003532@brfmasthugget.se>
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
None
>Environment:
System: FreeBSD lockdown.nodomain 5.0-CURRENT FreeBSD 5.0-CURRENT #6: Sun Jan 13 21:13:40 CET 2002 redpixel@lockdown.nodomain:/usr/obj/usr/src/sys/LOCKDOWN i386


>Description:
	The a.out(5) man page states that nobody agrees on what the 
	abbreviation bss stands for.
	This appears to be incorrect; after discussing on IRC and checking
	various sites on the internet everybody seems to agree upon the
	fact that it stands for "Block Started by Symbol".
	URL reference: http://www.faqs.org/faqs/unix-faq/faq/part1/section-3.html
>How-To-Repeat:
	Check the BUGS section of the a.out(5) man page, rev 1.13.
>Fix:

	Apply the following fix (or a better one; I'm not familiar with
	the mdoc(7) syntax) against rev 1.13 of the file
	/usr/src/share/man/man5/a.out.5:

	--- a.out.5.orig        Sun Jan 20 15:06:00 2002
	+++ a.out.5     Sun Jan 20 15:21:47 2002
	@@ -172,6 +172,10 @@
	 after the data segment.
	 The kernel loads the program so that this amount of writable memory
	 appears to follow the data segment and initially reads as zeroes.
	+.Po
	+.Em bss
	+= block started by symbol
	+.Pc
	 .It Fa a_syms
	 Contains the size in bytes of the symbol table section.
	 .It Fa a_entry
	@@ -456,7 +460,3 @@
	 the byte order of the
	 .Fa exec
	 header is machine-dependent.
	-.Pp
	-Nobody seems to agree on what
	-.Em bss
	-stands for.

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message