System.Posix.ACL

Support for POSIX.1e Access Control Lists (ACL), defined in section 23 of the draft standard IEEE Std 1003.1e.

Documentation

data Permset

A combination of read, write and execute permissions.

Constructors

Permset

Fields

• hasRead :: Bool
• hasWrite :: Bool
• hasExecute :: Bool

Instances

Eq Permset

Methods

(==) :: Permset -> Permset -> Bool

(/=) :: Permset -> Permset -> Bool

Read Permset

Methods

readsPrec :: Int -> ReadS Permset

readList :: ReadS [Permset]

readPrec :: ReadPrec Permset

readListPrec :: ReadPrec [Permset]

Show Permset

Methods

showsPrec :: Int -> Permset -> ShowS

show :: Permset -> String

showList :: [Permset] -> ShowS

emptyPermset :: Permset

No permission.

fullPermset :: Permset

Read, write and execute permissions.

unionPermsets :: Permset -> Permset -> Permset

Give a permission if any of the two arguments grant that permission.

intersectPermsets :: Permset -> Permset -> Permset

Give a permission if both the arguments grant that permission.

data ACL

Represent a valid ACL as defined in POSIX.1e. The Show instance is defined to output the Short Text Form of the ACL (see section 23.3.2 of IEEE Std 1003.1e), while the Read instance is defined to be able to parse both the long and short text form (read only parses valid ACLs).

Constructors

MinimumACL

Fields

• ownerPerms :: Permset
• owningGroupPerms :: Permset
• otherPerms :: Permset

ExtendedACL

Fields

• ownerPerms :: Permset
• usersPerms :: Map UserID Permset
• owningGroupPerms :: Permset
• groupsPerms :: Map GroupID Permset
• mask :: Permset
• otherPerms :: Permset

Instances

Eq ACL

Methods

(==) :: ACL -> ACL -> Bool

(/=) :: ACL -> ACL -> Bool

Read ACL

Methods

readsPrec :: Int -> ReadS ACL

readList :: ReadS [ACL]

readPrec :: ReadPrec ACL

readListPrec :: ReadPrec [ACL]

Show ACL

Methods

showsPrec :: Int -> ACL -> ShowS

show :: ACL -> String

showList :: [ACL] -> ShowS

longTextForm :: ACL -> String

Convert an ACL to its Long Text Form (see section 23.3.1 of IEEE Std 1003.1e).

shortTextFrom :: ACL -> String

Convert an ACL to its Short Text Form (see section 23.3.2 of IEEE Std 1003.1e).

Get and set ACLs

getACL :: FilePath -> IO ACL

Retrieve the ACL from a file.

getDefaultACL :: FilePath -> IO (Maybe ACL)

Retrieve the default ACL from a directory (return Nothing if there is no default ACL).

fdGetACL :: Fd -> IO ACL

Retrieve the ACL from a file, given its file descriptor.

setACL :: FilePath -> ACL -> IO ()

Set the ACL for a file.

setDefaultACL :: FilePath -> ACL -> IO ()

Set the default ACL for a directory.

fdSetACL :: Fd -> ACL -> IO ()

Set the ACL for a file, given its file descriptor.

deleteDefaultACL :: FilePath -> IO ()

Delete the default ACL from a directory.

Call to acl_delete_def_file().