Пакет user
Обзор
Пакет user позволяет искать учётные записи пользователей по имени или идентификатору.
В большинстве систем Unix этот пакет содержит две внутренние реализации поиска имён по идентификаторам пользователей и групп, а также получения списка дополнительных идентификаторов групп. Одна написана на чистом Go и анализирует файлы /etc/passwd и /etc/group. Другая основана на cgo и использует процедуры стандартной библиотеки C (libc), такие как getpwuid_r, getgrnam_r и getgrouplist.
Если cgo доступен и необходимые процедуры реализованы в libc для конкретной платформы, используется код на основе cgo (libc). Это поведение можно изменить с помощью тега сборки osusergo, который принудительно включает реализацию на чистом Go.
Указатель
Файлы пакета
cgo_listgroups_unix.go cgo_lookup_cgo.go cgo_lookup_unix.go getgrouplist_unix.go lookup.go user.go
тип Group 1.7
Group представляет группу пользователей.
В системах POSIX поле Gid содержит десятичное число, представляющее идентификатор группы.
type Group struct {
Gid string // group ID
Name string // group name
}
функция LookupGroup 1.7
func LookupGroup(name string) (*Group, error)
LookupGroup ищет группу по имени. Если группа не найдена, возвращаемая ошибка имеет тип UnknownGroupError.
функция LookupGroupId 1.7
func LookupGroupId(gid string) (*Group, error)
LookupGroupId ищет группу по идентификатору группы. Если группа не найдена, возвращаемая ошибка имеет тип UnknownGroupIdError.
тип UnknownGroupError 1.7
UnknownGroupError возвращается функцией LookupGroup, если группа не найдена.
type UnknownGroupError string
функция (UnknownGroupError) Error 1.7
func (e UnknownGroupError) Error() string
тип UnknownGroupIdError 1.7
UnknownGroupIdError возвращается функцией LookupGroupId, если группа не найдена.
type UnknownGroupIdError string
функция (UnknownGroupIdError) Error 1.7
func (e UnknownGroupIdError) Error() string
тип UnknownUserError
UnknownUserError возвращается функцией Lookup, если пользователь не найден.
type UnknownUserError string
функция (UnknownUserError) Error
func (e UnknownUserError) Error() string
тип UnknownUserIdError
UnknownUserIdError возвращается функцией LookupId, если пользователь не найден.
type UnknownUserIdError int
функция (UnknownUserIdError) Error
func (e UnknownUserIdError) Error() string
тип User
User представляет учётную запись пользователя.
type User struct {
// 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.
Uid 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.
Gid string
// Username is the login name.
Username 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.
Name string
// HomeDir is the path to the user's home directory (if they have one).
HomeDir string
}
функция Current
func Current() (*User, error)
Current возвращает текущего пользователя.
При первом вызове информация о текущем пользователе кэшируется. Последующие вызовы возвращают кэшированное значение и не учитывают изменения текущего пользователя.
функция Lookup
func Lookup(username string) (*User, error)
Lookup ищет пользователя по имени пользователя. Если пользователь не найден, возвращаемая ошибка имеет тип UnknownUserError.
функция LookupId
func LookupId(uid string) (*User, error)
LookupId ищет пользователя по идентификатору пользователя. Если пользователь не найден, возвращаемая ошибка имеет тип UnknownUserIdError.
функция (*User) GroupIds 1.7
func (u *User) GroupIds() ([]string, error)
GroupIds возвращает список идентификаторов групп, участником которых является пользователь.
© Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
http://golang.org/pkg/os/user/
