puppet 2.7.26 → 3.0.0.rc4

data/lib/puppet/util/settings/setting.rb

@@ -1,94 +0,0 @@
-# The base element type.
-class Puppet::Util::Settings::Setting
-  attr_accessor :name, :section, :default, :setbycli, :call_on_define
-  attr_reader :desc, :short
-
-  def desc=(value)
-    @desc = value.gsub(/^\s*/, '')
-  end
-
-  # get the arguments in getopt format
-  def getopt_args
-    if short
-      [["--#{name}", "-#{short}", GetoptLong::REQUIRED_ARGUMENT]]
-    else
-      [["--#{name}", GetoptLong::REQUIRED_ARGUMENT]]
-    end
-  end
-
-  # get the arguments in OptionParser format
-  def optparse_args
-    if short
-      ["--#{name}", "-#{short}", desc, :REQUIRED]
-    else
-      ["--#{name}", desc, :REQUIRED]
-    end
-  end
-
-  def hook=(block)
-    meta_def :handle, &block
-  end
-
-  # Create the new element.  Pretty much just sets the name.
-  def initialize(args = {})
-    unless @settings = args.delete(:settings)
-      raise ArgumentError.new("You must refer to a settings object")
-    end
-
-    args.each do |param, value|
-      method = param.to_s + "="
-      raise ArgumentError, "#{self.class} does not accept #{param}" unless self.respond_to? method
-
-      self.send(method, value)
-    end
-
-    raise ArgumentError, "You must provide a description for the #{self.name} config option" unless self.desc
-  end
-
-  def iscreated
-    @iscreated = true
-  end
-
-  def iscreated?
-    @iscreated
-  end
-
-  def set?
-    !!(!@value.nil?)
-  end
-
-  # short name for the celement
-  def short=(value)
-    raise ArgumentError, "Short names can only be one character." if value.to_s.length != 1
-    @short = value.to_s
-  end
-
-  # Convert the object to a config statement.
-  def to_config
-    str = @desc.gsub(/^/, "# ") + "\n"
-
-    # Add in a statement about the default.
-    str += "# The default value is '#{@default}'.\n" if @default
-
-    # If the value has not been overridden, then print it out commented
-    # and unconverted, so it's clear that that's the default and how it
-    # works.
-    value = @settings.value(self.name)
-
-    if value != @default
-      line = "#{@name} = #{value}"
-    else
-      line = "# #{@name} = #{@default}"
-    end
-
-    str += line + "\n"
-
-    str.gsub(/^/, "    ")
-  end
-
-  # Retrieves the value, or if it's not set, retrieves the default.
-  def value
-    @settings.value(self.name)
-  end
-end
-

data/lib/puppet/util/windows/sid.rb

