debugger_sw: Base code

Signed-off-by: Jose Jimenez <ppjm@correo.ugr.es>

debugger_sw: Base code
Signed-off-by: Jose Jimenez <ppjm@correo.ugr.es>
b490c2df · Jose Jimenez · 1f19320a · b490c2df · b490c2df · b490c2df
Commit b490c2df authored Sep 29, 2014 by Jose Jimenez
164 changed files
--- a/debugger_sw/Kconfig
+++ b/debugger_sw/Kconfig
+mainmenu "Debugger Core software configuration"
+
+config FINE_DEL_NODE
+	bool "Build code for Fine Delay Stand-Alone node"
+	default n
+	
+config DEBUGGER
+	bool
+	default !FINE_DEL_NODE
+
+# most options with no prompt here are prompted-for in the "advanced" section
+
+config PRINT_BUFSIZE
+	int
+	default 256
+
+config PRINTF_FULL
+	boolean
+	default y
+
+config RAMINIT
+	int
+	default 0x00000000
+
+config RAMSIZE
+	int
+	default 92160
+
+config STACKSIZE
+	int  
+	default 22528
+	
+config HEAPSIZE
+	int 
+	default 12480
+	
+config ALING
+	int
+	default 4
+
+config MEM_CHECK_CMD
+	boolean"Command for memory checking/debbuging"
+	default y
+
+#
+# This is a set of configuration options that should not be changed by
+# normal users. If the "developer" menu is used, the binary is tainted.
+
+comment "dbg-sw is tainted if you change the following options"
+config DEVELOPER
+	bool "Advanced configurations, only for developers"
+	help
+	  The following options are new features under testing, or
+	  special customizations not normally useful for people not
+	  directly working on this package.  Please don't use unless
+	  you are a developer of wrpc-sw.
+
+config RAMSIZE
+	depends on DEVELOPER
+	int "Size of the RAM in the FPGA for this program"
+	default 90112
+	help
+	  The usual configuration for debugger_sw is 0x16000 bytes
+	  (i.e. 88kB = 90112 bytes) but if your project has less or
+	  more features you may want to adjust the FPGA size and
+	  choose your preferred value here.
+
+config STACKSIZE
+	depends on DEVELOPER
+	int "Size of the stack area needed by this program"
+	default 22528
+	help
+	  The linker complains if the code doesn't fit into RAM, but
+	  we must also consider the stack, or the program will crash
+	  at run time. (However, we have a detector for overflows).
+	  
+config HEAPSIZE
+	depends on DEVELOPER
+	int "Size of the heap area needed by this program"
+	default 12480
+
+config PRINT_BUFSIZE
+	depends on DEVELOPER
+	int "Size for the temporary output string of pp_printf"
+	default 256
+	help
+	  This buffer is constant storage (i.e. wasted space), but it
+	  also constraints the maximum lenght of text that can be written
+	  in a single call to printf.
+
+choice
+	prompt "Implementation of pp_printf"
+	depends on DEVELOPER
+
+config PRINTF_XINT
+	bool "hex-and-int"
+	help
+	  This selects a printf that can only print decimal and hex
+	  numbers, without obeying the format modifiers. %c and %s are
+	  supported too, and %p is equivalent to %x.
+	  See pp_printf/README for details.
+
+config PRINTF_FULL
+	bool "full"
+	help
+	  This selects an implementation that supports all standard
+	  formats with modifiers, like "%08X" and "%.5s". It costs
+	  around 2k of compiled code more than XINT.
+	  See pp_printf/README for details.
+
+config PRINTF_MINI
+	bool "minimal"
+	help
+	  This selects a printf that prints all integers as hex,
+	  without obeying the format modifiers. %c and %s are
+	  supported too. See pp_printf/README for details.
+	  This is not probably what you want for debbuger-sw.
+endchoice
--- a/debugger_sw/Makefile
+++ b/debugger_sw/Makefile
+# Jose Jimenez, 2013,2014 UGR
+
+CROSS_COMPILE ?= lm32-elf-
+export CROSS_COMPILE
+
+CC =		$(CROSS_COMPILE)gcc
+LD =		$(CROSS_COMPILE)ld
+OBJDUMP =	$(CROSS_COMPILE)objdump
+OBJCOPY =	$(CROSS_COMPILE)objcopy
+SIZE =		$(CROSS_COMPILE)size
+
+WRPC_DIR = wrpc-sw
+
+-include $(CURDIR)/.config
+
+AUTOCONF = $(CURDIR)/include/generated/autoconf.h
+
+# we miss CONFIG_ARCH_LM32 as we have no other archs by now
+obj-y = arch/lm32/crt0.o arch/lm32/irq.o 
+LDS-y = arch/lm32/ram.ld arch/lm32/sbrkr.o
+
+obj-$(CONFIG_DEBUGGER) += dbg_main.o
+
+# our linker script is preprocessed, so have a rule here
+%.ld: %.ld.S $(AUTOCONF) .config
+	$(CC) -include $(AUTOCONF) -E -P $*.ld.S -o $@
+
+
+cflags-y =	-ffreestanding -I- -include $(AUTOCONF) -Iinclude/std -Iinclude \
+			-I.
+cflags-y +=	-I$(CURDIR)/$(WRPC_DIR)/pp_printf
+
+CFLAGS_PLATFORM  = -mmultiply-enabled -mbarrel-shift-enabled
+LDFLAGS_PLATFORM = -mmultiply-enabled -mbarrel-shift-enabled \
+	-nostdlib -T $(LDS-y)
+
+include linux/linux.mk
+include fmc-delay/fine-delay.mk
+include shell/shell.mk
+include lib/lib.mk
+include printf.mk
+include dev/dev.mk
+
+obj-y += check-error.o
+
+obj-y += sdb-lib/libsdbfs.a
+cflags-y += -Isdb-lib
+
+CFLAGS = $(CFLAGS_PLATFORM) $(cflags-y) -Wall \
+	-ffunction-sections -fdata-sections -Os \
+	-ggdb
+
+LDFLAGS = $(LDFLAGS_PLATFORM) \
+	-Wl,--gc-sections -Os -lgcc -lc
+
+OBJS = $(obj-y)
+
+#fine delay output included on .mk
+output-$(CONFIG_DEBUGGER) = dbg
+
+OUTPUT = $(output-y)
+
+#REVISION=$(shell git describe --dirty --always)
+
+all: wrpc dbg_core
+
+dbg_core: remote_tools tools $(OUTPUT).ram $(OUTPUT).vhd $(OUTPUT).mif
+
+.PRECIOUS: %.elf %.bin
+.PHONY: all tools remote_tools clean
+
+sdb-lib/libsdbfs.a:
+	$(MAKE) -C sdb-lib
+
+$(OUTPUT).elf: $(LDS-y) $(AUTOCONF) $(OUTPUT).o config.o
+	${CC} -o $@  config.o $(OUTPUT).o $(LDFLAGS)
+	${OBJDUMP} -d $(OUTPUT).elf > $(OUTPUT)_disasm.S
+	$(SIZE) $@
+	
+
+$(OUTPUT).o: $(OBJS)
+	$(LD) --gc-sections -e _start -r $(OBJS) -T bigobj.lds -o $@
+
+config.o: .config
+	sed '1,3d' .config > .config.bin
+	dd bs=1 count=1 if=/dev/zero 2> /dev/null >> .config.bin
+	$(OBJCOPY) -I binary -O elf32-lm32 -B lm32 \
+		--rename-section .data=.data.config  .config.bin $@
+	rm -f .config.bin
+
+%.bin: %.elf
+	${OBJCOPY} -O binary $^ $@
+
+%.ram: tools %.bin
+	./$(WRPC_DIR)/tools/genraminit $*.bin 0 > $@
+
+%.vhd: tools %.bin
+	./$(WRPC_DIR)/tools/genramvhd -s `. ./.config; echo $$CONFIG_RAMSIZE` $*.bin > $@
+
+%.mif: tools %.bin
+	./$(WRPC_DIR)/tools/genrammif $*.bin `. ./.config; echo $$CONFIG_RAMSIZE` > $@
+
+$(AUTOCONF): silentoldconfig
+
+clean:
+	rm -f $(OBJS) *.o *.mif *.vhd *.elf *.bin *.ram *.S $(LDS)
+	$(MAKE) -C sdb-lib clean
+	$(MAKE) -C remote_tools clean
+	$(MAKE) -C $(WRPC_DIR) clean
+
+%.o:		%.c
+	${CC} $(CFLAGS) $(INCLUDE_DIR) $(LIB_DIR) -c $*.c -o $@
+
+tools:
+	$(MAKE) -C $(WRPC_DIR)/tools -f Makefile
+
+remote_tools:
+	$(MAKE) -C $@
+
+install: remote_tools
+	$(MAKE) -C remote_tools $@
+	
+wrpc: gitmodules
+	$(MAKE) -C $(WRPC_DIR) etherbone_defconfig
+	$(MAKE) -C $(WRPC_DIR)
+	@cp $(WRPC_DIR)/wrc.ram ./wrc-ethb.ram
+
+# if needed, check out the submodules (first time only), so users
+# who didn't read carefully the manual won't get confused
+gitmodules:
+	@test -d $(WRPC_DIR)/inlcude || echo "Checking out submodules"
+	@test -d $(WRPC_DIR)/inlcude || cd .. && git submodule update --init
+
+
+# following targets from Makefile.kconfig
+silentoldconfig:
+	@mkdir -p include/config
+	$(MAKE) -f Makefile.kconfig $@
+
+scripts_basic config:
+	$(MAKE) -f Makefile.kconfig $@
+
+%config:
+	$(MAKE) -f Makefile.kconfig $@
+
+defconfig:
+	$(MAKE) -f Makefile.kconfig dbg_defconfig
+
+.config: silentoldconfig
+
+# This forces more compilations than needed, but it's useful
+# (we depend on .config and not on include/generated/autoconf.h
+# because the latter is touched by silentoldconfig at each build)
+$(obj-y): .config $(wildcard include/*.h)
--- a/debugger_sw/Makefile.kconfig
+++ b/debugger_sw/Makefile.kconfig
+
+# Do not:
+# o  use make's built-in rules and variables
+#    (this increases performance and avoids hard-to-debug behaviour);
+# o  print "Entering directory ...";
+MAKEFLAGS += -rR --no-print-directory
+
+# To put more focus on warnings, be less verbose as default
+# Use 'make V=1' to see the full commands
+
+ifdef V
+  ifeq ("$(origin V)", "command line")
+    KBUILD_VERBOSE = $(V)
+  endif
+endif
+ifndef KBUILD_VERBOSE
+  KBUILD_VERBOSE = 0
+endif
+
+# Cancel implicit rules on top Makefile
+$(CURDIR)/Makefile Makefile: ;
+
+# That's our default target when none is given on the command line
+PHONY := _all
+_all:
+
+# SHELL used by kbuild
+CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
+	  else if [ -x /bin/bash ]; then echo /bin/bash; \
+	  else echo sh; fi ; fi)
+
+# Make variables (CC, etc...)
+HOSTCC       = gcc
+HOSTCXX      = g++
+HOSTCFLAGS   = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer
+HOSTCXXFLAGS = -O2
+
+export HOSTCC HOSTCXX HOSTCFLAGS HOSTCXXFLAGS
+
+KBUILD_KCONFIG = $(CURDIR)/Kconfig
+export KBUILD_KCONFIG
+
+srctree		:= $(CURDIR)
+objtree		:= $(CURDIR)
+src		:= $(srctree)
+obj		:= $(objtree)
+
+export srctree objtree
+
+# We need some generic definitions (do not try to remake the file).
+$(srctree)/scripts/Kbuild.include: ;
+include $(srctree)/scripts/Kbuild.include
+
+# Basic helpers built in scripts/
+PHONY += scripts_basic
+scripts_basic:
+	$(Q)$(MAKE) $(build)=scripts/basic
+
+
+config: scripts_basic FORCE
+	$(Q)mkdir -p include/linux include/config
+	$(Q)$(MAKE) $(build)=scripts/kconfig $@
+
+%config: scripts_basic FORCE
+	$(Q)$(MAKE) $(build)=scripts/kconfig $@
+
+clean:
+	@find . $(RCS_FIND_IGNORE) \
+		\( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
+		-o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
+		-o -name 'Module.markers' -o -name '.tmp_*.o.*' \) \
+		-type f -print | xargs rm -f -v
+
+PHONY += FORCE
+FORCE:
+
+# Declare the contents of the .PHONY variable as phony.  We keep that
+# information in a variable so we can use it in if_changed and friends.
+.PHONY: $(PHONY)
--- a/debugger_sw/arch/lm32/.gitignore
+++ b/debugger_sw/arch/lm32/.gitignore
+ram.ld
\ No newline at end of file
--- a/debugger_sw/arch/lm32/crt0.S
+++ b/debugger_sw/arch/lm32/crt0.S
+/****************************************************************************
+**
+**  Name: crt0ram.S
+**
+**  Description:
+**        Implements boot-code that calls LatticeDDInit (that calls main())
+**        Implements exception handlers (actually, redirectors)
+**
+**  $Revision: $
+**
+** Disclaimer:
+**
+**   This source code is intended as a design reference which
+**   illustrates how these types of functions can be implemented.  It
+**   is the user's responsibility to verify their design for
+**   consistency and functionality through the use of formal
+**   verification methods.  Lattice Semiconductor provides no warranty
+**   regarding the use or functionality of this code.
+**
+** --------------------------------------------------------------------
+**
+**                     Lattice Semiconductor Corporation
+**                     5555 NE Moore Court
+**                     Hillsboro, OR 97214
+**                     U.S.A
+**
+**                     TEL: 1-800-Lattice (USA and Canada)
+**                          (503)268-8001 (other locations)
+**
+**                     web:   http://www.latticesemi.com
+**                     email: techsupport@latticesemi.com
+**
+** --------------------------------------------------------------------------
+**
+**  Change History (Latest changes on top)
+**
+**  Ver    Date        Description
+** --------------------------------------------------------------------------
+**  3.8   Apr-15-2011  Added __MICO_USER_<handler>_HANDLER__ preprocessor to 
+**                     allow customers to implement their own handlers for:
+**                     DATA_ABORT, INST_ABORT
+**  
+**  3.1   Jun-18-2008  Added __MICO_NO_INTERRUPTS__ preprocessor
+**                     option to exclude invoking MicoISRHandler
+**                     to reduce code-size in apps that don't use
+**                     interrupts
+**
+**  3.0   Mar-25-2008  Added Header
+**
+**---------------------------------------------------------------------------
+*****************************************************************************/
+
+/*
+ * LatticeMico32 C startup code.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+/* From include/sys/signal.h */  
+#define SIGINT  2   /* interrupt */
+#define SIGTRAP 5   /* trace trap */
+#define SIGFPE  8   /* arithmetic exception */
+#define SIGSEGV 11  /* segmentation violation */
+
+//#define MICO32_FULL_CONTEXT_SAVE_RESTORE
+
+
+/* Exception handlers - Must be 32 bytes long. */
+        .section    .boot, "ax", @progbits
+	
+        .global	_start  
+_start: 
+	   
+        .global _reset_handler
+        .type 	_reset_handler, @function
+_reset_handler:
+    xor r0, r0, r0
+    wcsr    IE, r0
+    wcsr    IM, r0
+    mvhi    r1, hi(_reset_handler)
+    ori     r1, r1, lo(_reset_handler)
+    wcsr    EBA, r1
+    calli   _crt0
+    nop
+        .size	_reset_handler, .-_reset_handler
+	
+.extern _irq_entry
+.org 0xc0
+        .global _interrupt_handler
+        .type 	_interrupt_handler, @function
+_interrupt_handler:
+    sw      (sp+0), ra
+    calli   _save_all
+    mvi     r1, SIGINT
+#ifndef __MICO_NO_INTERRUPTS__
+    calli  _irq_entry
+#else
+    wcsr    IE, r0
+#endif
+    bi      _restore_all_and_return
+    nop
+    nop
+    nop
+
+.org 0x100
+        .global _crt0
+        .type 	_crt0, @function
+_crt0:
+    /* Clear r0 */
+    xor     r0, r0, r0
+    /* Setup stack and global pointer */
+    mvhi    sp, hi(_fstack)
+    ori     sp, sp, lo(_fstack)
+    mvhi    gp, hi(_gp)
+    ori     gp, gp, lo(_gp)
+	
+    mvhi    r1, hi(_fbss)
+    ori     r1, r1, lo(_fbss)
+    mvi     r2, 0
+    mvhi    r3, hi(_ebss)
+    ori     r3, r3, lo(_ebss)
+    sub     r3, r3, r1
+    calli   memset
+    mvi     r1, 0
+    mvi     r2, 0
+    mvi     r3, 0
+    calli   main
+
+loopf:
+	bi loopf
+
+        .global _save_all
+        .type 	_save_all, @function
+_save_all:
+#ifdef MICO32_FULL_CONTEXT_SAVE_RESTORE
+    addi    sp, sp, -128
+#else
+    addi    sp, sp, -60
+#endif
+    sw      (sp+4), r1
+    sw      (sp+8), r2
+    sw      (sp+12), r3
+    sw      (sp+16), r4
+    sw      (sp+20), r5
+    sw      (sp+24), r6
+    sw      (sp+28), r7
+    sw      (sp+32), r8
+    sw      (sp+36), r9
+    sw      (sp+40), r10
+#ifdef MICO32_FULL_CONTEXT_SAVE_RESTORE
+    sw      (sp+44), r11
+    sw      (sp+48), r12
+    sw      (sp+52), r13
+    sw      (sp+56), r14
+    sw      (sp+60), r15
+    sw      (sp+64), r16
+    sw      (sp+68), r17
+    sw      (sp+72), r18
+    sw      (sp+76), r19
+    sw      (sp+80), r20
+    sw      (sp+84), r21
+    sw      (sp+88), r22
+    sw      (sp+92), r23
+    sw      (sp+96), r24
+    sw      (sp+100), r25
+    sw      (sp+104), r26
+    sw      (sp+108), r27
+    sw      (sp+120), ea
+    sw      (sp+124), ba
+    /* ra and sp need special handling, as they have been modified */
+    lw      r1, (sp+128)
+    sw      (sp+116), r1
+    mv      r1, sp
+    addi    r1, r1, 128
+    sw      (sp+112), r1
+#else
+    sw      (sp+52), ea
+    sw      (sp+56), ba
+    /* ra and sp need special handling, as they have been modified */
+    lw      r1, (sp+60)
+    sw      (sp+48), r1
+    mv      r1, sp
+    addi    r1, r1, 60
+    sw      (sp+44), r1
+#endif
+//    xor     r1, r1, r1
+//    wcsr    ie, r1
+    ret
+        .size  	_save_all, .-_save_all
+	
+        .global _restore_all_and_return
+        .type 	_restore_all_and_return, @function
+    /* Restore all registers and return from exception */
+_restore_all_and_return:
+//    addi    r1, r0, 2
+//    wcsr    ie, r1
+    lw      r1, (sp+4)
+    lw      r2, (sp+8) 
+    lw      r3, (sp+12) 
+    lw      r4, (sp+16) 
+    lw      r5, (sp+20) 
+    lw      r6, (sp+24) 
+    lw      r7, (sp+28) 
+    lw      r8, (sp+32) 
+    lw      r9, (sp+36) 
+    lw      r10, (sp+40)
+#ifdef MICO32_FULL_CONTEXT_SAVE_RESTORE
+    lw      r11, (sp+44)
+    lw      r12, (sp+48)
+    lw      r13, (sp+52)
+    lw      r14, (sp+56)
+    lw      r15, (sp+60)
+    lw      r16, (sp+64)
+    lw      r17, (sp+68)
+    lw      r18, (sp+72)
+    lw      r19, (sp+76)
+    lw      r20, (sp+80)
+    lw      r21, (sp+84)
+    lw      r22, (sp+88)
+    lw      r23, (sp+92)
+    lw      r24, (sp+96)
+    lw      r25, (sp+100)
+    lw      r26, (sp+104)
+    lw      r27, (sp+108)
+    lw      ra, (sp+116)
+    lw      ea, (sp+120)
+    lw      ba, (sp+124)
+    /* Stack pointer must be restored last, in case it has been updated */
+    lw      sp, (sp+112)
+#else
+    lw      ra, (sp+48)
+    lw      ea, (sp+52)
+    lw      ba, (sp+56)
+    /* Stack pointer must be restored last, in case it has been updated */
+    lw      sp, (sp+44)
+#endif
+    nop
+    eret
+        .size   _restore_all_and_return, .-_restore_all_and_return
+
--- a/debugger_sw/arch/lm32/irq.c
+++ b/debugger_sw/arch/lm32/irq.c
+/*
+ * This work is part of the White Rabbit project
+ *
+ * Copyright (C) 2011 CERN (www.cern.ch)
+ * Author: Tomasz Wlostowski <tomasz.wlostowski@cern.ch>
+ *
+ * Released according to the GNU GPL, version 2 or any later version.
+ */
+#include "irq.h"
+
+void disable_irq()
+{
+	unsigned int ie, im;
+	unsigned int Mask = ~1;
+
+	/* disable peripheral interrupts in case they were enabled */
+	asm volatile ("rcsr %0,ie":"=r" (ie));
+	ie &= (~0x1);
+	asm volatile ("wcsr ie, %0"::"r" (ie));
+
+	/* disable mask-bit in im */
+	asm volatile ("rcsr %0, im":"=r" (im));
+	im &= Mask;
+	asm volatile ("wcsr im, %0"::"r" (im));
+
+}
+
+void enable_irq()
+{
+	unsigned int ie, im;
+	unsigned int Mask = 1;
+
+	/* disable peripheral interrupts in-case they were enabled */
+	asm volatile ("rcsr %0,ie":"=r" (ie));
+	ie &= (~0x1);
+	asm volatile ("wcsr ie, %0"::"r" (ie));
+
+	/* enable mask-bit in im */
+	asm volatile ("rcsr %0, im":"=r" (im));
+	im |= Mask;
+	asm volatile ("wcsr im, %0"::"r" (im));
+
+	ie |= 0x1;
+	asm volatile ("wcsr ie, %0"::"r" (ie));
+}
--- a/debugger_sw/arch/lm32/ram.ld.S
+++ b/debugger_sw/arch/lm32/ram.ld.S
+/*
+ * Link script for Lattice Mico32. Very loosely based on
+ * code contributed by Jon Beniston <jon@beniston.com>
+ *
+ * Jon's license (BSD-style):
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */