Skip to content

RFC Unionfs: Stackable Namespace Unification Filesystem

Josef Sipek linux-fsdevel lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 RFC Latest22 patches 52 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/22Unionfs: DocumentationDocumentation/filesystems/00-INDEX Documentation/filesystems/unionfs/00-INDEX Documentation/filesystems/unionfs/concepts.txt +2 more+153 -01 reply
2/22Unionfs: Kconfig and MakefileMAINTAINERS fs/Kconfig fs/Makefile +1 more+23 -02 replies
3/22Unionfs: Branch management functionalityfs/unionfs/branchman.c+92 -01 reply
4/22Unionfs: Common file operationsfs/unionfs/commonfops.c+575 -07 replies
5/22Unionfs: Copyup Functionalityfs/unionfs/copyup.c+662 -06 replies
6/22Unionfs: Dentry operationsfs/unionfs/dentry.c+236 -01 reply
7/22Unionfs: Directory file operationsfs/unionfs/dirfops.c+270 -01 reply
8/22Unionfs: Directory manipulation helper functionsfs/unionfs/dirhelper.c+268 -02 replies
9/22Unionfs: File operationsfs/unionfs/file.c+279 -02 replies
10/22Unionfs: Inode operationsfs/unionfs/inode.c+925 -01 reply
11/22Unionfs: Lookup helper functionsfs/unionfs/lookup.c+477 -01 reply
12/22Unionfs: Main module functionsfs/unionfs/main.c+685 -01 reply
13/22Unionfs: Readdir statefs/unionfs/rdstate.c+303 -01 reply
14/22Unionfs: Renamefs/unionfs/rename.c+480 -00 replies
15/22Unionfs: Privileged operations workqueuefs/unionfs/sioq.c fs/unionfs/sioq.h+193 -01 reply
16/22Unionfs: Handling of stale inodesfs/unionfs/stale_inode.c+116 -01 reply
17/22Unionfs: Miscellaneous helper functionsfs/unionfs/subr.c+179 -00 replies
18/22Unionfs: Superblock operationsfs/unionfs/super.c+352 -02 replies
19/22Unionfs: Helper macros/inlinesfs/unionfs/fanout.h+188 -01 reply
20/22Unionfs: Internal include filefs/unionfs/union.h+544 -01 reply
21/22Unionfs: Unlinkfs/unionfs/unlink.c+179 -00 replies
22/22Unionfs: Include fileinclude/linux/union_fs.h+20 -01 reply

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH 00/22][RFC] Unionfs: Stackable Namespace Unification Filesystem

This set of patches constitutes Unionfs version 2.0. We are presenting it to be reviewed and considered for inclusion into the kernel.

Unionfs is a stackable filesystem that is based off of the FiST stackable filesystem framework written by Erez Zadok: see <http://filesystems.org/>.

Josef Sipek presented Unionfs at the 2006 Ottawa Linux Symposiums; the high-level overview from this year's symposium starts on page 349 of the second half of the symposium proceedings: see

<http://www.linuxsymposium.org/2006/linuxsymposium_procv2.pdf>

Note that this set of patches contains a considerably trimmed-down version of Unionfs. That way it'd be possible to evaluate Unionfs's most basic functionality, gradually adding features in future patches.

To download tarballs of the full source, along with userspace utilities, read various documents and other info about Unionfs, see the home page at

<http://www.unionfs.org>

Josef "Jeff" Sipek, on behalf of the Unionfs team.

Index:
=======
[PATCH 01/22][RFC] Unionfs: Documentation
[PATCH 02/22][RFC] Unionfs: Kconfig and Makefile
[PATCH 03/22][RFC] Unionfs: Branch management functionality [PATCH 04/22][RFC] Unionfs: Common file operations [PATCH 05/22][RFC] Unionfs: Copyup Functionality
[PATCH 06/22][RFC] Unionfs: Dentry operations
[PATCH 07/22][RFC] Unionfs: Directory file operations [PATCH 08/22][RFC] Unionfs: Directory manipulation helper functions [PATCH 09/22][RFC] Unionfs: File operations
[PATCH 10/22][RFC] Unionfs: Inode operations
[PATCH 11/22][RFC] Unionfs: Lookup helper functions [PATCH 12/22][RFC] Unionfs: Main module functions
[PATCH 13/22][RFC] Unionfs: Readdir state
[PATCH 14/22][RFC] Unionfs: Rename
[PATCH 15/22][RFC] Unionfs: Privileged operations workqueue [PATCH 16/22][RFC] Unionfs: Handling of stale inodes [PATCH 17/22][RFC] Unionfs: Miscellaneous helper functions [PATCH 18/22][RFC] Unionfs: Superblock operations
[PATCH 19/22][RFC] Unionfs: Helper macros/inlines
[PATCH 20/22][RFC] Unionfs: Internal include file
[PATCH 21/22][RFC] Unionfs: Unlink
[PATCH 22/22][RFC] Unionfs: Include file

Known Issues and Limitations:

- The NFS server returns -EACCES for read-only exports, instead of -EROFS. This means we can't reliably detect a read-only NFS export.

- Modifying a Unionfs branch directly, while the union is mounted, is currently unsupported. Any such change may cause Unionfs to oops and it can even result in data loss!

- The PPC module loading algorithm has an O(N^2) loop, so it takes a while to load the Unionfs module, because we have lots of symbols.

- Unionfs shouldn't use lookup_one_len on the underlying fs as it confuses NFS.

For the initial release we removed support for xattrs, persistent inode mappings, and mmap operations.