Binary Relocatable Format - Revision history

Tingo: added Glossary category

2014-07-23T21:21:51Z

added Glossary category

← Older revision		Revision as of 21:21, 23 July 2014
Line 191:		Line 191:

	<!-- Add a category [Category:??]] -->		<!-- Add a category [Category:??]] -->
			[[Category:Glossary]]

TArntsen: Change BYL/BYC and note BRF linker manual error

2010-08-13T14:49:10Z

Change BYL/BYC and note BRF linker manual error

← Older revision		Revision as of 14:49, 13 August 2010
Line 96:		Line 96:
	\| 43<sub><small>8</small></sub> * \|\| CXC \|\| 9 (10) \|\| Wi -> W4 + ADR + i-5) (i = 5 to 10)		\| 43<sub><small>8</small></sub> * \|\| CXC \|\| 9 (10) \|\| Wi -> W4 + ADR + i-5) (i = 5 to 10)
	\|-		\|-
	\| 44<sub><small>8</small></sub> \|\| BYL \|\| 2 \|\| W2(bit 0-7) -> (W1+(PB))(bit 0-7) if W2 bit 15=0		\| 44<sub><small>8</small></sub> \|\| BYL \|\| 2 \|\| W2(bit 0-7) -> (W1+(PB))(bit 0-7) if W2 bit 15=1 **
	\|-		\|-
	\| \|\| \|\| \|\| W2(bit 0-7) -> (W1+(PB))(bit 8-15) if W2 bit 15=1		\| \|\| \|\| \|\| W2(bit 0-7) -> (W1+(PB))(bit 8-15) if W2 bit 15=0 **
	\|-		\|-
	\| 45<sub><small>8</small></sub> * \|\| BYC \|\| 5 \|\| W5(bit 0-7) -> (W4+(ADR))(bit 0-7) if W5 bit 15=0		\| 45<sub><small>8</small></sub> * \|\| BYC \|\| 5 \|\| W5(bit 0-7) -> (W4+(ADR))(bit 0-7) if W5 bit 15=1 **
	\|-		\|-
	\| \|\| \|\| \|\| W5(bit 0-7) -> (W4+(ADR))(bit 8-15) if W5 bit 15=1		\| \|\| \|\| \|\| W5(bit 0-7) -> (W4+(ADR))(bit 8-15) if W5 bit 15=0 **
	\|-		\|-
	\| 46<sub><small>8</small></sub> \|\| NWL \|\| 1 \|\| W1 contains line number. (Not in use.)		\| 46<sub><small>8</small></sub> \|\| NWL \|\| 1 \|\| W1 contains line number. (Not in use.)
Line 119:		Line 119:
	\|-		\|-
	\|colspan="4"\| * The W1, W2, and W3 contains a common block name. At load time the symbol must be defined. Its value is referred to as '''ADR'''.		\|colspan="4"\| * The W1, W2, and W3 contains a common block name. At load time the symbol must be defined. Its value is referred to as '''ADR'''.
			\|-
			\|colspan="4"\| ** The documentation says the opposite (bit 0-7 if bit 15=0), but the documentation appears to be incorrect here.
	\|}		\|}

TArntsen: Section titles, more information

2010-07-30T14:35:20Z

Section titles, more information

← Older revision		Revision as of 14:35, 30 July 2010
Line 17:		Line 17:
	</pre>		</pre>

			=== BRF Control Numbers ===
	The possible values and meaning of the control numbers are described in the following table. 'Words' are 16-bits words in big endian format.		The possible values and meaning of the control numbers are described in the following table. 'Words' are 16-bits words in big endian format.
	{\| class="wikitable"		{\| class="wikitable"
Line 120:		Line 121:
	\|}		\|}

	The [[BRF Linker]] can also be used to inspect BRF code. The example below shows how to look at a single library function, "5STOP" (an internal Fortran function) from the Fortran-100 2-bank library file FORTRAN-2BANK:BRF. The BRF Linker command ''LIST-BRF-CODE'' is used to show the library entry.		=== BRF decoding example ===

			The [[BRF Linker]] can also be used to inspect BRF code. The example below shows how to look at a single library function, "5STOP" (an internal Fortran function) from the Fortran-100 2-bank library file FORTRAN-2BANK:BRF. The BRF Linker command ''LIST-BRF-CODE'' is used to show the library entry. The columns are interpreted as follows:
			# Current location counter (octal)
			# BRF control number (octal)
			# BRF control number mnemonic
			# Either:
			#* Symbolic names (LIBR, ENTR, MAIN etc.), or
			#* Binary information (octal)
			# Disassembled instruction (if program mode, e.g. set by PMO)
			# Other values (octal), if relevant

	<pre>		<pre>
