fix_prot

Fix protections on VOB or view storage directories.

fix_prot [–f/orce] { –root [–r/ecurse] [–recover {–chown user | –chgrp group } | –replace/_server_process_group| [–r/ecurse] [–type { d | f }] [–chown user] [–chgrp group] [–chmod permissions] } pname …

Options

–f/orce Do not prompt for confirmation.

–r/ecurse Recursively fix protections.

–root Specifies that pname is a storage directory root.

–type Specifies the type of file system objects to fix. Use d for directories and f for files. If –type is not specified, fix_prot operates on both directories and files.

–chown Specifies the new owner. Mandatory with –root.

–chgrp Specifies the new primary group. Mandatory with –root.

–chmod Specifies the new access rights: owner, group, other (world). Both symbolic and numeric codes are valid, such as go-x (symbolic) or 0644 (absolute).

–recover (Windows® only) Restores correct file system ACLs in a VOB or view storage directory based on the information in the files identity.sd and groups.sd . Not applicable to schema version 54 VOBs, for which vob_sidwalk –recover_filesystem performs this function.

–replace[_server_process_group] (Windows only) Replaces ACL entries for the Rational® ClearCase® administrators group. Use this option if you have changed the Rational ClearCase administrators group name or have moved a view to a new domain that has a different SID for this group.

Examples

To create a .identity directory after moving a VOB from Windows to a host running Linux® or the UNIX® system. The VOB has been moved to the storage directory /vobstg/winvob.vbs. The new owner is vobadm and the new group is ccusers. You must run this command as root.
ccase-home-dir/etc/utils/fix_prot –root –recurse –chown vobadm –chgrp ccusers /vobstg/winvob.vbs
To repair ACLs damaged when a view storage directory was copied to NTFS directory C:\ClearCaseStorage\int.vws using a copy utility that did not preserve ACLs:
ccase-home-dir\etc\utils\fix_prot –root –recover C:\ClearCaseStorage\int.vws
To display the protection modes associated with the directory E:\vobstg\sources.vbs:
ccase-home-dir\etc\utils\fix_prot E:\vobstg\sources.vbsdrwxr-xr-x MYDOMAIN\me MYDOMAIN\mygroup E:\vobstg\sources.vbs

Note: fix_prot may return an error message that begins with the following text:

fix_prot: Error: unknown style protections on directory: The data is invalid.

If it does, you must run fix_prot again and specify all the –chown, –chgrp, and –chmod options and also supply an absolute permissions value, either in numeric or ID=rights (o=rwx) form to –chmod. For example:

ccase-home-dir\etc\utils\fix_prot –chown owner –chgrp group –chmod 0666 pname