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

Read Permset

Show Permset

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

Read ACL

Show ACL

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().