Line 171:		Line 182:
	Brl:		Brl:
	</pre>		</pre>

			Note that the disassembled code may not be the final instruction as will be seen in the linked PROG file. In the example above the three '''AFR''' entries are used to modify the values of earlier fields (see AFR description in the table of control numbers). Here the location PB+3, which is 0+3, i.e. location counter 3 in the listing ('''0 STZ ''' is changed to 2, which is '''STZ 2''', and locations 20<sub><small>8</small></sub> and 16<sub><small>8</small></sub> are added with 210<sub><small>8</small></sub>, resulting in instructions '''STA ,B - 161''' and '''STA ,B - 162''' respectively.

	== References ==		== References ==

TArntsen: Typo: -group -> S-group (control word 32b)

2010-07-29T16:09:25Z

Typo: -group -> S-group (control word 32b)

← Older revision		Revision as of 16:09, 29 July 2010
Line 75:		Line 75:
	\| 31<sub><small>8</small></sub> \|\| \|\| - \|\| Not used		\| 31<sub><small>8</small></sub> \|\| \|\| - \|\| Not used
	\|-		\|-
	\| 32<sub><small>8</small></sub> \|\| LONG \|\| 0 \|\| Flags a six-byte [[-group]] (see MAIN,LIBR,ENTR,REF,ASF,ADS,INC,DBC,RLC,CXC)		\| 32<sub><small>8</small></sub> \|\| LONG \|\| 0 \|\| Flags a six-byte [[S-group]] (see MAIN,LIBR,ENTR,REF,ASF,ADS,INC,DBC,RLC,CXC)
	\|-		\|-
	\| 33<sub><small>8</small></sub> \|\| \|\| - \|\| Not used		\| 33<sub><small>8</small></sub> \|\| \|\| - \|\| Not used

TArntsen: Added clarifying 'also'.

2010-07-29T14:29:55Z

Added clarifying 'also'.

← Older revision		Revision as of 14:29, 29 July 2010
Line 120:		Line 120:
	\|}		\|}

	The [[BRF Linker]] can be used to inspect BRF code. The example below shows how to look at a single library function, "5STOP" (an internal Fortran function) from the Fortran-100 2-bank library file FORTRAN-2BANK:BRF. The BRF Linker command ''LIST-BRF-CODE'' is used to show the library entry.		The [[BRF Linker]] can also be used to inspect BRF code. The example below shows how to look at a single library function, "5STOP" (an internal Fortran function) from the Fortran-100 2-bank library file FORTRAN-2BANK:BRF. The BRF Linker command ''LIST-BRF-CODE'' is used to show the library entry.

	<pre>		<pre>

TArntsen: Add BRF Linker inspection example

2010-07-29T14:28:55Z

Add BRF Linker inspection example

@@ Line 119: / Line 119: @@
 |colspan="4"| * The W1, W2, and W3 contains a common block name. At load time the symbol must be defined. Its value is referred to as '''ADR'''.
 |}
 == References ==

TArntsen: BYC also refers ADR

2010-07-29T13:36:51Z

BYC also refers ADR

← Older revision		Revision as of 13:36, 29 July 2010
Line 99:		Line 99:
	\| \|\| \|\| \|\| W2(bit 0-7) -> (W1+(PB))(bit 8-15) if W2 bit 15=1		\| \|\| \|\| \|\| W2(bit 0-7) -> (W1+(PB))(bit 8-15) if W2 bit 15=1
	\|-		\|-
	\| 45<sub><small>8</small></sub> \|\| BYC \|\| 5 \|\| W5(bit 0-7) -> (W4+(ADR))(bit 0-7) if W5 bit 15=0		\| 45<sub><small>8</small></sub> * \|\| BYC \|\| 5 \|\| W5(bit 0-7) -> (W4+(ADR))(bit 0-7) if W5 bit 15=0
	\|-		\|-
	\| \|\| \|\| \|\| W5(bit 0-7) -> (W4+(ADR))(bit 8-15) if W5 bit 15=1		\| \|\| \|\| \|\| W5(bit 0-7) -> (W4+(ADR))(bit 8-15) if W5 bit 15=1

TArntsen: Start of documenting BRF structure

2010-07-28T15:36:55Z

Start of documenting BRF structure

New page

BRF code is a stream of eight-bit bytes and can be stored on any
data medium (tape, file etc). The information can be divided into
the following three basic types:

*Control information: A single byte, the control number. This is interpreted as a linker command.

*Programmed information: Two bytes containing a 16-bit word, called a P-group

*Symbolic information in either four bytes for MAC or NPL, or six bytes for BRF produced by compilers (e.g. FORTRAN). This is called an S-group and contains a symbol of one to seven [[packed six-bit characters]].

BRF code are sequences of BRF groups, where each BRF group is a a combination of the three basic types. A BRF group can take one of the following four forms:
<pre>
<control number byte>
<control number byte><P-group><P-group>
<control number byte><S-group>
<control number byte><S-group><P-group>
</pre>

