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


-- | Read, set and list extended attributes
--   
--   Bindings to the Linux syscalls for reading and manipulating extended
--   attributes (<tt>setxattr</tt>, <tt>getxattr</tt>, <tt>listxattr</tt>,
--   ...).
@package linux-xattr
@version 0.1.0.1


-- | <tt>linux-xattr</tt> provides bindings to the Linux syscalls for
--   reading and manipulating extended attributes (<tt>setxattr</tt>,
--   <tt>getxattr</tt>, <tt>listxattr</tt>, ...). Each function in this
--   module has two variants: one with the name prefixed by "l" and one
--   prefixed by "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 ()