wf_node_api 0.6.0 → 0.7.0

data/lib/wf_node_api/container_manager.rb

@@ -1,26 +1,30 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
-
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 # Manager for containers, meta class
@@ -178,6 +182,13 @@ class ContainerManager
     @adapter.container(name)
   end
 
+  # Returns a list of supported templates
+  #
+  # @return [Hash] List of supported templates
+  def supported_templates
+    @adapter.supported_templates
+  end
+
   # Returns the amount of free cpu cores
   #
   # @param resman [ResourceManager] A ResourceManager instance
@@ -258,13 +269,14 @@ class ContainerManager
   # @param disk_size_gb     [Integer]   The disk size in GB
   # @param memory_limit_mb  [Integer]   The memory limit in MB
   # @param cpu_core_count   [Integer]   Amount of Vcores to assign
+  # @param template         [String]    Name of the template to use
   #
   # @raise [RuntimeError]
   # @raise [NotFoundError]
   # @raise [ArgumentError]
   #
   # @return [String] CLI output
-  def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count)
+  def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count, template)
     disk_size_gb = disk_size_gb.to_i
     memory_limit_mb = memory_limit_mb.to_i
     cpu_core_count = cpu_core_count.to_i
@@ -281,6 +293,6 @@ class ContainerManager
       raise ::NotFoundError
     end
 
-    @adapter.create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count)
+    @adapter.create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count, template)
   end
 end

data/lib/wf_node_api/container_manager_adapter/lxc.rb

@@ -1,26 +1,30 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
-
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 module ContainerManagerAdapter
@@ -144,11 +148,12 @@ module ContainerManagerAdapter
     # @param disk_size_gb     [Integer]   The disk size in GB
     # @param memory_limit_mb  [Integer]   The memory limit in MB
     # @param cpu_core_count   [Integer]   Amount of Vcores to assign. 0 if no limit should be set
+    # @param template         [String]    Name of the template to use
     #
     # @raise [RuntimeError]
     #
     # @return [String] CLI output
-    def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count)
+    def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count, template)
       output = ''
 
       begin
@@ -156,7 +161,11 @@ module ContainerManagerAdapter
           cpuset = self.generate_cpu_set(cpu_core_count, ResourceManager.new('linux'))
         end
 
-        create_result = Open3.capture3($lxc_cmd_create.gsub('[name]', name))
+        if false == $lxc_cmd_create.has_key?(template)
+          raise ArgumentError, "template does not exist"
+        end
+
+        create_result = Open3.capture3($lxc_cmd_create[template].gsub('[name]', name))
 
         output += create_result[0]
         output += create_result[1]
@@ -168,11 +177,13 @@ module ContainerManagerAdapter
           f << "lxc.start.auto=1\n"
           f << "lxc.start.delay=5\n"
 
-          if cpu_core_count != 0
+          if cpu_core_count.to_i != 0
             f << "lxc.cgroup.cpuset.cpus=#{cpuset}\n"
           end
 
-          f << "lxc.cgroup.memory.limit_in_bytes=#{memory_limit_mb.to_s}M\n"
+          if memory_limit_mb.to_i != 0
+            f << "lxc.cgroup.memory.limit_in_bytes=#{memory_limit_mb.to_s}M\n"
+          end
         end
 
         $logger.info("creation of container " + name + " successful")
@@ -206,6 +217,13 @@ module ContainerManagerAdapter
       self.free_cpu_cores(resman).count
     end
 
+    # Returns a list of supported templates
+    #
+    # @return [Hash] List of supported templates
+    def supported_templates
+      $lxc_cmd_create.keys
+    end
+
     protected
       # Reads the config file of a LXC container
       #
@@ -428,4 +446,4 @@ module ContainerManagerAdapter
         cores_to_use.join(',')
       end
   end
-end
+end

data/lib/wf_node_api/container_manager_adapter/vserver.rb

