1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
|
include(manual.h)dnl
HEADER(chirp_fuse)
SECTION(NAME)
BOLD(chirp_fuse) - create a CODE(FUSE) mount point with virtual access to remote chirp servers
SECTION(SYNOPSIS)
CODE(BOLD(chirp_fuse [options] PARAM(mount path)))
SECTION(DESCRIPTION)
PARA
You can attach to a Chirp filesystems by using the FUSE package to attach Chirp
as a kernel filesystem module. Unlike MANPAGE(parrot,1), this requires
superuser privileges to install the FUSE package, but will likely work more
reliably on a larger number of programs and environments. Using FUSE allows for
transparent access to a Chirp server via the local filesystem. This allows user
applications to use a Chirp store unmodified.
PARA
Once you have installed and permissions to use FUSE, simply run chirp_fuse with
the name of a directory on which the filesystem should be mounted.
PARA
For complete details with examples, see the
LINK(Chirp User's Manual,http://www.nd.edu/~ccl/software/manuals/chirp.html).
SECTION(OPTIONS)
OPTIONS_BEGIN
OPTION_PAIR(-a,flag)Require this authentication mode.
OPTION_PAIR(-b,bytes)Block size for network I/O. (default is 65536s)
OPTION_PAIR(-d,flag)Enable debugging for this subsystem.
OPTION_ITEM(-D)Disable small file optimizations such as recursive delete.
OPTION_ITEM(-f)Run in foreground for debugging.
OPTION_ITEM(-h)Give help information.
OPTION_PAIR(-m,option)Pass mount option to FUSE. Can be specified multiple times.
OPTION_PAIR(-o,file)Send debugging output to this file.
OPTION_PAIR(-t,timeout)Timeout for network operations. (default is 60s)
OPTION_ITEM(-v)Show program version.
OPTIONS_END
SECTION(ENVIRONMENT VARIABLES)
LIST_BEGIN
LIST_ITEM()CODE(BOLD(CHIRP_CLIENT_TICKETS)) Comma delimited list of tickets to authenticate with (same as CODE(-i)).
LIST_END
SECTION(EXIT STATUS)
On success, returns zero. On failure, returns non-zero.
SECTION(EXAMPLES)
To create and use a CODE(FUSE) mount point for access to remote chirp servers:
LONGCODE_BEGIN
% chirp_fuse /tmp/chirp-fuse &
% cd /tmp/chirp-fuse
% ls
% cd host:port
% cat foo/bar
% exit
LONGCODE_END
SECTION(COPYRIGHT)
COPYRIGHT_BOILERPLATE
SECTION(SEE ALSO)
SEE_ALSO_CHIRP
FOOTER
|