beaglefs(1)
NAME
beaglefs - mount a filesystem representing a beagle query
SYNOPSIS
beaglefs query mountpoint [options]
DESCRIPTION
beaglefs (it would be tomfs but Joey hates the name Tom) implements a
filesystem representing a live Beagle query. The filesystem represents
query hit results as symlinks to the hit targets.
In addition, beaglefs provides the following features:
- * Live updating
- The filesystem is updated on-the-fly as hits come and go.
- * Extended Attributes
- Beagle hit metadata is exported as extended attributes in the system.B eagle.* namespace.
- * Constant time operations
- The backing data structure is a hash table, providing O(1) best-case complexity for many operations.
OPTIONS
- general options:
- -o opt,[opt...]
mount options
- -h --help
print help
- -V --version
print version
- FUSE options:
- -d -o debug
enable debug output (implies -f)
- -f foreground operation
- -s disable multi-threaded operation
- -o allow_other
allow access to other users
- -o allow_root
allow access to root
- -o nonempty
allow mounts over non-empty file/dir
- -o default_permissions enable permission checking by kernel
- -o fsname=NAME
set filesystem name
- -o large_read
issue large read requests (2.4 only)
- -o max_read=N
set maximum size of read requests
- -o hard_remove
immediate removal (don't hide files)
- -o use_ino
let filesystem set inode numbers
- -o readdir_ino
try to fill in d_ino in readdir
- -o direct_io
use direct I/O
- -o kernel_cache
cache files in kernel
- -o umask=M
set file permissions (octal)
- -o uid=N
set file owner
- -o gid=N
set file group
- -o entry_timeout=T
cache timeout for names (1.0s)
- -o negative_timeout=T
cache timeout for deleted names (0.0s)
- -o attr_timeout=T
cache timeout for attributes (1.0s)
EXAMPLES
- To mount a beagle query (search the string "Joey Shaw") :
- $ beaglefs "Joey Shaw" /home/rlove/joey
- Then you can play a little bit :
$ ls -la /home/rlove/joey
$ getfattr -m "." -h -d /home/rlove/joey/joeys_cat.jpg
$ stat /home/rlove/joey/joeys_cat.jpg
$ stat -f /home/rlove/joey- To unmount a previsously mounted point :
$ fusermount -u /home/rlove/joey- Alternatively, you can use /etc/fstab to declare a mountpoint: #sample line to be added to /etc/fstab:
- beaglefs#Joey /home/fpiat/Wissant fuse user 0
LIMITATIONS
Currently, the query is defined at mount time.
Supported file operations: readdir, readlink, getxattr, listxattr,
stat, and statfs.
AUTHORS
This manpage was originally written by Franklin PIAT <fpiat@bigfoot.com> for the Debian distribution of beaglefs.
The main author of beaglefs is Robert Love <rml@novell.com>.