Various changes to tests and Makefile.

Merged all loopback scripts into a single variant; now threads are
enabled by passing --use-threads to loopback.pl instead of having a
separate script variant, and use of Filesys::Statvfs instead of
bogus filler statfs() data is enabled with --use-real-statfs. Also,
loopback now fork()s itself away into a daemon, rather than depending
on external infrastructure to do it; --pidfile can be passed to create
a PID file.

Altered test/helper.pm and test/s/mount.t to use new loopback.pl semantics.

Altered test/statfs.t to optionally use Filesys::Statvfs's statvfs()
instead of raw syscalls and pack masks, if the option is available
to us. If not available, it will try to use syscalls instead.

Cleanups to Makefile to put different options where they belong,
rather than e.g., abusing the 'OBJECT' list to specify libraries
and such. Works with all platforms.

Updates to README and MANIFEST.

Make the code work without USE_ITHREADS. FreeBSD's default Perl build
doesn't enable threads (it can be enabled), so let's try to be a bit
more accepting.

Merge branch 'master' of github.com:dpavlin/perl-fuse

NetBSD 5.1, not 5.0.

NetBSD 5.1, not 5.0.

Updates to README.

Small pack mask change for 32-bit Linux compatibility.

Changes to statfs.t to work better with 32-bit versions of NetBSD.

Multiple changes for better *BSD compatibility, including:

- For OS X/Darwin, use alternate function argument lists that add an
  extra parameter for the setxattr() and getxattr() call wrappers. This
  eliminates some compile-time warnings, and makes sure the call stack
  isn't getting unbalanced when those calls are made.
- For OS X/Darwin, force the use of -lfuse_ino64 on OS X 10.6 (Snow
  Leopard); FUSE filesystems won't work at all otherwise due to changes
  in the inode structure definition, and the pkgconfig files don't check
  for this.
- For OS X/Darwin, don't set the PERL_DL_NONLAZY=1 environment variable
  during "make test"; MacFuse builds their libfuse with a reference to
  _iconv, but doesn't link in -liconv at build time, and due to
  differences in their dynamic linker, linking -liconv into our library
  doesn't get that symbol into its namespace, so tests fail completely
  on OS X due to the unsatisfied link symbol when RTLD_NOW is passed to
  dlopen().
- Enabled alternate mknod handling for NetBSD and OS X/Darwin in
  addition to FreeBSD in the example code.
- Synchronized all changes (except enabling threading) from
  examples/loopback_t.pl to examples/loopback.pl.
- Reenabled threading use for OS X/Darwin in tests; testing on my
  MacBook running OS X 10.6.7 always passes with it enabled (though
  does not with threading disabled, which probably needs some
  diagnosing).
- In the mknod() test, use a different major number shift value (24
  instead of 8) for OS X/Darwin.
- In the statfs() test, use sys/syscall.ph instead of syscall.ph (works
  on Linux and all *BSDs, though NetBSD and OS X/Darwin perls don't h2ph
  the system headers at install time).
- In the statfs() test, altered the Linux pack mask for the statfs()
  syscall, added masks for FreeBSD and OS X/Darwin, and added statvfs1()
  call semantics for NetBSD, so this test will work on all supported
  platforms (though the FreeBSD pack mask may not work on non-64bit
  FreeBSDs, need to test that).
- In the statfs() test, ignore f_namelen field for NetBSD and
  OS X/Darwin. OS X/Darwin doesn't even have such a field, and NetBSD
  seems to not handle it right for PUFFS filesystems.
- In the symlink() test, use 'cp -R' on NetBSD instead of 'cp -a', since
  NetBSD's 'cp' doesn't know the '-a' option.

Circumvent buggy negation of assigned $!.

Loopback fs fails to create a new file every other time on FreeBSD.
This happens because of a Perl bug which occurs when $! is set from Perl
(as in x_mknod()), and then negated after a failed syscall (as in
x_getattr()). See http://www.perlmonks.org/?node_id=906466.

