samunhold(1M)

NAME
     samunhold - Releases SANergy file holds

SYNOPSIS
     /opt/SUNWsamfs/sbin/samunhold mntpoint

AVAILABILITY
     SUNWqfs

     SUNWsamfs

DESCRIPTION
     The samunhold command can be used to release SANergy file
     holds.  These holds can be detected when attempts are made
     to unmount a file system with the umount(1M) command.  If
     holds are present, the umount(1M) command generates log
     messages such as the following:

     Inode XXXX: held by SAN, refcnt = N

     SANergy File Sharing uses the following two types of leases,
     both of which require holds:

     o Read leases, which typically expire within a few seconds.

     o Write leases, which can extend for as long as an hour.

     It is preferable to allow SANergy File Sharing to clean up
     the leases, but in an emergency, or in case of a SANergy
     File Sharing system failure, the administrator can use the
     samunhold command to avoid a reboot.

     The samunhold command should only be run when SANergy File
     Sharing has held inodes and is preventing a file system from
     being unmounted.  Prior to executing this command, the
     administrator should ensure the following:

     o There are no SANergy applications running on any client,
       possibly including the server itself.

     o The file system in question is not fused on any SANergy
       clients.

     o The file system is not NFS mounted.

OPTIONS
     The samunhold command releases all held inodes (files) on
     the file system whose root directory is the named mntpoint
     argument.  The samunhold command must be run as root.

EXAMPLES
     The following example shows the samunhold command:
     bilbo# samunhold /sam1
     bilbo# umount /sam1

SEE ALSO
     umount(1M).