System.XAttr

XAttr provides bindings to the glibc function for reading and manipulating extended attributes (setxattr, getxattr, listxattr, ...).

Each function in this module has two variants: the one with the name prefixed by "l" and "fd". Both of these are identical to the original version except that the "l"-variant does not follow symbolic link but acts on the link itself, and the "fd"-variant take a file descriptor as argument rather than a filepath.

Set extended attributes

setXAttr

Arguments

:: FilePath

target file

-> String

name of attribute to set

-> String

value of attribute

-> IO ()

setXAttr sets the value of an extended attribute.

lSetXAttr :: FilePath -> String -> String -> IO ()

fdSetXAttr :: Fd -> String -> String -> IO ()

Create extended attributes

createXAttr :: FilePath -> String -> String -> IO ()

createXAttr is identical to setXAttr, but if the attribute already exists it fails and sets errno to EEXIST.

lCreateXAttr :: FilePath -> String -> String -> IO ()

fdCreateXAttr :: Fd -> String -> String -> IO ()

Replace extended attributes

replaceXAttr :: FilePath -> String -> String -> IO ()

replaceXAttr is identical to setXAttr, but if the attribute does not exist it fails and sets errno to ENOATTR.

lReplaceXAttr :: FilePath -> String -> String -> IO ()

fdReplaceXAttr :: Fd -> String -> String -> IO ()

Retrive extended attributes

getXAttr

Arguments

:: FilePath

target file

-> String

name of the attribute

-> IO String

value of the attribute

getXAttr retrieves the value of an extended attribute

lGetXAttr :: FilePath -> String -> IO String

fdGetXAttr :: Fd -> String -> IO String

List extended attributes

listXAttr

Arguments

:: FilePath

target file

-> IO [String]

list of attribute names

listXAttr retrieves the list of attribute names associated with the given filepath.

lListXAttr :: FilePath -> IO [String]

fdListXAttr :: Fd -> IO [String]

Remove extended attributes

removeXAttr

Arguments

:: FilePath

target file

-> String

name of the attribute

-> IO ()

removeXAttr removes an extended attribute from the give filepath.

lRemoveXAttr :: FilePath -> String -> IO ()

fdRemoveXAttr :: Fd -> String -> IO ()