@@ -1,96 +0,0 @@
-require 'puppet/util/windows'
-
-module Puppet::Util::Windows
-  module SID
-    require 'windows/security'
-    include ::Windows::Security
-
-    require 'windows/memory'
-    include ::Windows::Memory
-
-    require 'windows/msvcrt/string'
-    include ::Windows::MSVCRT::String
-
-    # missing from Windows::Error
-    ERROR_NONE_MAPPED           = 1332
-    ERROR_INVALID_SID_STRUCTURE = 1337
-
-    # Convert an account name, e.g. 'Administrators' into a SID string,
-    # e.g. 'S-1-5-32-544'. The name can be specified as 'Administrators',
-    # 'BUILTIN\Administrators', or 'S-1-5-32-544', and will return the
-    # SID. Returns nil if the account doesn't exist.
-    def name_to_sid(name)
-      # Apparently, we accept a symbol..
-      name = name.to_s if name
-
-      # if it's in SID string form, return it, otherwise, lookup sid
-      is_sid = Win32::Security::SID.string_to_sid(name) rescue nil
-
-      is_sid ? name : Win32::Security::SID.new(name).to_s
-    rescue
-      nil
-    end
-
-    # Convert a SID string, e.g. "S-1-5-32-544" to a name,
-    # e.g. 'BUILTIN\Administrators'. Returns nil if an account
-    # for that SID does not exist.
-    def sid_to_name(value)
-      sid = Win32::Security::SID.new(Win32::Security::SID.string_to_sid(value))
-
-      if sid.domain and sid.domain.length > 0
-        "#{sid.domain}\\#{sid.account}"
-      else
-        sid.account
-      end
-    rescue
-      nil
-    end
-
-    # Convert a SID pointer to a SID string, e.g. "S-1-5-32-544".
-    def sid_ptr_to_string(psid)
-      sid_buf = 0.chr * 256
-      str_ptr = 0.chr * 4
-
-      raise Puppet::Util::Windows::Error.new("Invalid SID") unless IsValidSid(psid)
-
-      raise Puppet::Util::Windows::Error.new("Failed to convert binary SID") unless ConvertSidToStringSid(psid, str_ptr)
-
-      begin
-        strncpy(sid_buf, str_ptr.unpack('L')[0], sid_buf.size - 1)
-        sid_buf[sid_buf.size - 1] = 0.chr
-        return sid_buf.strip
-      ensure
-        LocalFree(str_ptr.unpack('L')[0])
-      end
-    end
-
-    # Convert a SID string, e.g. "S-1-5-32-544" to a pointer (containing the
-    # address of the binary SID structure). The returned value can be used in
-    # Win32 APIs that expect a PSID, e.g. IsValidSid. The account for this
-    # SID may or may not exist.
-    def string_to_sid_ptr(string, &block)
-      sid_buf = 0.chr * 80
-      string_addr = [string].pack('p*').unpack('L')[0]
-
-      raise Puppet::Util::Windows::Error.new("Failed to convert string SID: #{string}") unless ConvertStringSidToSid(string_addr, sid_buf)
-
-      sid_ptr = sid_buf.unpack('L')[0]
-      begin
-        yield sid_ptr
-      ensure
-        LocalFree(sid_ptr)
-      end
-    end
-
-    # Return true if the string is a valid SID, e.g. "S-1-5-32-544", false otherwise.
-    def valid_sid?(string)
-      string_to_sid_ptr(string) { |ptr| true }
-    rescue Puppet::Util::Windows::Error => e
-      if e.code == ERROR_INVALID_SID_STRUCTURE
-        false
-      else
-        raise
-      end
-    end
-  end
-end

data/lib/puppet/vendor.rb

@@ -1,55 +0,0 @@
-module Puppet
-  # Simple module to manage vendored code.
-  #
-  # To vendor a library:
-  #
-  # * Download its whole git repo or untar into `lib/puppet/vendor/<libname>`
-  # * Create a lib/puppetload_libraryname.rb file to add its libdir into the $:.
-  #   (Look at existing load_xxx files, they should all follow the same pattern).
-  # * To load the vendored lib upfront, add a `require '<vendorlib>'`line to
-  #   `vendor/require_vendored.rb`.
-  # * To load the vendored lib on demand, add a comment to `vendor/require_vendored.rb`
-  #    to make it clear it should not be loaded upfront.
-  #
-  # At runtime, the #load_vendored method should be called. It will ensure
-  # all vendored libraries are added to the global `$:` path, and
-  # will then call execute the up-front loading specified in `vendor/require_vendored.rb`.
-  #
-  # The intention is to not change vendored libraries and to eventually
-  # make adding them in optional so that distros can simply adjust their
-  # packaging to exclude this directory and the various load_xxx.rb scripts
-  # if they wish to install these gems as native packages.
-  #
-  class Vendor
-    class << self
-      # @api private
-      def vendor_dir
-        File.join([File.dirname(File.expand_path(__FILE__)), "vendor"])
-      end
-
-      # @api private
-      def load_entry(entry)
-        Puppet.debug("Loading vendored #{$1}")
-        load "#{vendor_dir}/#{entry}"
-      end
-
-      # @api private
-      def require_libs
-        require 'puppet/vendor/require_vendored'
-      end
-
-      # Configures the path for all vendored libraries and loads required libraries.
-      # (This is the entry point for loading vendored libraries).
-      #
-      def load_vendored
-        Dir.entries(vendor_dir).each do |entry|
-          if entry.match(/load_(\w+?)\.rb$/)
-            load_entry entry
-          end
-        end
-
-        require_libs
-      end
-    end
-  end
-end

data/lib/puppet/vendor/load_safe_yaml.rb

