passwduser

package module

v0.0.0-...-9bf69c2 Latest Latest Go to latest Published: Oct 12, 2016 License: MIT Imports: 6 Imported by: 4

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/glestaris/passwduser

Links

Open Source Insights

README ¶

A cgo-free implementation of os/user that parses /etc/passwd

Golang's os/user is a great package that provides an API to access information for the current user/group. However, the Unix implementation relies in cgo since it uses getpwuid [1] to obtain the user/group information. This library is avoiding that by parsing the /etc/passwd file instead.

NOTICE this may not be enough for your application. getpwuid does also use LDAP and NIS databases to obtain the user information. If your system uses one of these technologies, this implementation is not for you and you unfortunately have to use cgo.

Work in progress

This package is currently only implementing the following methods:

Current() (*User, error)
Lookup(username string) (*User, error)
LookupId(uid string) (*User, error)

It does not yet implement:

(*User) GroupIds() ([]string, error)
LookupGroup(name string) (*Group, error)
LookupGroupId(gid string) (*Group, error)

[1] https://linux.die.net/man/3/getpwuid

Documentation ¶

Index ¶

type User

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type User ¶

type User struct {
	UID      string // user ID
	GID      string // primary group ID
	Username string
	Name     string
	HomeDir  string
}

User represents a user account.

func Current ¶

func Current() (*User, error)

Current finds and returns the current user.

func Lookup ¶

func Lookup(username string) (*User, error)

Lookup finds a user by her username.

func LookupID ¶

func LookupID(uid string) (*User, error)

LookupID finds a user by her UID.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL