README.dev

tagfs - tag file system
developer readme

1) Logging
2) Profiling
3) Tracing
4) Distribution
4.1) tar Distribution

---------------------------------------------------------------------
Logging

You can enable logging by setting a debug environment variable before you
launch tagfs:
$ export DEBUG=1

tagfs will log to the console and the file /tmp/tagfs.log

---------------------------------------------------------------------
Profiling

You can enable profiling by setting a profile environment variable before you
launch tagfs:
$ export PROFILE=1

After unmounting your tagfs file system a profile file will be written. The
profile file will be written to the current directory. The profile file will
be named 'tagfs.profile'.

---------------------------------------------------------------------
Tracing

Tracing is done via the log output. There is a utility script to analyze the
log files. To analyze a log file execute the following

$ util/trace_logfiles.py /tmp/tagfs.log

The tracing script will output some statistics.

---------------------------------------------------------------------
tar Distribution

The tagfs project contains scripts for creating source distribution packages.
To create a tar distribution package you execute the following:

$ make distsnapshot

The make call will create an archive within the target directory. The created
tar file is used for tagfs source distribution.