unix-2.2.0.0: POSIX functionality Contents Index

System.Posix.User Portability non-portable (requires POSIX) Stability provisional Maintainer libraries@haskell.org

Contents User environment Querying the user environment The group database The user database Modifying the user environment

Description

POSIX user/group support

Synopsis

getRealUserID :: IO UserID getRealGroupID :: IO GroupID getEffectiveUserID :: IO UserID getEffectiveGroupID :: IO GroupID getGroups :: IO [GroupID] getLoginName :: IO String getEffectiveUserName :: IO String data GroupEntry = GroupEntry { groupName :: String groupPassword :: String groupID :: GroupID groupMembers :: [String] } getGroupEntryForID :: GroupID -> IO GroupEntry getGroupEntryForName :: String -> IO GroupEntry getAllGroupEntries :: IO [GroupEntry] data UserEntry = UserEntry { userName :: String userPassword :: String userID :: UserID userGroupID :: GroupID userGecos :: String homeDirectory :: String userShell :: String } getUserEntryForID :: UserID -> IO UserEntry getUserEntryForName :: String -> IO UserEntry getAllUserEntries :: IO [UserEntry] setUserID :: UserID -> IO () setGroupID :: GroupID -> IO ()

User environment

Querying the user environment

getRealUserID :: IO UserID

getRealUserID calls getuid to obtain the real UserID associated with the current process.

getRealGroupID :: IO GroupID

getRealGroupID calls getgid to obtain the real GroupID associated with the current process.

getEffectiveUserID :: IO UserID

getEffectiveUserID calls geteuid to obtain the effective UserID associated with the current process.

getEffectiveGroupID :: IO GroupID

getEffectiveGroupID calls getegid to obtain the effective GroupID associated with the current process.

getGroups :: IO [GroupID]

getGroups calls getgroups to obtain the list of supplementary GroupIDs associated with the current process.

getLoginName :: IO String

getLoginName calls getlogin to obtain the login name associated with the current process.

getEffectiveUserName :: IO String

getEffectiveUserName gets the name associated with the effective UserID of the process.

The group database

data GroupEntry

Constructors GroupEntry groupName :: String The name of this group (gr_name) groupPassword :: String The password for this group (gr_passwd) groupID :: GroupID The unique numeric ID for this group (gr_gid) groupMembers :: [String] A list of zero or more usernames that are members (gr_mem) Instances Eq GroupEntry Read GroupEntry Show GroupEntry

getGroupEntryForID :: GroupID -> IO GroupEntry

getGroupEntryForID gid calls getgrgid to obtain the GroupEntry information associated with GroupID gid.

getGroupEntryForName :: String -> IO GroupEntry

getGroupEntryForName name calls getgrnam to obtain the GroupEntry information associated with the group called name.

getAllGroupEntries :: IO [GroupEntry]

getAllGroupEntries returns all group entries on the system by repeatedly calling getgrent

The user database

data UserEntry

Constructors UserEntry userName :: String Textual name of this user (pw_name) userPassword :: String Password -- may be empty or fake if shadow is in use (pw_passwd) userID :: UserID Numeric ID for this user (pw_uid) userGroupID :: GroupID Primary group ID (pw_gid) userGecos :: String Usually the real name for the user (pw_gecos) homeDirectory :: String Home directory (pw_dir) userShell :: String Default shell (pw_shell) Instances Eq UserEntry Read UserEntry Show UserEntry

getUserEntryForID :: UserID -> IO UserEntry

getUserEntryForID gid calls getpwuid to obtain the UserEntry information associated with UserID uid.

getUserEntryForName :: String -> IO UserEntry

getUserEntryForName name calls getpwnam to obtain the UserEntry information associated with the user login name.

getAllUserEntries :: IO [UserEntry]

getAllUserEntries returns all user entries on the system by repeatedly calling getpwent

Modifying the user environment

setUserID :: UserID -> IO ()

setUserID uid calls setuid to set the real, effective, and saved set-user-id associated with the current process to uid.

setGroupID :: GroupID -> IO ()

setGroupID gid calls setgid to set the real, effective, and saved set-group-id associated with the current process to gid.

Produced by Haddock version 0.8