package user

Import Path
	os/user (on golang.org and go.dev)

Dependency Relation
	imports 10 packages, and imported by one package

Involved Source Files
	    lookup.go
	    lookup_stubs.go
	    lookup_unix.go
	d-> user.go

Exported Type Names

type Group (struct) Group represents a grouping of users. On POSIX systems Gid contains a decimal number representing the group ID. // group ID // group name func LookupGroup(name string) (*Group, error) func LookupGroupId(gid string) (*Group, error)
type UnknownGroupError string UnknownGroupError is returned by LookupGroup when a group cannot be found. ( T) Error() string T : error
type UnknownGroupIdError string UnknownGroupIdError is returned by LookupGroupId when a group cannot be found. ( T) Error() string T : error
type UnknownUserError string UnknownUserError is returned by Lookup when a user cannot be found. ( T) Error() string T : error
type UnknownUserIdError int UnknownUserIdError is returned by LookupId when a user cannot be found. ( T) Error() string T : error
type User (struct) User represents a user account. Gid is the primary group ID. On POSIX systems, this is a decimal number representing the gid. On Windows, this is a SID in a string format. On Plan 9, this is the contents of /dev/user. HomeDir is the path to the user's home directory (if they have one). Name is the user's real or display name. It might be blank. On POSIX systems, this is the first (or only) entry in the GECOS field list. On Windows, this is the user's display name. On Plan 9, this is the contents of /dev/user. Uid is the user ID. On POSIX systems, this is a decimal number representing the uid. On Windows, this is a security identifier (SID) in a string format. On Plan 9, this is the contents of /dev/user. Username is the login name. GroupIds returns the list of group IDs that the user is a member of. func Current() (*User, error) func Lookup(username string) (*User, error) func LookupId(uid string) (*User, error)
Exported Values
func Current() (*User, error) 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.
func Lookup(username string) (*User, error) Lookup looks up a user by username. If the user cannot be found, the returned error is of type UnknownUserError.
func LookupGroup(name string) (*Group, error) LookupGroup looks up a group by name. If the group cannot be found, the returned error is of type UnknownGroupError.
func LookupGroupId(gid string) (*Group, error) LookupGroupId looks up a group by groupid. If the group cannot be found, the returned error is of type UnknownGroupIdError.
func LookupId(uid string) (*User, error) LookupId looks up a user by userid. If the user cannot be found, the returned error is of type UnknownUserIdError.