umount

Deactivates a VOB

Applicability

Product	Command type
ClearCase®	cleartool subcommand

Platform
UNIX®
Linux®
Windows®

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: On UNIX and Linux, 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 and Linux 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 and Linux—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 and Linux systems, also unmounts all private VOBs owned by the user.

Examples

In cleartool single-command mode, cmd-context represents the UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool 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