Handle pipe creation in mknod() on FreeBSD.

Additional special case is introduced in mknod() callback for the test
loopback fs. Pipes on FreeBSD are created through POSIX::mkfifo,
although they could be created by "mkfifo" command or syscall.  In the
"test/mknod.t", initial named pipe is now created by executing "mkfifo".

Merge pull request #7 from ALPHA-60/master

FreeBSD fixes

When testing, check if '/proc/mounts' exists. (by Bojan Petrovic)

On FreeBSD, even if procfs is mounted under '/proc', there is no
'/proc/mounts' file.  Instead on relying on the existence of '/proc'
directory, we check if the '/proc/mounts' file exists. Otherwise, tests
cannot even start on FreeBSD.

Merge remote-tracking branch 'dpavlin/master'

Conflicts:
Fuse.xs

Handle mknod() differently when running FreeBSD, as its mknod syscall doesn't
create plain files at all.

For FreeBSD and NetBSD, define XATTR_{CREATE,REPLACE}, since there is no
<sys/xattr.h> for us to use to reference the values.

When testing, check if '/proc/mounts' exists.

On FreeBSD, even if procfs is mounted under '/proc', there is no
'/proc/mounts' file.  Instead on relying on the existence of '/proc'
directory, we check if the '/proc/mounts' file exists. Otherwise, tests
cannot even start on FreeBSD.

Do not include 'xattr.h' on FreeBSD.

The build will break if this file is included, or if XATTR_CREATE
and XATTR_REPLACE constants are used.

document changes for version 0.12

Check that the option string is not an empty string. If it is, don't add
"-o" and an empty mountopts to the argument list.

Screwed up parentheses balance with last commit. Oops. Fixed.

Found an error message that was using the old offset value; fixed to
use the new, correct one.

Make sure the first element in the args list is an empty string always;
didn't think about the fact that if no "mountopts" is given, but "debug"
is true, there won't be one.

Update the readdir example to use the new syntax, so it'll actually work.

Remove inclusion of Data::Dumper. Remove incorrect duplicate documentation
for readdir().

Move XATTR_{CREATE,REPLACE} into the XS code, so we can get the
definitions of the constants from sys/xattr.h instead of setting them
to arbitrary platform-specific constant values.

Remove a couple of unnecessary '#if FUSE_VERSION >= 24' blocks in the
_PLfuse_create implementation. If the create() wrapper is supported
(as of FUSE 2.5), we know those lines necessarily have to work, so
the conditional is pointless.

