user package - os/user - Go Packages
Package user allows user account lookups by name or id.
For most Unix systems, this package has two internal implementations of resolving user and group ids to names, and listing supplementary group IDs. One is written in pure Go and parses /etc/passwd and /etc/group. The other is cgo-based and relies on the standard C library (libc) routines such as getpwuid_r, getgrnam_r, and getgrouplist.
When cgo is available, and the required routines are implemented in libc for a particular platform, cgo-based (libc-backed) code is used. This can be overridden by using osusergo build tag, which enforces the pure Go implementation.
This section is empty.
This section is empty.
This section is empty.
Group represents a grouping of users.
On POSIX systems Gid contains a decimal number representing the group ID.
LookupGroup looks up a group by name. If the group cannot be found, the returned error is of type UnknownGroupError.
LookupGroupId looks up a group by groupid. If the group cannot be found, the returned error is of type UnknownGroupIdError.
UnknownGroupError is returned by LookupGroup when a group cannot be found.
type UnknownGroupIdError string
UnknownGroupIdError is returned by LookupGroupId when a group cannot be found.
UnknownUserError is returned by Lookup when a user cannot be found.
User represents a user account.
Current returns the current user.
The first call will cache the current user information. Subsequent calls will return the cached value and will not reflect changes to the current user.
Lookup looks up a user by username. If the user cannot be found, the returned error is of type UnknownUserError.
LookupId looks up a user by userid. If the user cannot be found, the returned error is of type UnknownUserIdError.
GroupIds returns the list of group IDs that the user is a member of.