Annotation of sys/arch/m68k/060sp/ReadMe.NetBSD, Revision 1.1.1.1
1.1 nbrk 1: $OpenBSD: ReadMe.NetBSD,v 1.2 1996/05/30 22:13:57 niklas Exp $
2: $NetBSD: ReadMe.NetBSD,v 1.1 1996/05/15 21:06:20 is Exp $
3:
4: Copyright (c) 1996 Ignatios Souvatzis. All rights reserved.
5:
6: Redistribution and use in source and binary forms, with or without
7: modification, are permitted provided that the following conditions
8: are met:
9: 1. Redistributions of source code must retain the above copyright
10: notice, this list of conditions and the following disclaimer.
11: 2. Redistributions in binary form must reproduce the above copyright
12: notice, this list of conditions and the following disclaimer in the
13: documentation and/or other materials provided with the distribution.
14: 3. All advertising materials mentioning features or use of this software
15: must display the following acknowledgement:
16: This product includes software developed by Ignatios Souvatzis.
17: 4. The name of the author may not be used to endorse or promote products
18: derived from this software without specific prior written permission.
19:
20: THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
21: IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
22: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
23: IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
24: INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25: NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30:
31:
32: Notes about the NetBSD integration
33: ----------------------------------
34:
35: Preface and Acknowledgements:
36:
37: A first try at integrating the M68060 Software Package was done by
38: Yasushi Yamasaki of the NetBSD/x68k group, but only available as a
39: patch file to their source tree (which wasn't integrated into the
40: NetBSD master tree at that time).
41:
42: I started with their glue code version from the patch file, and
43: changed the following things up to now:
44:
45: - collapse a few identical glue routines (fetch code/data words/longs
46: from user space) into a multi-labeled one
47:
48: - make the gas syntax files of the glue code the Master files
49:
50: - I call the access error handler (label _buserr) directly, instead of
51: through an RTE as in the example file
52:
53: Other changes are only in the method this was integrated into the
54: Amiga vs. X68k port, which is machine dependend anyway.
55:
56: Thanks for the initial effort!
57:
58:
59:
60: I. File suffix convention
61:
62: I cvs imported all of the Motorola files (with lowercase names).
63:
64: These are:
65:
66: *.s: Assembler files "unsupported by Motorola, provided as a reference only"
67: *.sa: Pseudo assembler hex dump files, which is Motorolas supported version.
68: *.doc: docs by Motorola
69:
70: errata, changes, files, readme: by Motorola.
71:
72:
73: I choose .S as the file suffix which is feeded to our assembler
74: directly or indirectly.
75:
76: We use: To create:
77:
78: isp.sa isp.S
79: fpsp.sa fpsp.S
80:
81: In addition, inetbsd.S and fnetbsd.S are our part specific glue files,
82: netbsd.S is our general glue file, and copyright.S ensures we have a
83: copy of the copyright notice in the kernel if using the 060SP.
84:
85: To enforce the right relative positions of isp/its glue code inetbsd.S
86: includes isp.S at the end, and fnetbsd.S includes fpsp.S.
87:
88: Ia: Don't Change Files
89:
90: - all Motorola doc files, all .sa (hex) files.
91:
92: Ib: Nearly Don't Change Files
93:
94: - for now, the .s files by Motorola. We might use the fpsp.s file
95: later to create an optimized version, once we a) verified its
96: identical to the supported .s and b) write a conversion (to .S format)
97: script.
98:
99: II. Interface to the arch/$machine/$machine files:
100:
101: [to be continued]
102:
CVSweb