umount

Deactivates a VOB

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand

Platform
UNIX
Windows

SYNOPSIS

umount { vob-tag | –a·ll }

DESCRIPTION

The unmount 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, 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.

  • 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



Copyright© 2003 Rational Software. All Rights Reserved.