Install afsd.fuse and man page if built
authorRuss Allbery <rra@stanford.edu>
Tue, 20 Apr 2010 04:18:57 +0000 (21:18 -0700)
committerDerrick Brashear <shadow@dementia.org>
Wed, 21 Apr 2010 12:59:05 +0000 (05:59 -0700)
If --enable-fuse-client is passed to configure and afsd.fuse is built,
install it into the same directory as afsd and install afsd.fuse.8 as a
symlink to the afsd.8 man page.  Add documentation of afsd.fuse to the
afsd man page.

Change-Id: I7d0cd3992a8466e626af2191c713e5623cc40d84
Reviewed-on: http://gerrit.openafs.org/1792
Tested-by: Russ Allbery <rra@stanford.edu>
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>

doc/man-pages/Makefile.in
doc/man-pages/pod8/afsd.pod
src/afsd/Makefile.in

index 44cae7f..7ea3e3b 100644 (file)
@@ -33,7 +33,10 @@ dest:
            test -h $(DEST)/man/man1/$$M.krb.1 \
                || ln -s $$M.1 $(DEST)/man/man1/$$M.krb.1 ; \
        done
-
+       set -e; if [ -n "@ENABLE_FUSE_CLIENT@" ] ; then \
+           test -h $(DEST)/man/man8/afsd.fuse.8 \
+               || ln -s afsd.8 $(DEST)/man/man8/afsd.fuse.8; \
+       fi
 
 install: $(MAN1) $(MAN8)
        chmod +x install-man
@@ -52,3 +55,7 @@ install: $(MAN1) $(MAN8)
            test -h $(DESTDIR)$(mandir)/man1/$$M.krb.1 \
                || ln -s $$M.1 $(DESTDIR)$(mandir)/man1/$$M.krb.1 ; \
        done
+       set -e; if [ -n "@ENABLE_FUSE_CLIENT@" ] ; then \
+           test -h $(DESTDIR)$(mandir)/man8/afsd.fuse.8 \
+               || ln -s afsd.8 $(DESTDIR)$(mandir)/man8/afsd.fuse.8; \
+       fi
index bacfd7f..22aa84e 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-afsd - Initializes the Cache Manager and starts related daemons
+afsd, afsd.fuse - Initializes the Cache Manager and starts related daemons
 
 =head1 SYNOPSIS
 
@@ -41,8 +41,11 @@ B<afsd> [B<-afsdb>] [B<-backuptree>]
 
 The B<afsd> command initializes the Cache Manager on an AFS client machine
 by transferring AFS-related configuration information into kernel memory
-and starting several daemons. More specifically, the B<afsd> command
-performs the following actions:
+and starting several daemons. B<afsd.fuse> is an experimental variant that
+inititalizes a FUSE-based Cache Manager instead of one based on a kernel
+module.
+
+The B<afsd> command performs the following actions:
 
 =over 4
 
@@ -349,6 +352,13 @@ If neither argument is used, there are five VM daemons.
 
 =back
 
+B<afsd.fuse> is a variant of B<afsd> that, instead of initializing a Cache
+Manager implemented as a kernel module, initializes a FUSE-based AFS
+client.  FUSE (Filesystem in USErspace) is a Linux-only mechanism for
+providing a file system through a purely user-space daemon without a
+kernel module component.  B<afsd.fuse> takes all of the same options as
+B<afsd>.
+
 This command does not use the syntax conventions of the AFS command
 suites. Provide the command name and all option names in full.
 
@@ -391,6 +401,10 @@ suffice depending on the number of simultaneous B<klog>s).
 Be sure to set the UDP timeouts on the firewall to be at least twenty
 minutes for the best callback performance.
 
+B<afsd.fuse> was first introduced in OpenAFS 1.5.74.  It is only available
+if OpenAFS was built with the C<--enable-fuse-client> configure switch.
+It should be considered experimental.
+
 =head1 OPTIONS
 
 =over 4
index 7511cfa..5079477 100644 (file)
@@ -59,16 +59,22 @@ clean:
 system: install
 
 # XXX-INST: where to put the rc scripts?
-install: afsd vsys
+install: afsd vsys @ENABLE_FUSE_CLIENT@
        ${INSTALL} -d ${DESTDIR}${sbindir}
        ${INSTALL} afsd ${DESTDIR}${sbindir}/afsd
        ${INSTALL} vsys ${DESTDIR}${sbindir}/vsys
+       set -e; if [ -n "@ENABLE_FUSE_CLIENT@" ] ; then \
+           ${INSTALL} afsd.fuse ${DESTDIR}${sbindir}/afsd.fuse; \
+       fi
 
-dest: afsd vsys
+dest: afsd vsys @ENABLE_FUSE_CLIENT@
        ${INSTALL} -d ${DEST}/root.client/usr/vice/etc
        ${INSTALL} -d ${DEST}/etc
        ${INSTALL} afsd ${DEST}/root.client/usr/vice/etc/afsd
        ${INSTALL} vsys ${DEST}/etc/vsys
+       set -e; if [ -n "@ENABLE_FUSE_CLIENT@" ] ; then \
+           ${INSTALL} afsd.fuse ${DEST}/root.client/usr/vice/etc/afsd.fuse; \
+       fi
        case ${SYS_NAME} in \
                rs_aix*)  \
                        ${INSTALL} -d ${DEST}/root.client/usr/vice/etc/dkload ; \