Command Reference, Release 2002.05.00, All Platforms

mvfsstorage

Lists data container pathname for MVFS file

APPLICABILITY


Product	Command Type
ClearCase	command


Platform
UNIX
Windows

SYNOPSIS

UNIX:

mvfsstorage pname ...

Windows only-Display pathname of data container:

mvfsstorage [ -a | -k | -u ] pname ...

Windows only-Display help on command options:

mvfsstorage -h

DESCRIPTION

mvfsstorage lists the pathname of an MVFS file's data container. The pathname may be within view-private storage, the source pool, or the cleartext pool, depending on the kind of file.


For a ...	mvfsstorage displays
View-private file (including checked-out versions, unshared derived objects, and nonshareable derived objects)	Pathname to the data container in the view's private storage area
Version whose element uses a single data container file	Pathname to the data container in the VOB cleartext storage pool NOTE: If you have accessed the version recently, this is the actual pathname of the data container. If you have not accessed the version recently, this is the pathname to which ClearCase would extract the version.
Version whose element uses a separate data container file for each version	Pathname to the data container in the VOB source storage pool

mvfsstorage is intended for use in finding discrepancies in OS-level access rights between the view and the underlying MVFS storage. Such discrepancies may occur when you do not have access rights to the remote underlying storage (for example, in UNIX, the storage may be owned by root). If you encounter a permissions error that seems unfounded, run this utility as a diagnostic and ensure that you have valid access to the remote storage directory and specifically to the underlying data container pathname.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

-h: Displays help on command options.
-a: Displays both kernel and UNC/drive letter pathnames.
-k: Displays pathname in kernel mode format, which includes the device name.
-u: Displays the pathname in user mode format. The path is displayed in drive letter form for local paths and automounted NFS volumes, and in UNC form for remote SMB or nonautomounted NFS paths.
pname ...: One or more names of files whose pathnames are under a VOB-tag (an MVFS object). For directories and non-MVFS objects, mvfsstorage echos the pathnames you give it.

EXAMPLES

For a view-private file, compare view-level ownership and permissions against those on the file's underlying storage location.

% ls -l unixV7 `/usr/atria/etc/mvfsstorage unixV7` -rwxrwxrwx 1 nobody 65534 2210032 May 12 09:33 /net/myhost/home/myview/ .s/0008.VOB/016D.2E2F.unixV7* -rwxrwxrwx 1 root sys 2210032 May 12 09:33 unixV7*

For a local view-private file, return data on the file's underlying storage location.

Z:\myvob\mydir> mvfsstorage util.c D:\myviews\anneview.vws\.s\0008\016D.2E2F.util.c

For a remote VOB file, return data on the file's underlying storage location.

C:\users> mvfsstorage z:\vob1\src\foo.c \\neon\usr3\vobs\vob1.vbs\c\cdft\24\27\2cf992fb839477d2b77300018909a766