class Chef::Provider::User::Linux

Public Instance Methods

check_lock() click to toggle source
# File lib/chef/provider/user/linux.rb, line 88
def check_lock
  # there's an old bug in rhel (https://bugzilla.redhat.com/show_bug.cgi?id=578534)
  # which means that both 0 and 1 can be success.
  passwd_s = shell_out("passwd", "-S", new_resource.username, returns: [ 0, 1 ])

  # checking "does not exist" has to come before exit code handling since centos and ubuntu differ in exit codes
  if passwd_s.stderr =~ /does not exist/
    return false if whyrun_mode?
    raise Chef::Exceptions::User, "User #{new_resource.username} does not exist when checking lock status for #{new_resource}"
  end

  # now raise if we didn't get a 0 or 1 (see above)
  passwd_s.error!

  # now the actual output parsing
  @locked = nil
  status_line = passwd_s.stdout.split(" ")
  @locked = false if status_line[1] =~ /^[PN]/
  @locked = true if status_line[1] =~ /^L/

  raise Chef::Exceptions::User, "Cannot determine if user #{new_resource.username} is locked for #{new_resource}" if @locked.nil?

  # FIXME: should probably go on the current_resource
  @locked
end
create_user() click to toggle source
# File lib/chef/provider/user/linux.rb, line 26
def create_user
  shell_out!("useradd", universal_options, useradd_options, new_resource.username)
end
lock_user() click to toggle source
# File lib/chef/provider/user/linux.rb, line 38
def lock_user
  shell_out!("usermod", "-L", new_resource.username)
end
manage_user() click to toggle source
# File lib/chef/provider/user/linux.rb, line 30
def manage_user
  shell_out!("usermod", universal_options, usermod_options, new_resource.username)
end
remove_user() click to toggle source
# File lib/chef/provider/user/linux.rb, line 34
def remove_user
  shell_out!("userdel", userdel_options, new_resource.username)
end
universal_options() click to toggle source

common to usermod and useradd

# File lib/chef/provider/user/linux.rb, line 47
def universal_options
  opts = []
  opts << "-c" << new_resource.comment if should_set?(:comment)
  opts << "-g" << new_resource.gid if should_set?(:gid)
  opts << "-p" << new_resource.password if should_set?(:password)
  opts << "-s" << new_resource.shell if should_set?(:shell)
  opts << "-u" << new_resource.uid if should_set?(:uid)
  opts << "-d" << new_resource.home if updating_home?
  opts << "-o" if new_resource.non_unique
  opts
end
unlock_user() click to toggle source
# File lib/chef/provider/user/linux.rb, line 42
def unlock_user
  shell_out!("usermod", "-U", new_resource.username)
end
useradd_options() click to toggle source
# File lib/chef/provider/user/linux.rb, line 70
def useradd_options
  opts = []
  opts << "-r" if new_resource.system
  opts << if new_resource.manage_home
            "-m"
          else
            "-M"
          end
  opts
end
userdel_options() click to toggle source
# File lib/chef/provider/user/linux.rb, line 81
def userdel_options
  opts = []
  opts << "-r" if new_resource.manage_home
  opts << "-f" if new_resource.force
  opts
end
usermod_options() click to toggle source
# File lib/chef/provider/user/linux.rb, line 59
def usermod_options
  opts = []
  opts += [ "-u", new_resource.uid ] if new_resource.non_unique
  if updating_home?
    if new_resource.manage_home
      opts << "-m"
    end
  end
  opts
end