umount

Deactivates a VOB

APPLICABILITY

SYNOPSIS

umount { vob-tag | -a·ll }

DESCRIPTION

The umount command deactivates one or more VOBs on your host by unmounting them as operating-system-level file systems. A VOB is activated on a host by mounting it as a file system of type MVFS (ClearCase multiversion file system type). The VOB-tag by which an individual VOB is referenced is the same as the full pathname to its mount point.

NOTE TO UNIX USERS: umount calls the standard umount(1M) command.

Unmounting All VOBs

umount -all unmounts all public VOBs listed in the VOB registry and all private VOBs owned by the user.

UNIX Only-Unmounting the View Root Directory

Except on Solaris, if you enter umount -all as root on a platform that supports the operating system command umount -a, the viewroot directory (/view) is unmounted. To remount the viewroot directory, you must stop and restart ClearCase.

RESTRICTIONS

Identities:

• UNIX- root can unmount any VOB; other users can unmount any public VOB, and private VOBs they own.

• Windows-Any user can unmount any VOB, public or private.

Locks: No locks apply.

Mastership: (Replicated VOBs only) No mastership restrictions.

OPTIONS AND ARGUMENTS

SPECIFYING THE VOB.  Default: None.

vob-tag

Unmounts the VOB with this VOB-tag, which you must specify exactly as it appears in the vob_tag registry file.

-a·ll

Unmounts all public VOBs listed in the VOB registry. On UNIX systems, also unmounts all private VOBs owned by the user.

EXAMPLES

In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Unmount the VOB storage directory that is registered with VOB-tag \rel4.

cmd-context umount \rel4

• Unmount all VOBs registered with public VOB-tags.

% su (become root user)

cmd-context umount -all (unmount all public VOBs)

• Unmount all VOBs.

cmd-context umount -all

SEE ALSO

lsvob, mkvob, mount, register, umount(1M), Administrator's Guide