Return to ReadMe.NetBSD CVS log

Up to [local] / sys / arch / m68k / 060sp

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: