From e109cc54127c3175cd1f41f21ae74c63fe460cae Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Thu, 22 Mar 2012 23:15:58 +0100 Subject: docs: add a vfs_tsmsm manpage Autobuild-User: Michael Adam Autobuild-Date: Sat Apr 14 01:54:13 CEST 2012 on sn-devel-104 --- docs-xml/manpages-3/vfs_tsmsm.8.xml | 135 ++++++++++++++++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 docs-xml/manpages-3/vfs_tsmsm.8.xml (limited to 'docs-xml/manpages-3') diff --git a/docs-xml/manpages-3/vfs_tsmsm.8.xml b/docs-xml/manpages-3/vfs_tsmsm.8.xml new file mode 100644 index 0000000000..eac17d31eb --- /dev/null +++ b/docs-xml/manpages-3/vfs_tsmsm.8.xml @@ -0,0 +1,135 @@ + + + + + + vfs_tsmsm + 8 + Samba + System Administration tools + 3.6 + + + + + vfs_tsmsm + VFS module for handling offline files with Tivoli Storage Manager Space Management + + + + + vfs objects = tsmsm + + + + + DESCRIPTION + + This VFS module is part of the + samba + 7 suite. + + The tsmsm VFS module is an + extension for handling offline files with Tivoli + Storage Manager Space Management. + + + + It tries to avoid calling expensive DMAPI calls with some + heuristics based on the fact that number of blocks reported of a + file multiplied by 512 will be bigger than 'online ratio' of + actual size for online (non-migrated) files. + If heuristic check fails, the module calls DMAPI and asks for + a specific attribute which is present for offline (migrated) files. + If this attribute presents, the file is considered offline. + + + This module is not stackable. + + + + + + OPTIONS + + + + + + tsmsm:hsm script = [ path to hsm script ] + + + hsm script should point to a shell script which + accepts two arguments: operation and filepath. + the tsmsm module only uses "offline" for operation + to set set the file under filepath offline. + + + + + + + tsmsm:online ratio = [ number ] + + + Ratio to check reported size against actual file size. + The default value is 0.5. + + + + + + + + tsmsm:dmapi attribute = [ attribute-name ] + + + Name of a DMAPI attribute that is present when a file is offline. + The default is "IBMobj" (which is what GPFS uses). + + + + + + + tsmsm:dmapi value = [ value for the DMAPI attribute ] + + + Value that the DMAPI attribute should have for the file to + be considered offline. The default is empty (no value required). + + + + + + + + + + EXAMPLES + + A GPFS mount with TSM support can be exported via Samba as follows: + + + + tsmsm gpfs + /test/gpfs_mount + + + + + VERSION + This man page is correct for version 3.6 of the Samba suite. + + + + + AUTHOR + + The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed. + + + -- cgit