getRealUserID calls getuid to obtain the real UserID
associated with the current process.
Moduleunix-2.8.8.0Haskell2010
System.Posix.User
POSIX user/group support
Contents
Synopsis
- value getRealUserID
- value getRealGroupID
- value getEffectiveUserID
- value getEffectiveGroupID
- value getGroups
- value getLoginName
- value getEffectiveUserName
- value groupName
- value groupPassword
- value groupID
- value groupMembers
- pattern GroupEntry
- value getGroupEntryForID
- value getGroupEntryForName
- value getAllGroupEntries
- value userName
- value userPassword
- value userID
- value userGroupID
- value userGecos
- value homeDirectory
- value userShell
- pattern UserEntry
- value getUserEntryForID
- value getUserEntryForName
- value getAllUserEntries
- value setUserID
- value setGroupID
- value setEffectiveUserID
- value setEffectiveGroupID
- value setGroups
- Packageunix-2.8.8.0
- Exports31
- LanguageHaskell2010
- LicenceBSD-3-Clause
- SourceUser.hsc
User environment
Querying the user environment
getRealGroupID calls getgid to obtain the real GroupID
associated with the current process.
getEffectiveUserID calls geteuid to obtain the effective
UserID associated with the current process.
getEffectiveGroupID calls getegid to obtain the effective
GroupID associated with the current process.
getGroups calls getgroups to obtain the list of
supplementary GroupIDs associated with the current process.
getLoginName calls getlogin to obtain the login name
associated with the current process.
getEffectiveUserName gets the name
associated with the effective UserID of the process.
The group database
Manually constructing GroupEntry in String modules is discouraged. It will truncate
Chars to 8bit. Use System.Posix.User.ByteString instead.
getGroupEntryForID gid calls getgrgid_r to obtain
the GroupEntry information associated with GroupID
gid. This operation may fail with isDoesNotExistError
if no such group exists.
getGroupEntryForName name calls getgrnam_r to obtain
the GroupEntry information associated with the group called
name. This operation may fail with isDoesNotExistError
if no such group exists.
getAllGroupEntries returns all group entries on the system by
repeatedly calling getgrent
The user database
pattern
pattern UserEntry :: String -> String -> UserID -> GroupID -> String -> String -> String -> UserEntryManually constructing UserEntry in String modules is discouraged. It will truncate
Chars to 8bit. Use System.Posix.User.ByteString instead.
getUserEntryForID uid calls getpwuid_r to obtain
the UserEntry information associated with UserID
uid. This operation may fail with isDoesNotExistError
if no such user exists.
getUserEntryForName name calls getpwnam_r to obtain
the UserEntry information associated with the user login
name. This operation may fail with isDoesNotExistError
if no such user exists.
getAllUserEntries returns all user entries on the system by
repeatedly calling getpwent
Modifying the user environment
setUserID uid calls setuid to set the real, effective, and
saved set-user-id associated with the current process to uid.
setGroupID gid calls setgid to set the real, effective, and
saved set-group-id associated with the current process to gid.
setEffectiveUserID uid calls seteuid to set the effective
user-id associated with the current process to uid. This
does not update the real user-id or set-user-id.
setEffectiveGroupID uid calls setegid to set the effective
group-id associated with the current process to gid. This
does not update the real group-id or set-group-id.
setGroups calls setgroups to set the list of
supplementary GroupIDs associated with the current process.