From owner-freebsd-doc Tue Sep 21 10:53:35 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp02.wxs.nl (smtp02.wxs.nl [195.121.6.60]) by hub.freebsd.org (Postfix) with ESMTP id E733915342; Tue, 21 Sep 1999 10:53:30 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.198.4]) by smtp02.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAB257F; Tue, 21 Sep 1999 19:53:28 +0200 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id TAA22567; Tue, 21 Sep 1999 19:50:11 +0200 (CEST) (envelope-from asmodai) Date: Tue, 21 Sep 1999 19:50:11 +0200 From: Jeroen Ruigrok/Asmodai To: Nick Sanders Cc: freebsd-doc@freebsd.org, FreeBSD Gnats Subject: Re: docs/7914: no elf(5) manpage Message-ID: <19990921195010.C22025@daemon.ninth-circle.org> References: <199909210030.RAA64767@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.7i In-Reply-To: <199909210030.RAA64767@freefall.freebsd.org> Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * Nick Sanders (fishy@hotbot.com) [990921 03:54]: > > #1 > The fields have the following meanings: > e_ident > This array of bytes specify how to interpret the file, > > #2 > e_ident > This array of bytes specify how to interpret the file, contents. Within > > Once again, should "specify" be "specifies"? An array specifies, bytes > specify. Corrected #1, #2 is a duplicate of #1. > #3 > SHN_COMMON > Symbols defines relative to this section are common symbols, such as > Fortran COMMON or unallocated C external variables. > > Should "Symbols" be singular? No, Symbols defined is the correct wording, 't was a mere typo. > #4 > The main difference between the 32-bit and the 64-but program header > lies only in the location of a p_flags member in the total struct. > > Should "64-but" be 64-bit? Another misplacement of the finger. > #5 > PT_INTERP > The array element specifies the location and size of a null-terminated > path name to invoke as an interpreter. This segment type is meaningful > only for executable files (though it may occur for shared objects). > However it may present it must precede any loadable segment > > The last sentence in this does not make any sense to me. This must clearly be an error on your machine. I think your follow-up mail deals with this. My test here is: .It Dv PT_INTERP The array element specifies the location and size of a null-terminated path name to invoke as an interpreter. This segment type is meaningful only for executable files (though it may occur for shared objects). However it may not occur more than once in a file. If it is present it must precede any loadable segment entry. > #6 > .data > This section holds initialised data that contribute to the program's > memory image. This section is of type SHT_PROGBITS. The attribute types > are SHF_ALLOC and SHF_WRITE. > > Initialised should be "initialized". If you are a United States citizen. I prefer the Queen's [Original/Olde] English myself. > #7 > .data1 > This section holds initialised data that contribute to the program's > memory image. This section is of type SHT_PROGBITS. The attribute types > are SHF_ALLOC and SHF_WRITE. > > Initialised should be "initialized". See #6. > #8 > .init > > Initialisation should be "initialization" in both occurrences. Is > Initialize with an "s" a British spelling? Bingo =) See $6. > #9 > .relNAME > This section holds relocation information as described below. If the > file has a loadable segment that includes relocation, the section's > attributes will include the SHF_ALLOC bit. Otherwise the bit will be > off. By convention, ``NAME'' is supplied by the section to which the > relocations apply. Thus a relocation section for .text normally would > have the name > > .rel.text. This section is of type SHT_REL. > > Not sure if this is an error in the file or just my system acting > funny. I had an blank rule between "name" and ".rel.text" I have nothing in my mdoc source file which should generate the extra blank line; however nroff -man elf.5 has been known to create spurious blank lines [or any other *roff for that matter]. > #10 > STB_WEAK Weak symbols resemble global symbols, but their > STB_LOPROC This value up to and including STB_HIPROC are reserved for > processor-specific semantics. > > Once again this may just be an error on my machine, but the STB_WEAK > sentence cuts off as shown above. This is really a problem on your machine: .It Dv STB_WEAK Weak symbols resemble global symbols, but their definitions have lower precedence. That's what I have. Anyways, the things you did find are fixed and I am greatful for that. Cheers, -- Jeroen Ruigrok van der Werven/Asmodai asmodai(at)wxs.nl The BSD Programmer's Documentation Project Network/Security Specialist BSD: Technical excellence at its best What is history but a fable agreed 'pon? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message