umount

Deactivates a VOB

Applicability

Product

Command type

ClearCase®

cleartool subcommand

ClearCase® Remote Client

rcleartool subcommand

Platform

UNIX

Linux

Windows

Synopsis

  • ClearCase®--Unmount VOBs:
    unmount { vob-tag | -a/ll }
  • ClearCase® Remote Client--Unmount VOBs from an automatic view:
    umount [ -tag view-tag ] vob-tag ...

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.
-tag view-tag
Specifies the automatic view for which the specified VOBs are to be unmounted. For automatic views, VOB mounts are per-view: unmounting a VOB from one automatic view does not unmount it from other automatic views on the same host.

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