Align groups of hv_{fetch,store} calls. Compare to NULL, instead of assuming
NULL is 0 (most arches it is, but it's not necessary a universal constant).
Also make the hash building code in _PLfuse_create() consistent with
the code in _PLfuse_open().

Assorted minor cleanups. Restore 'symlink' fops member. Better handle
NULL file arguments for functions that can operate on file/directory
handles.

Add return checking to several asprintf()s used for non 64-bit
architectures. Also, abbreviate several unnecessary 4-line 'if (rv) ...'
blocks to a single line with a ternary operator, as it's cleaner and
(IMO) easier to read.

Void cast some hv_store calls to get rid of warnings.

Export the 'private_data' member of the fuse_context struct as
'private', if any is set (via the init() function). Also, export the
'umask' member if built against FUSE 2.8 or later.

Implement additional FUSE operations.

Implement all of the following:
 - opendir
 - releasedir
 - fsyncdir
 - init
 - destroy
 - access
 - create
 - ftruncate
 - fgetattr
 - lock
 - utimens
 - bmap

Also replace the deficient readdir() operation with my own, which
allows for significantly greater efficiency, and supports directory
handles (as can be returned from opendir()). Also also, instead of
using static initialization of fields to zero out the fops structure,
call memset() in the INIT block of perl_fuse_main().

Fold margs and fargs together into args; this fixes the handling of
the '-o big_writes' mount option, which previously did not work
at all.

Handle getdir entries in order passed. Currently they are handed to the
filler call in reverse order; this is kind of a pain in the butt.

Added support for 'nullpath_ok' option to fuse_main().

Add the fuse_version() static method. This is the basis of version
checking required for later changes.

a couple more file handle bugfixes

-only run mg_find for SV's of type SVt_PVMG per "if the SV is not of type SVt_PVMG, Perl may core dump." under Finding Magic in perlguts
-hv_store_ent returns NULL when storing an SV to an HV with tie magic, such as when the HV is utilizing threads::shared

a couple file handle bugfixes

-make sure to adjust the refcount when storing a file handle
-use the set/get magic macros instead of the underlying functions

flags are the 3rd parameter, not the 4th for hv_delete_ent

cleanup example

document readdir

close RT #55953 - readdir

Merge branch 'frett-readdir'

added build files to the .gitignore file

Merge branch 'rt-55953-readdir' into master

Conflicts:
AUTHORS
Fuse.xs

RT#55953 added readdir implementation

reduce code duplication in the CLONE method and make sure to dup the handles object when CLONEing

fixed thread cloning in <= perl5.10.0

the pointer table used in cloning was destroyed before calling CLONE methods in <= perl5.10.0

remove usage of MUTABLE_SV and MUTABLE_HV for older versions of perl

make open file handles thread-safe. Fixes RT #57517 when using threads.

not having a supported threads model shouldn't be fatal, fallback to non-threaded mode instead

need to define the context when not building threaded model

document Daniel Frett tread-safe callback contribution and bump version to 0.11

credit Derrik with 64-bit changes

updated Fuse binding to utilize thread-safe static data

This fixes RT #34284

document changes in 0.10_1

bump version to 0.10_1

Merge remote branch 'remotes/origin/64-bit'

64-bit support, 2.6 binding

I am (somewhat indirectly, now) using the Fuse package, which you maintain,
as the basis for a set of Perl modules I've written to mount AFP filesystems
via Fuse. I actually have made a few changes to the copy I run, to address
the following issues:

- On NetBSD, the Fuse package won't build out of the box against NetBSD's
ReFUSE implementation; I have a few changes that make it work (all except
extended attributes, which apparently PUFFS/ReFUSE doesn't yet handle).
- On FreeBSD and NetBSD, the version 2.6 binding profile works better, so
I've altered the code slightly to use it; it works on Linux and OS X as
well.
- On most 32-bit Linux distributions (and NetBSD/FreeBSD), Perl is not built
with 64-bit integer support, thus breaking access to large files (> 2 ** 31
- 1 bytes long). I've added a sort-of-hackish workaround for Perl builds
without $Config{'use64bitint'} to get large files handled sanely.
- Added a few extra option names that aren't included in the @validOpts list
by default.

If you're interested in my code, check out
http://svn.now.ai/listing.php?repname=afp-perl to see the repository, or
http://svn.now.ai/svn/afp-perl/ for SVN checkout access.

--
Derrik Pates
demon@now.ai

fix permissions

there are plenty, some os specific, valid opts, so just don't bother checking for them

bump version [0.09_4] and document it

Merge branch 'rt-57517-file-handles'

Addition of file handles on open files

Sat May 15 16:36:47 2010: Request 57517 was acted upon.
Transaction: Ticket created by gerph
       Queue: Fuse
     Subject: Addition of file handles on open files
   Broken in: 0.09_3
    Severity: (no value)
       Owner: Nobody
  Requestors: gerph@gerph.org
      Status: new
 Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=57517 >

Hiya,

Whilst trying to write a filesystem using the Fuse module, I found it
surprising that there were no 'file handles' available when you opened
a file. The only way you can know what file was referenced is by its
name, which is not useful if your filesystem is intended to return
different results for each file opened. It turned out in my case to not
matter, but consider a FS which returned a different story every time
you opened it. Or, more practically, a FS which returned the contents
of the latest checked in file - and whilst you were operating on the
file the latest checked in file changed. There are ways around this -
files becoming invariant whilst it has any open instances of itself or
similar - but these are not ideal.

The way that Fuse appears to do this is that the filesystem updates a
property ('fh') in the fuse_file_info structure on open, to contain the
context for the opened file. I've put together a change which allows
you to return a second parameter from open containing this value, which
is then passed to all the functions which operate on open files (read,
write, flush, release). Because we're retaining a reference to the SV
that was returned (and is otherwise unused in the perl) we also
increment the refcount on open, and decrement it on release - I think
that's all that's necessary to prevent a leak, but I've never done any
XS work before this so I can't be certain.

I'd expect that under normal circumstances you'd open a file, set up a
hashref containing properties for the file that you've opened and use
'return (0, $handle);' to return it. If you don't return a handle, the
old behaviour remains - undef will be passed to the implementation in
place of the handle (which the implementation wasn't expecting so won't
care about).

In addition, I've also added the ability to set the 'direct_io',
'keepcache' and 'nonseekable' properties by changing a hashref which is
passed to the 'open' call.

The archive I've attached contains the Fuse.pm and Fuse.xs files in
their entirity, together with the diffs from 0.09_3. There is also a
rudimentary example FS, based on the example one in the Fuse
distribution, which shows the file handle to be working. It seems to be
working in my more complex MythTV filesystem that I'm still trying to
make useful.

I couldn't actually test the nonseekable property as the fuse I have
seems to be 2.4, so I don't have that property available to me here -
I've just followed what the documentation says should be available.

I've not added anything to the tests, because I'm not sure how to do
that really, but I hope that the change to add the file handles is
useful.

remove version number

Merge branch 'master' of github.com:dpavlin/perl-fuse

added META pointers to repository and bugtracker

added META pointers to repository and bugracker

documentation fix

another try to fix files larger than 2Gb: for this we pop
float from stack since long is limited to 4Gb

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@123 6e4b0b00-1209-0410-87b2-b275959b5705

cpan target to push latest verison out

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@122 6e4b0b00-1209-0410-87b2-b275959b5705

update latest Changes

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@121 6e4b0b00-1209-0410-87b2-b275959b5705

version bump [0.09_2]

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@120 6e4b0b00-1209-0410-87b2-b275959b5705

expose and fix 2Gb file bug, RT #32639, RT #33903

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@119 6e4b0b00-1209-0410-87b2-b275959b5705

fuse_get_context documentation patch from jaslong

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@118 6e4b0b00-1209-0410-87b2-b275959b5705

update from Reuben Thomas: fixes a bug in mkdir (failed to tag, so newly
created dir was not visible in the filtered fs), and makes error reporting a
little better (if tag routine returns an error, that is propagated).

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@117 6e4b0b00-1209-0410-87b2-b275959b5705

Added contributed filesystem described in e-mail message below:

From: Reuben Thomas <rrt@sc3d.org>
To: dpavlin@rot13.org
Subject: Contribution of sample FS to Fuse

Hi,

I'm just putting the finishing touches to an FS I wrote with Fuse, which
was invaluable, as I couldn't contemplate writing it in C (it's just not
important enough for that much pain!).

I've called it filter_attr_t.pl. It is just loopback_t.pl, augmented with a
function and a little logic so that only files that possess extended
attribute given at mount time are visible. Further, if you try to write to
a file that exists but is not tagged (and hence invisible), you get
-EEXIST, and if you try to unlink a tagged file, it is merely untagged
rather than actually unlinked.

My use for this is to use the backup program Unison, which synchronises two
directory trees, to synch my PDA and my home directory, while excluding
most of the files in my home dir (which would simply not fit in my PDA's
16Mb of file space!). I was amazed to find I couldn't see a FUSE fs which
would do this already, and I was nearly in despair when I remembered Fuse,
and, sure enough, it looked a lot easier than writing a FUSE fs in C.

Of course, the example code was also invaluable, as without it I would have
taken much longer to write the code, and I wouldn't have known some of the
traps.

So, a big thank you, and I attach the current version.

--
http://rrt.sc3d.org/ | Slow Pedestrian Crossing (Anon)

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@116 6e4b0b00-1209-0410-87b2-b275959b5705

added Chris, bump version to 0.09

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@113 6e4b0b00-1209-0410-87b2-b275959b5705

patch from Chris Dolan via rt.cpan.org #30631

This patch gets Fuse.pm to half-work on MacOSX with the current release
of MacFuse (v1.1.0).  By half-work, I mean that all of the directory
actions and file read actions work, but anything that involves writing a
file fails.  This appears to be because the latest MacFUSE implements
FUSE 2.6, which prefers to call CREATE instead of MKNOD.  Nonetheless,
recommend that something like this patch be included because it makes
read-only filesystems usable on Darwin systems.  Some of my changes
(like kill() instead of system("kill")) are improvements on any system.
    I've tested only on my PowerPC G5 iMac running 10.4.

I intend to also try MacFUSE v0.4 via Fink, but that version is
reportedly less stable than the latest MacFUSE.

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@112 6e4b0b00-1209-0410-87b2-b275959b5705

calls mount instread of cat /proc/mountpoints to make it less Linux specific

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@111 6e4b0b00-1209-0410-87b2-b275959b5705

one more define (_FILE_OFFSET_BITS=64) on darwin

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@110 6e4b0b00-1209-0410-87b2-b275959b5705

support for MacFUSE implementation for Mac OS X from code.google.com/p/macfuse/

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@109 6e4b0b00-1209-0410-87b2-b275959b5705

Changes from Marc to implement fuse_get_context():
* an XS function to get the data
* a mention of it in Fuse.pm so it can be exported properly
* a pretty ugly hack to example.pl, which is how I tested it.

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@108 6e4b0b00-1209-0410-87b2-b275959b5705

fixes for Andrew for dh-make-perl which uses fakeroot

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@107 6e4b0b00-1209-0410-87b2-b275959b5705

bump version to 0.08, added Changes for this version

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@106 6e4b0b00-1209-0410-87b2-b275959b5705

fix to test helper as proposed by ANDREWC@cpan.org (rt.cpan.org #17695)

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@105 6e4b0b00-1209-0410-87b2-b275959b5705

warn about required permissions also

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@104 6e4b0b00-1209-0410-87b2-b275959b5705

make CPANPLUS happy and don't report errors if fuse isn't installed

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@103 6e4b0b00-1209-0410-87b2-b275959b5705

fix path to local svn

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@102 6e4b0b00-1209-0410-87b2-b275959b5705

patch from Mark Glines to allow Fuse to be run from a non-master thread

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@101 6e4b0b00-1209-0410-87b2-b275959b5705

changes from Nick Waterman <laptop@noseynick.com> to fix race condition in
test/s/mount.t

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@100 6e4b0b00-1209-0410-87b2-b275959b5705

CPAN release 0.07

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@95 6e4b0b00-1209-0410-87b2-b275959b5705

use mount_fusefs on FreeBSD to get fuse version

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@94 6e4b0b00-1209-0410-87b2-b275959b5705

Fix ISO C90 warnings

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@93 6e4b0b00-1209-0410-87b2-b275959b5705

Mark Glines fixed problem with newer fuse versions

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@92 6e4b0b00-1209-0410-87b2-b275959b5705

bump version

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@91 6e4b0b00-1209-0410-87b2-b275959b5705

added nonempty as suggested by David Danier <david.danier@team23.de>

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@90 6e4b0b00-1209-0410-87b2-b275959b5705

Vladimir V. Kolpakov contributed cleanup patch

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@89 6e4b0b00-1209-0410-87b2-b275959b5705

whitespace fixes

git-svn-id: svn+ssh://llin/home/dpavlin/private/svn/fuse/perl-llin@88 6e4b0b00-1209-0410-87b2-b275959b5705