-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Read, set and list extended attributes
--   
--   XAttr provides bindings to the glibc functions for reading and
--   manipulating extended attributes (<tt>setxattr</tt>,
--   <tt>getxattr</tt>, <tt>listxattr</tt>, ...).
@package linux-xattr
@version 0.1.0.0


-- | XAttr provides bindings to the glibc functions for reading and
--   manipulating extended attributes (<tt>setxattr</tt>,
--   <tt>getxattr</tt>, <tt>listxattr</tt>, ...). 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 <tt><a>FilePath</a></tt>.
module System.Linux.XAttr

-- | Set the value of an extended attribute.
setXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Set the value of an extended attribute (do not follow symbolic links).
lSetXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Set the value of an extended attribute.
fdSetXAttr :: Fd -> String -> ByteString -> IO ()

-- | Identical to <tt><a>setXAttr</a></tt>, but if the attribute already
--   exists fail and set errno to EEXIST.
createXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Identical to <tt><a>lSetXAttr</a></tt>, but if the attribute already
--   exists fail and set errno to EEXIST.
lCreateXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Identical to <tt><a>fdSetXAttr</a></tt>, but if the attribute already
--   exists fail and set errno to EEXIST.
fdCreateXAttr :: Fd -> String -> ByteString -> IO ()

-- | Identical to <tt><a>setXAttr</a></tt>, but if the attribute does not
--   exist fail and set errno to ENOATTR.
replaceXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Identical to <tt><a>lSetXAttr</a></tt>, but if the attribute does not
--   exist fail and set errno to ENOATTR.
lReplaceXAttr :: FilePath -> String -> ByteString -> IO ()

-- | Identical to <tt><a>fdSetXAttr</a></tt>, but if the attribute does not
--   exist fail and set errno to ENOATTR.
fdReplaceXAttr :: Fd -> String -> ByteString -> IO ()

-- | Get the value of an extended attribute.
getXAttr :: FilePath -> String -> IO (ByteString)

-- | Get the value of an extended attribute (do not follow symbolic links).
lGetXAttr :: FilePath -> String -> IO (ByteString)

-- | Get the value of an extended attribute.
fdGetXAttr :: Fd -> String -> IO (ByteString)

-- | Get the list of attribute names associated with the given
--   <tt><a>FilePath</a></tt>.
listXAttr :: FilePath -> IO ([String])

-- | Get the list of attribute names associated with the given
--   <tt><a>FilePath</a></tt> (do not follow symbolic links).
lListXAttr :: FilePath -> IO ([String])

-- | Get the list of attribute names associated with the given file
--   descriptor.
fdListXAttr :: Fd -> IO ([String])

-- | Remove an extended attribute from the given <tt><a>FilePath</a></tt>.
removeXAttr :: FilePath -> String -> IO ()

-- | Remove an extended attribute from the given <tt><a>FilePath</a></tt>
--   (do not follow symbolic links).
lRemoveXAttr :: FilePath -> String -> IO ()

-- | Remove an extended attribute from the given file descriptor.
fdRemoveXAttr :: Fd -> String -> IO ()