The possible values and meaning of the control numbers are described in the following table. 'Words' are 16-bits words in big endian format.
{| class="wikitable"
|+ Binary control numbers
|-
! Control Number !! Mnemonic !! Argument size in words!! Interpretation
|-
| 08 || FEED || 0 || Ignored
|-
| 18 || LF || 1 || W1 -> ((CLC)), (CLC)+1 -> (CLC)
|-
| 28 || LR || 1|| W1+(PB) -> ((CLC)),(CLC)+1 -> (CLC)
|-
| 38 || LC || 1 || W1+(CDB) -> ((CLC)),(CLC)+1 -> (CLC)
|-
| 48 || AFF || 2 || W1+(W2)->(W2)
|-
| 58 || ARF || 2 || W1+(PB)+(W2) -> (W2)
|-
| 68 || AFR || 2 || W1+(W2+(PB)) -> (W2+(PB))
|-
| 78 || ARR || 2 || W1+(PB)+(W2+(PB)) -> (W2+(PB))
|-
| 108 || SFL || 1 || W1 -> (CLC)
|-
| 118 || AFL || 1 || W1+(CLC) -> (CLC), fill zeroes
|-
| 128 || SRL || 1 || W1+(PB) -> (CLC)
|-
| 138 || || - || Not used
|-
| 148 || MAIN || 2 (3) || Symbol in [[S-group]] will become the main entry. Size of S-group depends on LONG control number.
|-
| 158 || LIBR || 2 (3) || Symbol in [[S-group]] will be conditionally loaded
|-
| 168 || ENTR || 2 (3) || Symbol in the [[S-group]] is assigned value of CLC
|-
| 178 || BEG || 0 || (CLC) -> (PB) First control byte of a unit. Linker-managed counters reset.
|-
| 208 || REF || 2 (3) || Symbol in [[S-group]] is referenced in CLC
|-
| 218 || END || 1 || W1 contains the BRF checksum
|-
| 228 || INHB || 1 || Warns that compilation errors have occured
|-
| 238 || EOF || 0 || End of loading
|-
| 248 || LNF || 1+W1 || W2,W3....,Wn -> (CLC),....,(CLC+W1-1)
|-
| 258 || RT || 1 || W1 contains real time priority
|-
| 268 || ASF || 3 (4) || <symbol>,<number> Defines common length. Value of symbol in loader table = common start address.
|-
| 278 || ADS || 2 (3) || <symbol> + (CLC-1) -> (CLC-1) Adds common address
|-
| 308 || MSG || 1+W1 || W1 contains length of message in words: W1 is followed by W1*2 ASCII character bytes
|-
| 318 || || - || Not used
|-
| 328 || LONG || 0 || Flags a six-byte [[-group]] (see MAIN,LIBR,ENTR,REF,ASF,ADS,INC,DBC,RLC,CXC)
|-
| 338 || || - || Not used
|-
| 348 || INL || 2 || W2 -> (W1+(PB))
|-
| 358 || DBL || 3 || Wi -> (W1+(BP)+i-2) (i = 2 to 3)
|-
| 368 || RLL || 4 || Wi -> (W1+(PB)+i-2) (i = 2 to 4)
|-
| 378 || CLX || 7 || Wi -> (W1+(PB)+i-2) (i = 2 to 7)
|-
| 408 * || INC || 4 (5) || W5 -> (W4 + ADR)
|-
| 418 * || DBC || 5 (6) || Wi -> (W4 + ADR + i-5) (i = 5 to 6)
|-
| 428 * || RLC || 6 (7) || Wi -> (W4 + ADR + i-5) (i = 5 to 7)
|-
| 438 * || CXC || 9 (10) || Wi -> W4 + ADR + i-5) (i = 5 to 10)
|-
| 448 || BYL || 2 || W2(bit 0-7) -> (W1+(PB))(bit 0-7) if W2 bit 15=0
|-
| || || || W2(bit 0-7) -> (W1+(PB))(bit 8-15) if W2 bit 15=1
|-
| 458 || BYC || 5 || W5(bit 0-7) -> (W4+(ADR))(bit 0-7) if W5 bit 15=0
|-
| || || || W5(bit 0-7) -> (W4+(ADR))(bit 8-15) if W5 bit 15=1
|-
| 468 || NWL || 1 || W1 contains line number. (Not in use.)
|-
| 478 || DBG || 0 || Indicates start/stop of Debug information
|-
| 508 || PMO || 0 || Indicates start of program bank mode
|-
| 518 || DMO || 0 || Indicates start of data bank mode
|-
| 528 || LRP || 1 || Same as LR but PB of program bank
|-
| 538 || LRD || 1 || Same as LR but PB of data bank
|-
| 548 || DIC || - || Dictionary table follows. Each element contains name (3 words) and byte pointer (2 words). End of table marked by -1
|-
|colspan="4"| * The W1, W2, and W3 contains a common block name. At load time the symbol must be defined. Its value is referred to as '''ADR'''.
|}

== References ==
*{{ND-doc|60.196.01|Chapter 6}}