ssusers

Purpose

The ssusers tool will print out a list of rights for all users, something ssadmin cannot do. If you have to delete the rights file, Analyze will re-create an empty rights file, but you must re-enter all user rights by hand. For this an all user rights list is essential!

The ssusers tool highlights rights granted to projects that have been deleted or purged, something you need to know to maintain a clean set of user rights.

When you delete or purge projects, SourceSafe does NOT search the rights.dat file for users who have been granted rights to those projects, and remove those rights.

The only indication that ssadmin gives that a user has obsolete rights is the display of the obscure message 'Unable to open xxxxxxxx' on exit from the User Rights dialog.

Even more annoying is that ssadmin then discards any changes you may have made! In order to make any changes to such a user's rights it is first necessary to delete any obsolete rights, not an easy task as the user rights dialog does not highlight them!

The ssusers tool lists all users with destroy rights. Granting destroy rights is sometimes necessary to move or remove files but it's good practice to remove destroy rights as soon as you're done with them! The only way using ssadmin to check on who has destroy rights is to open and scroll through the user rights dialog for every user!

SS

Tested with SourceSafe V5.0 V6.0.

OS

Windows NT/2K/XP Command line utility.

ssusers PathToVssDataDirectory
Example
ssusers s:\vss\data

Outputs

List All User Rights

     Read-Only   User  Status     Projects
     Rights  Physical
024             Pmara
     R C A   aaaaaaaa             $/
     R       pqtbaaaa             $/Test/Projects/Lead
     R C A   fjbfaaaa  Purged     $/Cost/Estimates (Estimates is not a child of Cost$.)
     R C A   rsbfaaaa  Deleted    $/Database/BOM/Specs  (BOM is marked as deleted)
     None    wklkaaaa             $/Contracts
     R C A   wytuaaaa  ERROR      Unable to open s:\vss\data\w\wytuaaaa
     R       pkdwaaaa             $/Design/Documents
User Count = 112
Users with rights problems= 2

List of Users With Destroy Rights

     Read-Only   User  Status     Projects
     Rights  Physical
003             Admin
    R C A D aaaaaaaa             $/
    R C A D bcraaaaa  Purged     $/Cost/Estimates
    R C A D kwoaaaaa  Deleted    $/Data/Old/2000 (Old is marked as deleted)
    R C A D ljdsaaaa             $/Data/Warehouse
Users with destroy rights = 1

Projects To Which Rights Have Been Granted

Physical  #Users  Status    Project
aaaaaaaa     12              $/
bcraaaaa     40   Purged     $/Cost/Estimates
pqtbaaaa     13              $/Test/Projects/Lead
etc
Number of distinct projects =  3

Installation

Copy the program into the directory where you want to run it. It's stand-alone and requires no configuration or support.

Download

ssusers 1.6 (66 KB)