102-drop-opt.txt 1014 B

1234567891011121314151617181920212223242526
  1. Drop "opt" from the directory format.
  2. The "opt" keyword in Tor's directory formats was originally intended to
  3. mean, "it is okay to ignore this entry if you don't understand it"; the
  4. default behavior has been "discard a routerdesc if it contains entries you
  5. don't recognize."
  6. But so far, every new flag we have added has been marked 'opt'. It would
  7. probably make sense to change the default behavior to "ignore unrecognized
  8. fields", and add the statement that clients SHOULD ignore fields they don't
  9. recognize. As a meta-principle, we should say that clients and servers
  10. MUST NOT have to understand new fields in order to use directory documents
  11. correctly.
  12. Of course, this will make it impossible to say, "The format has changed a
  13. lot; discard this quietly if you don't understand it." We could do that by
  14. adding a version field.
  15. Status:
  16. * We stopped requiring it as of 0.1.2.5-alpha. We'll stop generating it
  17. once earlier formats are obsolete.