ClearCase Reference Manual, Release 4.0, Windows

reqmaster

Sets access controls for mastership requests or request mastership of a branch

APPLICABILITY

ClearCase (cleartool subcommand), MultiSite (multitool subcommand)

SYNOPSIS

Display or set the ACL for mastership requests:

reqmaster -acl [ -edi·t | -set pname | -get ] vob-selector
Set access controls for the replica or for branches:

reqmaster [ -c·omment comment | -cq·uery | -nc·omment ]

{ { -enable | -dis·able } vob-selector
| { -den·y | -allow } -inst·ances branch-type-selector ...| { -den·y | -allow } branch-pname ...}
Request mastership of a branch:

reqmaster [ -c·omment comment | -cq·uery | -nc·omment ]

[ -lis·t ] branch-pname ...

DESCRIPTION

This command configures access controls for mastership requests and requests mastership of a branch from the replica that masters the branch. For more information, see Implementing Requests for Branch Mastership in ClearCase MultiSite Manual.

SETTING ACCESS CONTROLS

For a reqmaster command to succeed, all of the following conditions must be true:

The branch is mastered by the replica contacted by the reqmaster command.
If your local replica does not have up-to-date information about which replica masters the branch, the reqmaster command goes to the wrong replica and fails.
The branch and its branch type are not locked.
There are no checkouts on the branch (except for unreserved checkouts made with the -nmaster option).
The developer requesting mastership is on the mastering replica's access control list (ACL). Use the -acl option with -edit or -set to edit the ACL.
Replica-level access is enabled: The mastering replica must allow mastership requests for objects it masters. By default, replica-level access is not enabled. To enable it, use the -enable option.
Type-level access is enabled: The branch type must allow mastership requests for branches of that type. By default, type-level access is enabled.
Object-level access is enabled: The branch object must allow mastership requests for the branch. By default, object-level access is enabled.

You can enable replica-level access, but deny requests for mastership of specific branches or for mastership of all branches of a specific type. Even if replica-level access is enabled, the reqmaster command fails if requests for mastership are denied at the type level or object level.

REQUESTING MASTERSHIP OF A BRANCH

The reqmaster command contacts a remote replica and requests that the replica transfer mastership of a branch to the local replica. You can also use reqmaster to display information about whether a mastership request for the branch will succeed.

If you specify multiple branches and the request fails for one or more branches, reqmaster prints error messages for the failures and continues processing the other branches.

TROUBLESHOOTING

If the reqmaster command fails, the error message indicates whether the failure occurred at the local replica or the remote replica.

If the reqmaster command fails with the message can't get handle, enter the command again. If it continues to fail, contact the administrator of the remote replica.

When you request mastership of a branch, the reqmaster command may complete successfully, but the mastership is not transferred to your local replica. In this case, check that the synchronization packet was sent from the remote replica and that your local replica imported it successfully.

RESTRICTIONS

Restrictions for setting access controls:

Permissions:

To set the ACL, you must be VOB owner, root user (UNIX), a member of the ClearCase group (Windows), or have write permission on the ACL.
To enable mastership requests at the replica level, you must be VOB owner, root user (UNIX) or a member of the ClearCase group (Windows).
Anyone can display the ACL with reqmaster -acl -get. See the permissions reference page in the ClearCase Reference Manual.
Locks: No locks apply.
Mastership: For you to allow or deny mastership requests for a branch, your local replica must master the branch.
Other restrictions: You must be logged in to the VOB server host to edit or set the ACL for the replica.

Restrictions for requesting mastership of a branch:

Permissions: You must be on the replica's ACL.

Locks: The reqmaster command fails if the branch or branch type is locked.

Other restrictions: The reqmaster command fails if mastership requests are denied at any of the following levels: replica, type object, object. The reqmaster command fails if there are checkouts on the branch (except for unreserved checkouts made with the -nmaster option).

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by the standard ClearCase user profile (default: -nc). See Customizing Comment Handling in the multitool reference page. To edit a comment, use chevent.

-c·omment comment | -cq·uery | -nc·omment: Overrides the default with one of MultiSite's standard comment options.