@@ -1 +0,0 @@
-$: << File.join([File.dirname(__FILE__), "safe_yaml/lib"])

data/lib/puppet/vendor/require_vendored.rb

@@ -1,4 +0,0 @@
-# This adds upfront requirements on vendored code found under lib/vendor/x
-# Add one requirement per vendored package (or a comment if it is loaded on demand).
-
-require 'safe_yaml'

data/lib/puppet/vendor/safe_yaml/CHANGES.md

@@ -1,104 +0,0 @@
-0.9.2
------
-
-- fixed error w/ parsing "!" when whitelisting tags
-- fixed parsing of the number 0 (d'oh!)
-
-0.9.1
------
-
-- added Yecht support (JRuby)
-- more bug fixes
-
-0.9.0
------
-
-- added `whitelist!` method for easily whitelisting tags
-- added support for call-specific options
-- removed deprecated methods
-
-0.8.6
------
-
-- fixed bug in float matcher
-
-0.8.5
------
-
-- performance improvements
-- made less verbose by default
-- bug fixes
-
-0.8.4
------
-
-- enhancements to parsing of integers, floats, and dates
-- updated built-in whitelist
-- more bug fixes
-
-0.8.3
------
-
-- fixed exception on parsing empty document
-- fixed handling of octal & hexadecimal numbers
-
-0.8.2
------
-
-- bug fixes
-
-0.8.1
------
-
-- added `:raise_on_unknown_tag` option
-- renamed `reset_defaults!` to `restore_defaults!`
-
-0.8
----
-
-- added tag whitelisting
-- more API changes
-
-0.7
----
-
-- separated YAML engine support from Ruby version
-- added support for binary scalars
-- numerous bug fixes and enhancements
-
-0.6
----
-
-- several API changes
-- added `SafeYAML::OPTIONS` for specifying default behavior
-
-0.5
----
-
-Added support for dates
-
-0.4
----
-
-- efficiency improvements
-- made `YAML.load` use `YAML.safe_load` by default
-- made symbol deserialization optional
-
-0.3
----
-
-Added Syck support
-
-0.2
----
-
-Added support for:
-
-- anchors & aliases
-- booleans
-- nils
-
-0.1
----
-
-Initial release

data/lib/puppet/vendor/safe_yaml/Gemfile

@@ -1,11 +0,0 @@
-source "https://rubygems.org"
-
-gemspec
-
-group :development do
-  gem "hashie"
-  gem "heredoc_unindent"
-  gem "rake"
-  gem "rspec"
-  gem "travis-lint"
-end

data/lib/puppet/vendor/safe_yaml/LICENSE.txt

@@ -1,22 +0,0 @@
-Copyright (c) 2013 Dan Tao
-
-MIT License
-
-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.

data/lib/puppet/vendor/safe_yaml/README.md

@@ -1,179 +0,0 @@
-SafeYAML
-========
-
-[![Build Status](https://travis-ci.org/dtao/safe_yaml.png)](http://travis-ci.org/dtao/safe_yaml)
-
-The **SafeYAML** gem provides an alternative implementation of `YAML.load` suitable for accepting user input in Ruby applications. Unlike Ruby's built-in implementation of `YAML.load`, SafeYAML's version will not expose apps to arbitrary code execution exploits (such as [the ones discovered](http://www.reddit.com/r/netsec/comments/167c11/serious_vulnerability_in_ruby_on_rails_allowing/) [in Rails in early 2013](http://www.h-online.com/open/news/item/Rails-developers-close-another-extremely-critical-flaw-1793511.html)).
-
-**If you encounter any issues with SafeYAML, check out the 'Common Issues' section below.** If you don't see anything that addresses the problem you're experiencing, by all means, [create an issue](https://github.com/dtao/safe_yaml/issues/new)!
-
-Installation
-------------
-
-Add this line to your application's Gemfile:
-
-    gem "safe_yaml"
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install safe_yaml
-
-Configuration
--------------
-
-Configuring SafeYAML should be quick. In most cases, you will probably only have to think about two things:
-
-1. What do you want the `YAML` module's *default* behavior to be? Set the `SafeYAML::OPTIONS[:default_mode]` option to either `:safe` or `:unsafe` to control this. If you do neither, SafeYAML will default to `:safe` mode but will issue a warning the first time you call `YAML.load`.
-2. Do you want to allow symbols by default? Set the `SafeYAML::OPTIONS[:deserialize_symbols]` option to `true` or `false` to control this. The default is `false`, which means that SafeYAML will deserialize symbols in YAML documents as strings.
-
-For more information on these and other options, see the "Usage" section down below.
-
-Explanation
------------
-
-Suppose your application were to use a popular open source library which contained code like this:
-
-```ruby
-class ClassBuilder
-  def []=(key, value)
-    @class ||= Class.new
-
-    @class.class_eval <<-EOS
-      def #{key}
-        #{value}
-      end
-    EOS
-  end
-
-  def create
-    @class.new
-  end
-end
-```
-
-Now, if you were to use `YAML.load` on user input anywhere in your application without the SafeYAML gem installed, an attacker who suspected you were using this library could send a request with a carefully-crafted YAML string to execute arbitrary code (yes, including `system("unix command")`) on your servers.
-
-This simple example demonstrates the vulnerability:
-
-```ruby
-yaml = <<-EOYAML
---- !ruby/hash:ClassBuilder
-"foo; end; puts %(I'm in yr system!); def bar": "baz"
-EOYAML
-```
-
-    > YAML.load(yaml)
-    I'm in yr system!
-    => #<ClassBuilder:0x007fdbbe2e25d8 @class=#<Class:0x007fdbbe2e2510>>
-
-With SafeYAML, the same attacker would be thwarted:
-
-    > require "safe_yaml"
-    => true
-    > YAML.load(yaml, :safe => true)
-    => {"foo; end; puts %(I'm in yr system!); def bar"=>"baz"}
-
-Usage
------
-
-When you require the safe_yaml gem in your project, `YAML.load` is patched to accept one additional (optional) `options` parameter. This changes the method signature as follows:
-
-- for Syck and Psych prior to Ruby 1.9.3: `YAML.load(yaml, options={})`
-- for Psych in 1.9.3 and later: `YAML.load(yaml, filename=nil, options={})`
-
-The most important option is the `:safe` option (default: `true`), which controls whether or not to deserialize arbitrary objects when parsing a YAML document. The other options, along with explanations, are as follows.
-
-- `:deserialize_symbols` (default: `false`): Controls whether or not YAML will deserialize symbols. It is probably best to only enable this option where necessary, e.g. to make trusted libraries work. Symbols receive special treatment in Ruby and are not garbage collected, which means deserializing them indiscriminately may render your site vulnerable to a DOS attack (hence `false` as a default value).
-
-- `:whitelisted_tags`: Accepts an array of YAML tags that designate trusted types, e.g., ones that can be deserialized without worrying about any resulting security vulnerabilities. When any of the given tags are encountered in a YAML document, the associated data will be parsed by the underlying YAML engine (Syck or Psych) for the version of Ruby you are using. See the "Whitelisting Trusted Types" section below for more information.
-
-- `:custom_initializers`: Similar to the `:whitelisted_tags` option, but allows you to provide your own initializers for specified tags rather than using Syck or Psyck. Accepts a hash with string tags for keys and lambdas for values.
-
-- `:raise_on_unknown_tag` (default: `false`): Represents the highest possible level of paranoia (not necessarily a bad thing); if the YAML engine encounters any tag other than ones that are automatically trusted by SafeYAML or that you've explicitly whitelisted, it will raise an exception. This may be a good choice if you expect to always be dealing with perfectly safe YAML and want your application to fail loudly upon encountering questionable data.
-
-All of the above options can be set at the global level via `SafeYAML::OPTIONS`. You can also set each one individually per call to `YAML.load`; an option explicitly passed to `load` will take precedence over an option specified globally.
-
-Supported Types
----------------
-
-The way that SafeYAML works is by restricting the kinds of objects that can be deserialized via `YAML.load`. More specifically, only the following types of objects can be deserialized by default:
-
-- Hashes
-- Arrays
-- Strings
-- Numbers
-- Dates
-- Times
-- Booleans
-- Nils
-
-Again, deserialization of symbols can be enabled globally by setting `SafeYAML::OPTIONS[:deserialize_symbols] = true`, or in a specific call to `YAML.load([some yaml], :deserialize_symbols => true)`.
-
-Whitelisting Trusted Types
---------------------------
-
-SafeYAML supports whitelisting certain YAML tags for trusted types. This is handy when your application uses YAML to serialize and deserialize certain types not listed above, which you know to be free of any deserialization-related vulnerabilities.
-
-The easiest way to whitelist types is by calling `SafeYAML.whitelist!`, which can accept a variable number of safe types, e.g.:
-
-```ruby
-SafeYAML.whitelist!(FrobDispenser, GobbleFactory)
-```
-
-You can also whitelist YAML *tags* via the `:whitelisted_tags` option:
-
-```ruby
-# Using Syck
-SafeYAML::OPTIONS[:whitelisted_tags] = ["tag:ruby.yaml.org,2002:object:OpenStruct"]
-
-# Using Psych
-SafeYAML::OPTIONS[:whitelisted_tags] = ["!ruby/object:OpenStruct"]
-```
-
-And in case you were wondering: no, this feature will *not* allow would-be attackers to embed untrusted types within trusted types:
-
-```ruby
-yaml = <<-EOYAML
---- !ruby/object:OpenStruct 
-table: 
-  :backdoor: !ruby/hash:ClassBuilder 
-    "foo; end; puts %(I'm in yr system!); def bar": "baz"
-EOYAML
-```
-
-    > YAML.safe_load(yaml)
-    => #<OpenStruct :backdoor={"foo; end; puts %(I'm in yr system!); def bar"=>"baz"}>
-
-Known Issues
-------------
-
-If you add SafeYAML to your project and start seeing any errors about missing keys, or you notice mysterious strings that look like `":foo"` (i.e., start with a colon), it's likely you're seeing errors from symbols being saved in YAML format. If you are able to modify the offending code, you might want to consider changing your YAML content to use plain vanilla strings instead of symbols. If not, you may need to set the `:deserialize_symbols` option to `true`, either in calls to `YAML.load` or--as a last resort--globally, with `SafeYAML::OPTIONS[:deserialize_symbols]`.
-
-Also be aware that some Ruby libraries, particularly those requiring inter-process communication, leverage YAML's object deserialization functionality and therefore may break or otherwise be impacted by SafeYAML. The following list includes known instances of SafeYAML's interaction with other Ruby gems:
-
-- [**ActiveRecord**](https://github.com/rails/rails/tree/master/activerecord): uses YAML to control serialization of model objects using the `serialize` class method. If you find that accessing serialized properties on your ActiveRecord models is causing errors, chances are you may need to:
-  1. set the `:deserialize_symbols` option to `true`,
-  2. whitelist some of the types in your serialized data via `SafeYAML.whitelist!` or the `:whitelisted_tags` option, or
-  3. both
-- [**Guard**](https://github.com/guard/guard): Uses YAML as a serialization format for notifications. The data serialized uses symbolic keys, so setting `SafeYAML::OPTIONS[:deserialize_symbols] = true` is necessary to allow Guard to work.
-- [**sidekiq**](https://github.com/mperham/sidekiq): Uses a YAML configiuration file with symbolic keys, so setting `SafeYAML::OPTIONS[:deserialize_symbols] = true` should allow it to work.
-
-The above list will grow over time, as more issues are discovered.
-
-Caveat
-------
-
-My intention is to eventually adopt [semantic versioning](http://semver.org/) with this gem, if it ever gets to version 1.0 (i.e., doesn't become obsolete by then). Since it isn't there yet, that means that API may well change from one version to the next. Please keep that in mind if you are using it in your application.
-
-To be clear: my *goal* is for SafeYAML to make it as easy as possible to protect existing applications from object deserialization exploits. Any and all feedback is more than welcome!
-
-Requirements
-------------
-
-SafeYAML requires Ruby 1.8.7 or newer and works with both [Syck](http://www.ruby-doc.org/stdlib-1.8.7/libdoc/yaml/rdoc/YAML.html) and [Psych](http://github.com/tenderlove/psych).
-
-If you are using a version of Ruby where Psych is the default YAML engine (e.g., 1.9.3) but you want to use Syck, be sure to set `YAML::ENGINE.yamler = "syck"` **before** requiring the safe_yaml gem.