Clipland > Fuse-TagLayer > taglayer

Download:
Fuse-TagLayer-0.12.tar.gz

Annotate this POD

View/Report Bugs
Source  

NAME ^

taglayer - mounting script for Fuse::TagLayer

SYNOPSIS ^

  taglayer [options] <realdir> [<mountpoint>]

EXAMPLES ^

  taglayer /some/real/directory/with/tagged/files
  taglayer --no-tags-from-path --debug --debug /real/dir /real/dir/+tags

OPTIONS ^

--realdir, -r

Real directory hierarchy with all the files you want to mount, then layered with the virtual tag dirs. Required.

You can choose if you want to supply this as an option switch or as the first argument.

--mountpoint, -m

Location where to mount the TagLayer tag file-system. Defaults to <realdir>/+tags.

You can choose if you want to supply this as an option switch or as the second argument.

--no-tags-from-path

Ignore tags that could be parsed out from the real directory path of files.

Note that if you restrict TagLayer to parse out tags only from path (by adding --no-tags-from-xattr and not having --more-tags), files residing in the root will be left out as they are regarded as being "not tagged (by a dir)".

--no-tags-from-xattr

Ignore tags coming from the "user.tags" extended attribute.

--more-tags

Take filenames (basenames) into account to gather more tags. Does so by splitting on spaces, underscores (nonalpha-numeric), and in addition, offers files' suffixes (commonly called "file-extensions") as the special tag "zsuffix<extension>". But might clutter your tag-space with many tags that are effectively unsplittable filenames.

--ignore-numbers-only

Ignore tags/parsed-out-values that are all numbers (matching regex /^\d+$/).

--backend, -b

TagLayer allows to switch the underlying storage backend. The default is a SQLite database in memory. If you want to use a pure Perl version instead, pass the string 'PurePerl' via this option.

--debug, -D

Switch on debugging output. Incremental. You can repeat this option up to three times. 1x means debug output from Fuse::TagLayer, 2x means more verbose output from TagLayer and backends. 3x is even more verbose and adds the debug messages from Fuse.

--help, -h

Output this help text.

Please note that this script currently blocks (will remain in the foreground) until the mount is unmounted with sudo umount <mountpoint>.

KNOWN ISSUES ^

Please refer to the library module Fuse::TagLayer for known issues.

SEE ALSO ^

More information about what this mounting script does can be found in the documentation of the backend module Fuse::TagLayer.

AUTHOR ^

Clipland GmbH http://www.clipland.com/

COPYRIGHT & LICENSE ^

Copyright 2012-2013 Clipland GmbH. All rights reserved.

This library is free software, dual-licensed under GPLv3/AL2. You can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: