Sha256: d09a8cd3e0f1fd55f4e2499ee55a2178642e6ec06b4722a85c2e622e0640a2f7

Contents?: true

Size: 1.73 KB

Versions: 120

Compression:

Stored size: 1.73 KB

Contents

require_relative '../../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

120 entries across 120 versions & 1 rubygems

Version Path
puppet-7.34.0 lib/puppet/x509/pem_store.rb
puppet-7.34.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.34.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.34.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-7.33.0 lib/puppet/x509/pem_store.rb
puppet-7.33.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.33.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.33.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-7.32.1 lib/puppet/x509/pem_store.rb
puppet-7.32.1-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.32.1-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.32.1-universal-darwin lib/puppet/x509/pem_store.rb
puppet-7.31.0 lib/puppet/x509/pem_store.rb
puppet-7.31.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.31.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.31.0-universal-darwin lib/puppet/x509/pem_store.rb
puppet-7.30.0 lib/puppet/x509/pem_store.rb
puppet-7.30.0-x86-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.30.0-x64-mingw32 lib/puppet/x509/pem_store.rb
puppet-7.30.0-universal-darwin lib/puppet/x509/pem_store.rb