Sha256: a6b74faa52dfc3247de2c6c29aa69a22a07bda7e50c6b10a20258a41aad94e51

Contents?: true

Size: 1.71 KB

Versions: 180

Compression:

Stored size: 1.71 KB

Contents

require 'puppet/x509'

# Methods for managing PEM encoded files. While PEM encoded strings are
# always ASCII, the files may contain user specified comments, so they are
# UTF-8 encoded.
#
# @api private
module Puppet::X509::PemStore
  # Load a pem encoded object.
  #
  # @param path [String] file path
  # @return [String, nil] The PEM encoded object or nil if the
  #  path does not exist
  # @raise [Errno::EACCES] if permission is denied
  # @api private
  def load_pem(path)
    Puppet::FileSystem.read(path, encoding: 'UTF-8')
  rescue Errno::ENOENT
    nil
  end

  # Save pem encoded content to a file. If the file doesn't exist, it
  # will be created. Otherwise, the file will be overwritten. In both
  # cases the contents will be overwritten atomically so other
  # processes don't see a partially written file.
  #
  # @param pem [String] The PEM encoded object to write
  # @param path [String] The file path to write to
  # @raise [Errno::EACCES] if permission is denied
  # @raise [Errno::EPERM] if the operation cannot be completed
  # @api private
  def save_pem(pem, path, owner: nil, group: nil, mode: 0644)
    Puppet::FileSystem.replace_file(path, mode) do |f|
      f.set_encoding('UTF-8')
      f.write(pem.encode('UTF-8'))
    end

    if !Puppet::Util::Platform.windows? && Puppet.features.root? && (owner || group)
      FileUtils.chown(owner, group, path)
    end
  end

  # Delete a pem encoded object, if it exists.
  #
  # @param path [String] The file path to delete
  # @return [Boolean] Returns true if the file was deleted, false otherwise
  # @raise [Errno::EACCES] if permission is denied
  # @api private
  def delete_pem(path)
    Puppet::FileSystem.unlink(path)
    true
  rescue Errno::ENOENT
    false
  end
end

Version data entries

180 entries across 180 versions & 1 rubygems

Version Path
puppet-6.29.0 lib/puppet/x509/pem_store.rb
puppet-6.29.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.29.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.29.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-6.28.0 lib/puppet/x509/pem_store.rb
puppet-6.28.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.28.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.28.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-6.27.0 lib/puppet/x509/pem_store.rb
puppet-6.27.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.27.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.27.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-6.26.0 lib/puppet/x509/pem_store.rb
puppet-6.26.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.26.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.26.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-6.25.1 lib/puppet/x509/pem_store.rb
puppet-6.25.1-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.25.1-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-6.25.1-universal-darwin lib/puppet/x509/pem_store.rb