rmfolder

Remove a UCM folder

APPLICABILITY

ClearCase (cleartool subcommand),

SYNOPSIS

rmfolder [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery | -cqe·ach | -nc·omment ]

[ -f·orce ] folder-selector ...

DESCRIPTION

The rmfolder command deletes one or more UCM folders. You cannot delete a folder if it contains any projects, other folders, or is the RootFolder.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the folder's owner, the VOB owner, or a member of the ClearCase group.

Locks: An error occurs if there are locks on any of the following objects: the folder.

Mastership: The folder must be locally mastered.

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -nc). See CUSTOMIZING COMMENT HANDLING in the comments reference page. Comments can be edited with chevent.

-c·omment comment | -cfi·le comment-file-pname |-cq·uery | -cqe·ach | -nc·omment

Overrides the default with the option you specify. See the comments reference page.

-f·orce

By default, the rmfolder command prompts for confirmation before deleting a folder. The -force option suppresses the confirmation step.

folder-selector ...

Specifies one or more folders to delete.

folder-selector is of the form: [folder:]folder-name[@vob-selector] and vob is the folder's UCM project VOB.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Remove a folder that contains a subfolder, moving the subfolder to a new location.
  1. Issue the rmfolder command:

cmd-context rmfolder -f top
cleartool: Error: Cannot remove folder that has sub projects or folders.
cleartool: Error: Unable to remove folder "top".

1. Use lsfolder to find subprojects or folders for the specified folder:

cmd-context lsfolder -l top
folder "top"
07-Sep-99.10:20:08 by Smith
"My Top Level Folder."
owner: Smith
group: user
title: Top
contains folders:
parsers
contains projects:

1. Move the subfolder to a new location:

cmd-context chfolder -to RootFolder parsers
Changed folder "parsers".

1. Reissue the rmfolder command:

cmd-context rmfolder top
Remove folder "top"? [no] yes
Removed folder "top".

SEE ALSO

chfolder, lsfolder, mkfolder, rmproject