[tor-bugs] #7533 [Tor]: AUTHDIR_NEWDESCS vaguely documented

[Tor Bug Tracker & Wiki]

#7533: AUTHDIR_NEWDESCS vaguely documented
-----------------------+----------------------------------------------------
    Reporter:  atagar  |       Owner:                    
        Type:  defect  |      Status:  closed            
    Priority:  normal  |   Milestone:  Tor: 0.2.4.x-final
   Component:  Tor     |     Version:                    
  Resolution:  fixed   |    Keywords:  tor-auth spec     
      Parent:          |      Points:                    
Actualpoints:          |  
-----------------------+----------------------------------------------------
Changes (by nickm):

  * status:  new => closed
  * resolution:  => fixed


Comment:

 Replying to [ticket:7533 atagar]:
 > The AUTHDIR_NEWDESCS events lack sufficient information for me to parse
 them. At present all the spec has is...
 >
 > {{{
 > 4.1.8. Descriptors uploaded to us in our role as authoritative dirserver
 >
 >   Syntax:
 >      "650" "+" "AUTHDIR_NEWDESCS" CRLF Action CRLF Message CRLF
 >        Descriptor CRLF "." CRLF "650" SP "OK" CRLF
 >      Action = "ACCEPTED" / "DROPPED" / "REJECTED"
 >      Message = Text
 > }}}
 >
 > https://gitweb.torproject.org/torspec.git/blob/HEAD:/control-
 spec.txt#l1505
 >
 > Questions that I have are...

 I think I should have this cleared up in
 a1331ca69dc768709b53b104b243fca27320ae74

 > * The Actions should have a description for what the actions mean, and
 say if new values are allowed or not.

 For this, I added a statement in 4745fc3dbaf8253e96bf2a543d0140a60e6dba50
 that if values are enumerated, and there isn't an explicit statement
 saying that new values will never be added, new values may be added.  That
 should prevent snafus in the future.

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/7533#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online