[deliverable/binutils-gdb.git] / gas / testsuite / gas / i860 / README.i860


Testsuite for the i860 version of the GNU assembler
---------------------------------------------------

This is a simple testsuite for the i860 assembler.  It currently
consists mostly of testcases for checking that every instruction is
parsed correctly and that correct object code is generated (these
are called "blah.s").  The files called "blah-err.s" test for error
conditions.

The suite includes testcases for the base i860XR instruction set as well
as the enhanced i860XP instructions and control registers.

The expected results files were generated using the UNIX System V/i860
Release 4 vendor assembler (/usr/ccs/bin/as -V reports version
"Standard C Development Environment  (SCDE) 5.0 12/08/89").  This
way GAS/i860 is tested against a known good assembler.

TODO:
 - Relocation testing is basically non-existent.
 - pst.d (pixel store) is the only instruction with no testcase.
 - More tests for dual instruction mode: check that dual mode has a
   proper pair (FLOP/core) of instructions, and other error conditions.
 - Most current testcases use the default AT&T/SVR4 syntax; a few simple
   tests of the Intel syntax should be added to prevent bitrot (including
   relocatable expression syntax, etc).  Test file dual03.s uses Intel
   syntax lightly (i.e., register names without '%' prefix).

Contact me (Jason Eckhardt, jle@rice.edu) if you'd like to help.

Known failures:
  - dual01.s: GAS mishandles d.fnop (dual bit erroneously set on next
      instruction).
  - dual02-err.s: GAS currently doesn't check that dual mode pairs
      are properly aligned.
Commit	Line	Data
abac126a JE	1
	2	Testsuite for the i860 version of the GNU assembler
	3	---------------------------------------------------
	4
	5	This is a simple testsuite for the i860 assembler. It currently
c83c4371 JE	6	consists mostly of testcases for checking that every instruction is
	7	parsed correctly and that correct object code is generated (these
	8	are called "blah.s"). The files called "blah-err.s" test for error
	9	conditions.
abac126a	10
c83c4371	11	The suite includes testcases for the base i860XR instruction set as well
abac126a JE	12	as the enhanced i860XP instructions and control registers.
	13
	14	The expected results files were generated using the UNIX System V/i860
	15	Release 4 vendor assembler (/usr/ccs/bin/as -V reports version
	16	"Standard C Development Environment (SCDE) 5.0 12/08/89"). This
	17	way GAS/i860 is tested against a known good assembler.
	18
	19	TODO:
	20	- Relocation testing is basically non-existent.
	21	- pst.d (pixel store) is the only instruction with no testcase.
c83c4371 JE	22	- More tests for dual instruction mode: check that dual mode has a
	23	proper pair (FLOP/core) of instructions, and other error conditions.
	24	- Most current testcases use the default AT&T/SVR4 syntax; a few simple
	25	tests of the Intel syntax should be added to prevent bitrot (including
	26	relocatable expression syntax, etc). Test file dual03.s uses Intel
	27	syntax lightly (i.e., register names without '%' prefix).
abac126a JE	28
	29	Contact me (Jason Eckhardt, jle@rice.edu) if you'd like to help.
	30
c83c4371 JE	31	Known failures:
	32	- dual01.s: GAS mishandles d.fnop (dual bit erroneously set on next
	33	instruction).
	34	- dual02-err.s: GAS currently doesn't check that dual mode pairs
	35	are properly aligned.
	36