DISPLAYING OR SETTING ACCESS CONTROLS. Default: None. You must specify access controls. Specifying -acl with no other option displays the ACL for the local replica in the VOB family specified by vob-selector.

-acl [ -edi·t | -set pname | -get ] vob-selector: By default or with -get, displays the ACL for the local replica in the VOB family specified by vob-selector. With -edit, opens the ACL for the local replica in the editor specified by (in order) the WINEDITOR (UNIX only), VISUAL, or EDITOR environment variable. With -set, uses the contents of pname to set the ACL for the local replica.

: Specify vob-selector in the form vob:pname-in-vob

pname-in-vob

Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted)

-enable vob-selector: Allows mastership requests to be made to the local replica in the VOB family specified by vob-selector.

-dis·able vob-selector: Denies all mastership requests made to the local replica in the VOB family specified by vob-selector.

{ -deny | -allow } -inst·ances branch-type-selector ...: Denies or allows requests for mastership of all branches of the specified type. Specify branch-type-selector in the form brtype:type-name[@vob-selector]

type-name

Name of the branch type

vob-selector

VOB specifier; can be omitted if the current working directory is within the VOB.

Specify vob-selector in the form [vob:]pname-in-vob

pname-in-vob

Pathname of the VOB-tag (whether or not the VOB is mounted) or of any file-system object within the VOB (if the VOB is mounted)

{ -deny | -allow } branch-pname ...: Denies or allows requests for mastership of the specified branch. Specify branch-pname in the form file-pname@@branch. For example:

: foo.c@@/main/v3.8 header.h@@\main\v1\bugfix

REQUESTING MASTERSHIP OF A BRANCH. Default: Sends a request for mastership to the mastering replica of the branch.

-lis·t: Does not request the mastership change; instead, displays branch type, and mastering replica of the branch, and whether a request would succeed.

branch-pname: Branch whose mastership you are requesting. For example:

: foo.c@@/main/v3.8 header.h@@\main\v1\bugfix

EXAMPLES

Display the ACL for for the local replica in the VOB family \dev, and then change it to give full access to ccadmin and permission to request mastership to susank and johng.

multitool reqmaster -acl -get vob:\dev # Replica hosmer@\dev # Request for Mastership ACL: Everyone: Read

Create a file (for example, c:\tmp\hosmer_aclfile) containing the following lines:

# Replica hosmer@\dev # Request for Mastership ACL: User:foobar/ccadmin Full User:foobar/susank Change User:foobar/johng Change

multitool reqmaster -acl -set c:\tmp\hosmer_aclfile vob:\dev

multitool reqmaster -acl -get vob:\dev # Replica hosmer@\dev # Request for Mastership ACL: User:foobar/ccadmin Full User:foobar/susank Change User:foobar/johng Change

Allow requests for mastership for all branches mastered by the local replica in VOB family \test_dev, except for branches of type v2.6_beta.

multitool reqmaster -enable vob:\test_dev Requests for mastership enabled in replica "vob:\test_dev"

multitool reqmaster -deny -instances brtype:v2.6_beta Requests for mastership denied on all instances of "brtype:v2.6_beta"

Allow requests for mastership for all branches mastered by the local replica, except for the branch cmdsyn.m@@\main\v2.6_integ.

multitool reqmaster -enable vob:\dev Requests for mastership enabled in replica "vob:\dev"

multitool reqmaster -deny cmdsyn.m@@\main\v2.6_integ Requests for mastership denied on branch "cmdsyn.m@@\main\v2.6_integ"

Deny requests for mastership for all branches mastered by the local replica.

multitool reqmaster -disable vob:\doc Requests for mastership disabled in replica "vob:\doc"

Request mastership of the branch cmdsyn.m@@\main\v2.6_dev.

multitool reqmaster cmdsyn.m@@\main\v2.6_dev

Display mastership information about the branches include.h@@\main\integ and acc.c@@\main.

multitool reqmaster -list include.h@@\main\integ acc.c@@\main multitool: Error: The following errors will be encountered multitool: Error: acc.c@@\main Request Mastership remote "reqmaster" operation (host "neon") would fail: the requested operation is denied.