hg_hooks/blacklist/README
changeset 144 6e81c130aa29
equal deleted inserted replaced
136:47849267b4d1 144:6e81c130aa29
       
     1 hg blacklist 
       
     2 
       
     3 manage repository changeset blacklist
       
     4   
       
     5   This extension is used to manage a blacklist for the repository.
       
     6   Can blacklist changesets by changeset id, and regular expressions against
       
     7   the user field of a changeset and also a changesets file list.
       
     8   
       
     9   Current rules can be viewed using the [-l|--list] operation.
       
    10   
       
    11   Each modification to a blacklist is logged. These can be viewed using the 
       
    12   --auditlog operation.
       
    13   
       
    14   Each time a changeset is blocked/denied it's logged. These can be viewed
       
    15   using the --blocklog operation.
       
    16   
       
    17   Types of changeset blacklist rules can be defined implicitly or explicitly:
       
    18   
       
    19     If a rule definition contains between 12 and 40 hexadecimal characters 
       
    20     it is assumed to be a rule matched against changeset id. Can be set 
       
    21     explicitly set with the -n flag to the --add operation.
       
    22   
       
    23     If a rule definition contains a '@' it is assumed to be a rule matched 
       
    24     against a changeset's user property. Can be set explicitly with 
       
    25     the -u flag to the --add operation.
       
    26   
       
    27     Otherwise the rule is assumed to be matched against a changeset's file 
       
    28     list. Can be set explicitly with the -f flag to the --add operation.
       
    29   
       
    30     When this extension is enabled a hook is also added to the 
       
    31     'pretxnchangegroup' action that will block any incoming changesets 
       
    32     (via pull/push/unbundle) if they are blacklisted.
       
    33     It won't block any local commits.
       
    34