use larger string heap
[rrq/fuse_xattrs.git] / README.md
index e2ee57e0589394dcd08f0c902434d022d14abbb5..7082cb3c3339e410de8cf5c7ebd8182f6de217c8 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,50 +1,40 @@
-[![Build Status](https://travis-ci.org/fbarriga/fuse_xattrs.svg?branch=travis)](https://travis-ci.org/fbarriga/fuse_xattrs)
+# fuse_xattrs
 
-## Abstract
+This is a fuse filesystem that provides extended attribute (xattr)
+support over some other filesystem by using "sidecar files", i.e.
+separate files that hold the extended attributes only, named by the
+same pathname as the attributed file or directory with an additional
+extension ".xattr".
 
-This filesystem provides xattr support using sidecar files.
-
-## Latest version
-
-The latest version and more information can be found on
+This software originated as version 0.4 of
 http://github.com/fbarriga/fuse_xattrs
-
+at 2021-11-11.
 
 ## How to mount a filesystem
 
 Once fuse_xattrs is installed (see next section) running it is very simple:
 
-    fuse_xattrs mountpoint
+    fuse_xattrs source_directory mountpoint
 
 To unmount the filesystem:
 
     fusermount -u mountpoint
 
-
 ## Building
 
-First you need to download FUSE 2.9 or later from
-http://github.com/libfuse/libfuse.
-
-    mkdir build && cd build
-    cmake ..
-    make
-
-## Code Coverage
+libfuse-dev
+libacl1-dev
+libattr1-dev
 
-    mkdir build && cd build
-    cmake -DENABLE_CODECOVERAGE=1 -DCMAKE_C_COMPILER=/usr/bin/gcc -DCMAKE_BUILD_TYPE=Debug ..
-    make
-    make fuse_xattrs_coverage
+    $ mkdir build
+    $ cd build
+    build$ cmake ..
+    build$ make
 
-## Installing
+attr
 
-    make install
+Dependencies:
 
-## Links
+    cmake
+    osxfuse (macOS only)
 
-- http://man7.org/linux/man-pages/man2/setxattr.2.html
-- http://man7.org/linux/man-pages/man2/listxattr.2.html
-- http://man7.org/linux/man-pages/man2/getxattr.2.html
-- http://man7.org/linux/man-pages/man3/errno.3.html
-- https://www.freedesktop.org/wiki/CommonExtendedAttributes/