package user

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

Dependency Relation
	imports 7 packages, and imported by 2 packages

Involved Source Files
	      lookup.go
	   d➜ user.go
		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. 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 and getgrnam_r.

		When cgo is available, cgo-based (libc-backed) code is used by default.
		This can be overridden by using osusergo build tag, which enforces
		the pure Go implementation.

	      cgo_lookup_unix.go
	      getgrouplist_darwin.go
	      listgroups_unix.go
Package-Level Type Names (total 26, in which 6 are exported)

	/* sort exporteds by: alphabet | popularity */
	 type Group (struct)
		Group represents a grouping of users.

		On POSIX systems Gid contains a decimal number representing the group ID.

		Fields (total 2, both are exported)
			Gid string
				// group ID

			Name string
				// group name

		As Outputs Of (at least 6, in which 2 are exported)
			func LookupGroup(name string) (*Group, error)
			func LookupGroupId(gid string) (*Group, error)
			/* 4+ unexporteds ... *//* 4+ unexporteds: */
			func buildGroup(grp *_Ctype_struct_group) *Group
			func lookupGroup(groupname string) (*Group, error)
			func lookupGroupId(gid string) (*Group, error)
			func lookupUnixGid(gid int) (*Group, error)

	 type UnknownGroupError string (basic type)
		UnknownGroupError is returned by LookupGroup when
		a group cannot be found.

		Methods (only one, which is exported)
			( T) Error() string
		Implements (at least one exported)
			 T : error

	 type UnknownGroupIdError string (basic type)
		UnknownGroupIdError is returned by LookupGroupId when
		a group cannot be found.

		Methods (only one, which is exported)
			( T) Error() string
		Implements (at least one exported)
			 T : error

	 type UnknownUserError string (basic type)
		UnknownUserError is returned by Lookup when
		a user cannot be found.

		Methods (only one, which is exported)
			( T) Error() string
		Implements (at least one exported)
			 T : error

	 type UnknownUserIdError int (basic type)
		UnknownUserIdError is returned by LookupId when a user cannot be found.

		Methods (only one, which is exported)
			( T) Error() string
		Implements (at least one exported)
			 T : error

	 type User (struct)
		User represents a user account.

		Fields (total 5, all are exported)
			Gid string
				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 string
				HomeDir is the path to the user's home directory (if they have one).

			Name string
				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 string
				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 string
				Username is the login name.

		Methods (only one, which is exported)
			(*T) GroupIds() ([]string, error)
				GroupIds returns the list of group IDs that the user is a member of.

		As Outputs Of (at least 8, in which 3 are exported)
			func Current() (*User, error)
			func Lookup(username string) (*User, error)
			func LookupId(uid string) (*User, error)
			/* 5+ unexporteds ... *//* 5+ unexporteds: */
			func buildUser(pwd *_Ctype_struct_passwd) *User
			func current() (*User, error)
			func lookupUnixUid(uid int) (*User, error)
			func lookupUser(username string) (*User, error)
			func lookupUserId(uid string) (*User, error)
		As Inputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func listGroups(u *User) ([]string, error)

	/* 20 unexporteds ... *//* 20 unexporteds: */
	 type _Ctype___darwin_gid_t = _Ctype___uint32_t (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype___darwin_time_t = _Ctype_long (basic type)

		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)

	 type _Ctype___darwin_uid_t = _Ctype___uint32_t (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype___uint32_t = _Ctype_uint (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype__GoString_ string (basic type)
	 type _Ctype_char int8 (basic type)

		As Inputs Of (at least 10, none are exported)
			/* 10+ unexporteds ... *//* 10+ unexporteds: */
			func _Cfunc_GoString(p *_Ctype_char) string
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _cgo_runtime_gostring(*_Ctype_char) string
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int

	 type _Ctype_gid_t = _Ctype___darwin_gid_t (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype_int int32 (basic type)

		As Outputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype_intgo = _Ctype_ptrdiff_t (basic type)

		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)

	 type _Ctype_long int64 (basic type)

		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)

	 type _Ctype_ptrdiff_t = _Ctype_long (basic type)

		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)

	 type _Ctype_size_t = _Ctype_ulong (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc__CMalloc(n _Ctype_size_t) unsafe.Pointer
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_realloc(p0 unsafe.Pointer, p1 _Ctype_size_t) (r1 unsafe.Pointer)

	 type _Ctype_struct_group (struct)

		Fields (total 4, none are exported)
			/* 4 unexporteds ... *//* 4 unexporteds: */
			gr_gid _Ctype_gid_t
			gr_mem **_Ctype_char
			gr_name *_Ctype_char
			gr_passwd *_Ctype_char
		As Inputs Of (at least 5, none are exported)
			/* 5+ unexporteds ... *//* 5+ unexporteds: */
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func buildGroup(grp *_Ctype_struct_group) *Group

	 type _Ctype_struct_passwd (struct)

		Fields (total 10, none are exported)
			/* 10 unexporteds ... *//* 10 unexporteds: */
			pw_change _Ctype___darwin_time_t
			pw_class *_Ctype_char
			pw_dir *_Ctype_char
			pw_expire _Ctype___darwin_time_t
			pw_gecos *_Ctype_char
			pw_gid _Ctype_gid_t
			pw_name *_Ctype_char
			pw_passwd *_Ctype_char
			pw_shell *_Ctype_char
			pw_uid _Ctype_uid_t
		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func structPasswdForNegativeTest() _Ctype_struct_passwd
		As Inputs Of (at least 5, none are exported)
			/* 5+ unexporteds ... *//* 5+ unexporteds: */
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func buildUser(pwd *_Ctype_struct_passwd) *User

	 type _Ctype_uid_t = _Ctype___darwin_uid_t (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype_uint uint32 (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
			func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error

	 type _Ctype_ulong uint64 (basic type)

		As Inputs Of (at least 6, none are exported)
			/* 6+ unexporteds ... *//* 6+ unexporteds: */
			func _Cfunc__CMalloc(n _Ctype_size_t) unsafe.Pointer
			func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
			func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
			func _Cfunc_realloc(p0 unsafe.Pointer, p1 _Ctype_size_t) (r1 unsafe.Pointer)

	 type _Ctype_void ([...]T)

		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func _Cfunc_free(p0 unsafe.Pointer) (r1 _Ctype_void)

	 type bufferKind _Ctype_int (basic type)

		Methods (only one, which is unexported)
			/* one unexported ... *//* one unexported: */
			( T) initialSize() _Ctype_size_t
		As Inputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func alloc(kind bufferKind) *memBuffer
		As Types Of (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			const groupBuffer
			const userBuffer

	 type memBuffer (struct)

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			ptr unsafe.Pointer
			size _Ctype_size_t
				// line :222:15

		Methods (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			(*T) free()
			(*T) resize(newSize _Ctype_size_t)
		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func alloc(kind bufferKind) *memBuffer
		As Inputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func retryWithBuffer(buf *memBuffer, f func() syscall.Errno) error


Package-Level Functions (total 39, in which 5 are exported)

	 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.

	/* 34 unexporteds ... *//* 34 unexporteds: */
	 func _Cfunc__CMalloc(n _Ctype_size_t) unsafe.Pointer
	 func _Cfunc_free(p0 unsafe.Pointer) (r1 _Ctype_void)
	 func _Cfunc_GoString(p *_Ctype_char) string
	 func _Cfunc_mygetgrgid_r(p0 _Ctype_int, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
	 func _Cfunc_mygetgrnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_group, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_group) (r1 _Ctype_int)
	 func _Cfunc_mygetgrouplist(p0 *_Ctype_char, p1 _Ctype_gid_t, p2 *_Ctype_gid_t, p3 *_Ctype_int) (r1 _Ctype_int)
	 func _Cfunc_mygetpwnam_r(p0 *_Ctype_char, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
	 func _Cfunc_mygetpwuid_r(p0 _Ctype_int, p1 *_Ctype_struct_passwd, p2 *_Ctype_char, p3 _Ctype_size_t, p4 **_Ctype_struct_passwd) (r1 _Ctype_int)
	 func _Cfunc_realloc(p0 unsafe.Pointer, p1 _Ctype_size_t) (r1 unsafe.Pointer)
	 func _Cfunc_sysconf(p0 _Ctype_int) (r1 _Ctype_long)
	 func _cgo_cmalloc(p0 uint64) (r1 unsafe.Pointer)
	 func _Cgo_ptr(ptr unsafe.Pointer) unsafe.Pointer
	 func _cgo_runtime_cgocall(unsafe.Pointer, uintptr) int32
	 func _cgo_runtime_gostring(*_Ctype_char) string
	 func _Cgo_use(interface{})
	 func _cgoCheckPointer(interface{}, interface{})
	 func _cgoCheckResult(interface{})
	 func alloc(kind bufferKind) *memBuffer
	 func buildGroup(grp *_Ctype_struct_group) *Group
	 func buildUser(pwd *_Ctype_struct_passwd) *User
	 func current() (*User, error)
	 func getGroupList(name *_Ctype_char, userGID _Ctype_gid_t, gids *_Ctype_gid_t, n *_Ctype_int) _Ctype_int
	 func groupRetry(username string, name []byte, userGID _Ctype_gid_t, gids *[]_Ctype_gid_t, n *_Ctype_int) error
		groupRetry retries getGroupList with an increasingly large size for n. The
		result is stored in gids.

	 func isSizeReasonable(sz int64) bool
	 func listGroups(u *User) ([]string, error)
	 func lookupGroup(groupname string) (*Group, error)
	 func lookupGroupId(gid string) (*Group, error)
	 func lookupUnixGid(gid int) (*Group, error)
	 func lookupUnixUid(uid int) (*User, error)
	 func lookupUser(username string) (*User, error)
	 func lookupUserId(uid string) (*User, error)
	 func retryWithBuffer(buf *memBuffer, f func() syscall.Errno) 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 runtime_throw(string)
	 func structPasswdForNegativeTest() _Ctype_struct_passwd
		Because we can't use cgo in tests:


Package-Level Variables (total 22, none are exported)

	/* 22 unexporteds ... *//* 22 unexporteds: */
	  var __cgofn__cgo_a722341dd114_Cfunc__Cmalloc byte
	  var __cgofn__cgo_a722341dd114_Cfunc_free byte
	  var __cgofn__cgo_a722341dd114_Cfunc_mygetgrgid_r byte
	  var __cgofn__cgo_a722341dd114_Cfunc_mygetgrnam_r byte
	  var __cgofn__cgo_a722341dd114_Cfunc_mygetgrouplist byte
	  var __cgofn__cgo_a722341dd114_Cfunc_mygetpwnam_r byte
	  var __cgofn__cgo_a722341dd114_Cfunc_mygetpwuid_r byte
	  var __cgofn__cgo_a722341dd114_Cfunc_realloc byte
	  var __cgofn__cgo_a722341dd114_Cfunc_sysconf byte
	  var _cgo_a722341dd114_Cfunc__Cmalloc Pointer
	  var _cgo_a722341dd114_Cfunc_free Pointer
	  var _cgo_a722341dd114_Cfunc_mygetgrgid_r Pointer
	  var _cgo_a722341dd114_Cfunc_mygetgrnam_r Pointer
	  var _cgo_a722341dd114_Cfunc_mygetgrouplist Pointer
	  var _cgo_a722341dd114_Cfunc_mygetpwnam_r Pointer
	  var _cgo_a722341dd114_Cfunc_mygetpwuid_r Pointer
	  var _cgo_a722341dd114_Cfunc_realloc Pointer
	  var _cgo_a722341dd114_Cfunc_sysconf Pointer
	  var _Cgo_always_false bool
	  var cache struct{sync.Once; u *User; err error}
		cache of the current user

	  var groupImplemented bool // set to false by lookup_stubs.go's init
	  var userImplemented bool // set to false by lookup_stubs.go's init
Package-Level Constants (total 6, none are exported)

	/* 6 unexporteds ... *//* 6 unexporteds: */
	const _Ciconst__SC_GETGR_R_SIZE_MAX = 70
	const _Ciconst__SC_GETPW_R_SIZE_MAX = 71
	const groupBuffer bufferKind = 70
	const maxBufferSize = 1048576
	const maxGroups = 2048
	const userBuffer bufferKind = 71

The pages are generated with Golds v0.2.8-preview. (GOOS=darwin GOARCH=arm64)