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