package userutil

import "github.com/tredoe/osutil/userutil"

Package userutil provides access to UNIX users database in local files.

You must have enough privileges to access to databases in shadowed files '/etc/shadow' and '/etc/gshadow'. This usually means have to be root. Note: those files are backed-up before of be modified.

In testing, to print the configuration read from the system, there is to use "-v" flag.

Index ¶

• Variables
• func AddGroupFromCmd(syst osutil.System, group string) error
• func CheckSudo(syst osutil.System) (err error)
• func IsExist(err error) bool
• func MustBeSuperUser(syst osutil.System) (err error)
• func RealUser(syst osutil.System) (string, error)
• type IdUsedError
• func (e IdUsedError) Error() string
• type NoFoundError
• func (e NoFoundError) Error() string
• type RequiredError
• func (e RequiredError) Error() string

Variables ¶

var (
	ErrUserExist  = errors.New("user already exists")
	ErrGroupExist = errors.New("group already exists")
)

var DO_BACKUP = true

DO_BACKUP does a backup before of modify the original files.

var Log = log.New(io.Discard, "", 0)

Functions ¶

func AddGroupFromCmd ¶

func AddGroupFromCmd(syst osutil.System, group string) error

AddGroupFromCmd adds the given group to the original user. Returns an information message, if the command is run.

func CheckSudo ¶

func CheckSudo(syst osutil.System) (err error)

CheckSudo executes command 'sudo' to check that the user has permission.

func IsExist ¶

func IsExist(err error) bool

IsExist returns whether the error is known to report that an user or group already exists. It is satisfied by ErrUserExist and ErrGroupExist.

func MustBeSuperUser ¶

func MustBeSuperUser(syst osutil.System) (err error)

MustBeSuperUser checks if the current user is in the superusers group. Panics if it is not being run as superuser.

func RealUser ¶

func RealUser(syst osutil.System) (string, error)

RealUser returns the original user at Unix systems.

Types ¶

type IdUsedError ¶

type IdUsedError int

IdUsedError reports the presence of an identifier already used.

func (IdUsedError) Error ¶

func (e IdUsedError) Error() string

type NoFoundError ¶

type NoFoundError struct {
	// contains filtered or unexported fields
}

A NoFoundError reports the absence of a value.

func (NoFoundError) Error ¶

func (e NoFoundError) Error() string

type RequiredError ¶

type RequiredError string

A RequiredError reports the name of a required field.

func (RequiredError) Error ¶

func (e RequiredError) Error() string

Source Files ¶

cmd_group.go doc.go error.go file.go log.go sudo.go util.go

Directories ¶