ClearCase Reference Manual, Release 4.0, Windows

mvfsstorage

Lists data container pathname for MVFS file

APPLICABILITY

ClearCase (administrative command)

SYNOPSIS

Display pathname of data container:

mvfsstorage [ -a | -k | -u ] pname ...
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

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. 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.

OPTIONS AND ARGUMENTS

With no options, mvfsstorage displays the pathname in user mode format.

-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 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.