CVS commit: src/share/examples/refuse/virtdir

["Alistair G. Crooks" <agc%netbsd.org@localhost>]

Module Name:    src
Committed By:   agc
Date:           Sun Apr 15 15:10:57 UTC 2007

Added Files:
        src/share/examples/refuse/virtdir: Makefile defs.h virtdir.3 virtdir.c
            virtdir.h

Log Message:
Add routines to manipulate virtual directory entries, for use with
librefuse-based file systems.

These are especially useful for file systems which present virtual
directory hierarchies to the caller.

The routines build up and manage an array of virtual directory
entries, indexed upon full pathname within the file system.  This is
analogous to the way refuse indexes its own entries.  Routines are
available to add, delete, and find entries.  Each entry can be one of
3 types - file ('f'), directory ('d') or symbolic link ('l').  Each
entry can also be associated with a target, which is a character
string allocated upon addition.  This can be useful for virtual
directory entries of the symbolic link type.

The virtual directory entries can be traversed as an ordered list
(the entries are ordered alphabetically), or can be accessed by
directory component, using routines analogous to opendir(3), readdir(3),
and closedir(3).


To generate a diff of this commit:
cvs rdiff -r0 -r1.1 src/share/examples/refuse/virtdir/Makefile \
    src/share/examples/refuse/virtdir/defs.h \
    src/share/examples/refuse/virtdir/virtdir.3 \
    src/share/examples/refuse/virtdir/virtdir.c \
    src/share/examples/refuse/virtdir/virtdir.h

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.