@@ -1,26 +1,30 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
-
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 module ContainerManagerAdapter
@@ -142,11 +146,12 @@ module ContainerManagerAdapter
     # @param disk_size_gb     [Integer]   The disk size in GB
     # @param memory_limit_mb  [Integer]   The memory limit in MB
     # @param cpu_core_count   [Integer]   Amount of Vcores to assign. 0 for no limit
+    # @param template         [String]    Name of the template to use
     #
     # @raise [RuntimeError]
     #
     # @return [String] CLI output
-    def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count)
+    def create_container(name, ip_address, disk_size_gb, memory_limit_mb, cpu_core_count, template)
       output = ''
 
       begin
@@ -154,8 +159,12 @@ module ContainerManagerAdapter
           cpuset = generate_cpu_set(cpu_core_count, ResourceManager.new('linux'))
         end
 
+        if false == $vserver_cmd_create.has_key?(template)
+          raise ArgumentError, "template does not exist"
+        end
+
         new_context = highest_context() + 1
-        cmd = $vserver_cmd_create.gsub('[name]', name).gsub('[ip_address]', ip_address).gsub('[context]', new_context.to_s)
+        cmd = $vserver_cmd_create[template].gsub('[name]', name).gsub('[ip_address]', ip_address).gsub('[context]', new_context.to_s)
 
         create_result = Open3.capture3(cmd)
 
@@ -167,11 +176,13 @@ module ContainerManagerAdapter
         end
 
         # memory limit
-        memory_limit_bytes = memory_limit_mb.to_i * 1024 * 1024
-        page_size = `#{$page_size_cmd}`.to_i
-        memory_limit_pages = memory_limit_bytes / page_size
+        if memory_limit_mb.to_i != 0
+            memory_limit_bytes = memory_limit_mb.to_i * 1024 * 1024
+            page_size = `#{$page_size_cmd}`.to_i
+            memory_limit_pages = memory_limit_bytes / page_size
 
-        write_config_file(name, '/rlimits/rss.hard', memory_limit_pages.to_s)
+            write_config_file(name, '/rlimits/rss.hard', memory_limit_pages.to_s)
+        end
 
         if cpu_core_count != 0
           # cpu core limit
@@ -209,6 +220,13 @@ module ContainerManagerAdapter
       self.free_cpu_cores(resman).count
     end
 
+    # Returns a list of supported templates
+    #
+    # @return [Hash] List of supported templates
+    def supported_templates
+      $vserver_cmd_create.keys
+    end
+
     protected
       # Writes the config file of a vserver
       #
@@ -445,4 +463,4 @@ module ContainerManagerAdapter
         `#{$vserver_cmd_ls}`.lines.map(&:strip).uniq
       end
   end
-end
+end

data/lib/wf_node_api/error/not_found.rb

@@ -1,27 +1,31 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
 
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 class NotFoundError < StandardError
-end
+end

data/lib/wf_node_api/os.rb

@@ -1,26 +1,30 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
 
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 module OS
@@ -29,4 +33,4 @@ module OS
   def self.linux?
     RUBY_PLATFORM.include?('linux')
   end
-end
+end

data/lib/wf_node_api/resource_manager.rb

@@ -1,26 +1,30 @@
 =begin
-__        ___     _ _       _____                ____ __  __
-\ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
- \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
-  \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
-   \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
+ __        ___     _ _       _____                ____ __  __
+ \ \      / / |__ (_) |_ ___|  ___|   _ ___  ___ / ___|  \/  |
+  \ \ /\ / /| '_ \| | __/ _ \ |_ | | | / __|/ _ \ |   | |\/| |
+   \ V  V / | | | | | ||  __/  _|| |_| \__ \  __/ |___| |  | |
+    \_/\_/  |_| |_|_|\__\___|_|   \__,_|___/\___|\____|_|  |_|
                                             Container Manager
 
-Copyright (C) 2015 David Prandzioch <kontakt@davidprandzioch.de>
-
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Copyright (c) 2015 David Prandzioch <kontakt@davidprandzioch.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 =end
 
 # Top level class for resource management