"errors"
"fmt"
"os"
"syscall"
"fmt"
"os"
"runtime"
"strconv"
"errors"
"fmt"
"internal/syscall/windows"
"internal/syscall/windows/registry"
"runtime"
"syscall"
"unsafe"
"fmt"
"strconv"
"unsafe"
"syscall"
"C"
"internal/syscall/unix"
"syscall"
"C"
"strconv"
"internal/syscall/unix"
"sync"
"errors"
"fmt"
"runtime"
"strconv"
"strings"
"syscall"
"unsafe"
"bufio"
"bytes"
"errors"
"fmt"
"io"
"os"
"strconv"
"bufio"
"bytes"
"errors"
"io"
"os"
"strconv"
"strings"
const _C__SC_GETGR_R_SIZE_MAX = unix.SC_GETGR_R_SIZE_MAXconst _C__SC_GETGR_R_SIZE_MAX = C._SC_GETGR_R_SIZE_MAXconst _C__SC_GETPW_R_SIZE_MAX = C._SC_GETPW_R_SIZE_MAXconst _C__SC_GETPW_R_SIZE_MAX = unix.SC_GETPW_R_SIZE_MAXcache of the current user
var cache struct{...}var colon = []byte{...}var groupBuffer = 0var groupBuffer = *ast.CallExprvar groupBuffer = 0var groupBuffer = 0const groupFile = "/etc/group"These may be set to false in init() for a particular platform and/or build flags to let the tests know to skip tests of some features.
var groupImplemented = trueThese may be set to false in init() for a particular platform and/or build flags to let the tests know to skip tests of some features.
var groupListImplemented = trueconst maxBufferSize = *ast.BinaryExprconst maxGroups = 2048unused variables (in this implementation) modified during test to exercise code paths in the cgo implementation.
var userBuffer = 0unused variables (in this implementation) modified during test to exercise code paths in the cgo implementation.
var userBuffer = 0var userBuffer = *ast.CallExprunused variables (in this implementation) modified during test to exercise code paths in the cgo implementation.
var userBuffer = 0const userFile = "/etc/passwd"These may be set to false in init() for a particular platform and/or build flags to let the tests know to skip tests of some features.
var userImplemented = trueUnknownGroupError is returned by [LookupGroup] when a group cannot be found.
type UnknownGroupError stringUnknownGroupIdError is returned by [LookupGroupId] when a group cannot be found.
type UnknownGroupIdError stringUnknownUserError is returned by [Lookup] when a user cannot be found.
type UnknownUserError stringUnknownUserIdError is returned by [LookupId] when a user cannot be found.
type UnknownUserIdError inttype _C_char C.chartype _C_char bytetype _C_gid_t uint32type _C_gid_t C.gid_ttype _C_int C.inttype _C_int int32type _C_long int64type _C_long C.longtype _C_size_t uintptrtype _C_size_t C.size_ttype _C_struct_group unix.Grouptype _C_struct_group C.struct_grouptype _C_struct_passwd unix.Passwdtype _C_struct_passwd C.struct_passwdtype _C_uid_t uint32type _C_uid_t C.uid_ttype bufferKind _C_intlineFunc returns a value, an error, or (nil, nil) to skip the row.
type lineFunc func(line []byte) (v any, err error)Group represents a grouping of users. On POSIX systems Gid contains a decimal number representing the group ID.
type Group struct {
Gid string
Name string
}User represents a user account.
type User struct {
Uid string
Gid string
Username string
Name string
HomeDir string
}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 Current() (*User, error)func (e UnknownGroupError) Error() stringfunc (e UnknownGroupIdError) Error() stringfunc (e UnknownUserError) Error() stringfunc (e UnknownUserIdError) Error() stringGroupIds returns the list of group IDs that the user is a member of.
func (u *User) GroupIds() ([]string, error)Lookup looks up a user by username. If the user cannot be found, the returned error is of type [UnknownUserError].
func Lookup(username string) (*User, error)LookupGroup looks up a group by name. If the group cannot be found, the returned error is of type [UnknownGroupError].
func LookupGroup(name string) (*Group, error)LookupGroupId looks up a group by groupid. If the group cannot be found, the returned error is of type [UnknownGroupIdError].
func LookupGroupId(gid string) (*Group, error)LookupId looks up a user by userid. If the user cannot be found, the returned error is of type [UnknownUserIdError].
func LookupId(uid string) (*User, error)func _C_GoString(p *_C_char) stringfunc _C_GoString(p *_C_char) stringfunc _C_getgrgid_r(gid _C_gid_t, buf *_C_char, size _C_size_t) (grp _C_struct_group, found bool, errno syscall.Errno)func _C_getgrgid_r(gid _C_gid_t, buf *_C_char, size _C_size_t) (grp _C_struct_group, found bool, errno syscall.Errno)func _C_getgrnam_r(name *_C_char, buf *_C_char, size _C_size_t) (grp _C_struct_group, found bool, errno syscall.Errno)func _C_getgrnam_r(name *_C_char, buf *_C_char, size _C_size_t) (grp _C_struct_group, found bool, errno syscall.Errno)func _C_getpwnam_r(name *_C_char, buf *_C_char, size _C_size_t) (pwd _C_struct_passwd, found bool, errno syscall.Errno)func _C_getpwnam_r(name *_C_char, buf *_C_char, size _C_size_t) (pwd _C_struct_passwd, found bool, errno syscall.Errno)func _C_getpwuid_r(uid _C_uid_t, buf *_C_char, size _C_size_t) (pwd _C_struct_passwd, found bool, errno syscall.Errno)func _C_getpwuid_r(uid _C_uid_t, buf *_C_char, size _C_size_t) (pwd _C_struct_passwd, found bool, errno syscall.Errno)func _C_gr_gid(g *_C_struct_group) _C_gid_tfunc _C_gr_gid(g *_C_struct_group) _C_gid_tfunc _C_gr_name(g *_C_struct_group) *_C_charfunc _C_gr_name(g *_C_struct_group) *_C_charfunc _C_pw_dir(p *_C_struct_passwd) *_C_charfunc _C_pw_dir(p *_C_struct_passwd) *_C_charfunc _C_pw_gecos(p *_C_struct_passwd) *_C_charfunc _C_pw_gecos(p *_C_struct_passwd) *_C_charfunc _C_pw_gid(p *_C_struct_passwd) _C_gid_tfunc _C_pw_gid(p *_C_struct_passwd) _C_gid_tfunc _C_pw_gidp(p *_C_struct_passwd) *_C_gid_tfunc _C_pw_gidp(p *_C_struct_passwd) *_C_gid_tfunc _C_pw_name(p *_C_struct_passwd) *_C_charfunc _C_pw_name(p *_C_struct_passwd) *_C_charfunc _C_pw_uid(p *_C_struct_passwd) _C_uid_tfunc _C_pw_uid(p *_C_struct_passwd) _C_uid_tfunc _C_pw_uidp(p *_C_struct_passwd) *_C_uid_tfunc _C_pw_uidp(p *_C_struct_passwd) *_C_uid_tfunc _C_sysconf(key _C_int) _C_longfunc _C_sysconf(key _C_int) _C_longfunc buildGroup(grp *_C_struct_group) *Groupfunc buildUser(pwd *_C_struct_passwd) *Userfunc current() (*User, error)func current() (*User, error)func current() (*User, error)func current() (*User, error)func currentGID() stringfunc currentUID() stringfunc findGroupId(id string, r io.Reader) (*Group, error)func findGroupName(name string, r io.Reader) (*Group, error)findHomeDirInRegistry finds the user home path based on the uid.
func findHomeDirInRegistry(uid string) (dir string, e error)func findUserId(uid string, r io.Reader) (*User, error)func findUsername(name string, r io.Reader) (*User, error)getCurrentToken returns the current thread token, or the process token if the thread doesn't have a token.
func getCurrentToken() (t syscall.Token, isProcessToken bool, err error)func getGroupList(name *_C_char, userGID _C_gid_t, gids *_C_gid_t, n *_C_int) _C_intfunc getGroupList(name *_C_char, userGID _C_gid_t, gids *_C_gid_t, n *_C_int) _C_intgetProfilesDirectory retrieves the path to the root directory where user profiles are stored.
func getProfilesDirectory() (string, error)groupRetry retries getGroupList with much larger size for n. The result is stored in gids.
func groupRetry(username string, name []byte, userGID _C_gid_t, gids *[]_C_gid_t, n *_C_int) errorfunc init()func init()func (k bufferKind) initialSize() _C_size_tfunc isDomainJoined() (bool, error)func isServiceAccount(sid *syscall.SID) boolfunc isSizeReasonable(sz int64) boolfunc isValidGroupAccountType(sidType uint32) boolfunc isValidUserAccountType(sid *syscall.SID, sidType uint32) boolfunc listGroups(u *User) ([]string, error)func listGroups(*User) ([]string, error)func listGroups(u *User) ([]string, error)func listGroups(*User) ([]string, error)func listGroups(user *User) ([]string, error)listGroupsForUsernameAndDomain accepts username and domain and retrieves a SID list of the local groups where this user is a member.
func listGroupsForUsernameAndDomain(username string, domain string) ([]string, error)func listGroupsFromReader(u *User, r io.Reader) ([]string, error)func lookupFullName(domain string, username string, domainAndUser string) (string, error)func lookupFullNameDomain(domainAndUser string) (string, error)func lookupFullNameServer(servername string, username string) (string, error)func lookupGroup(groupname string) (*Group, error)func lookupGroup(groupname string) (*Group, error)func lookupGroup(string) (*Group, error)func lookupGroup(groupname string) (*Group, error)func lookupGroup(groupname string) (*Group, error)func lookupGroupId(string) (*Group, error)func lookupGroupId(gid string) (*Group, error)func lookupGroupId(id string) (*Group, error)func lookupGroupId(gid string) (*Group, error)func lookupGroupId(string) (*Group, error)lookupGroupName accepts the name of a group and retrieves the group SID.
func lookupGroupName(groupname string) (string, error)func lookupUnixGid(gid int) (*Group, error)func lookupUnixUid(uid int) (*User, error)func lookupUser(string) (*User, error)func lookupUser(username string) (*User, error)func lookupUser(username string) (*User, error)func lookupUser(username string) (*User, error)func lookupUser(username string) (*User, error)func lookupUserId(uid string) (*User, error)func lookupUserId(uid string) (*User, error)func lookupUserId(uid string) (*User, error)func lookupUserId(string) (*User, error)func lookupUserId(uid string) (*User, error)lookupUserPrimaryGroup obtains the primary group SID for a user using this method: https://support.microsoft.com/en-us/help/297951/how-to-use-the-primarygroupid-attribute-to-find-the-primary-group-for The method follows this formula: domainRID + "-" + primaryGroupRID
func lookupUserPrimaryGroup(username string, domain string) (string, error)lookupUsernameAndDomain obtains the username and domain for usid.
func lookupUsernameAndDomain(usid *syscall.SID) (username string, domain string, sidType uint32, e error)func matchGroupIndexValue(value string, idx int) lineFuncreturns a *User for a row if that row's has the given value at the given index.
func matchUserIndexValue(value string, idx int) lineFuncfunc newUser(uid string, gid string, dir string, username string, domain string) (*User, error)func newUserFromSid(usid *syscall.SID) (*User, error)readColonFile parses r as an /etc/group or /etc/passwd style file, running fn for each row. readColonFile returns a value, an error, or (nil, nil) if the end of the file is reached without a match. readCols is the minimum number of colon-separated fields that will be passed to fn; in a long line additional fields may be silently discarded.
func readColonFile(r io.Reader, fn lineFunc, readCols int) (v any, err error)retryWithBuffer repeatedly calls f(), increasing the size of the buffer each time, until f succeeds, fails with a non-ERANGE error, or the buffer exceeds a reasonable limit.
func retryWithBuffer(kind bufferKind, f func([]byte) syscall.Errno) errorrunAsProcessOwner runs f in the context of the current process owner, that is, removing any impersonation that may be in effect before calling f, and restoring the impersonation afterwards.
func runAsProcessOwner(f func() error) errorBecause we can't use cgo in tests:
func structPasswdForNegativeTest() _C_struct_passwdGenerated with Arrow