[tor-bugs] #28181 [Core Tor/Tor]: spec: Add to pt-spec.txt control messages going back to main process (tor)

[Tor Bug Tracker & Wiki]

#28181: spec: Add to pt-spec.txt control messages going back to main process (tor)
-------------------------------------------------+-------------------------
 Reporter:  dgoulet                              |          Owner:  dgoulet
     Type:  enhancement                          |         Status:  closed
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.4.0.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  tor-spec, tor-pt, 040-roadmap-       |  implemented
  subtask, postfreeze-ok                         |  Actual Points:
Parent ID:                                       |         Points:  1
 Reviewer:  ahf                                  |        Sponsor:
                                                 |  Sponsor19
-------------------------------------------------+-------------------------
Changes (by dcf):

 * parent:  #28180 =>


Comment:

 I asked for feedback from the author of
 [https://github.com/twisteroidambassador/ptadapter ptadapter], which is
 one of the few PT manager implementations apart from tor; i.e., it will
 have to handle LOG and STATUS messages from PT implementations.

 > I agree with dcf's sentiments in general, that LOG messages are for
 human consumption and STATUS messages are for machines. The LOG mechanism
 basically becomes another handler for the logging system, alongside file
 output, syslog, etc. It might be worthwhile to add some way for the
 controlling application to indicate allowed log level, to avoid being
 flooded with debug messages (I know I like to flood my debug logs!)
 >
 > As for STATUS, if these are messages meant for machines, then the
 machine is probably expected to take actions on them. It might be a good
 idea to think about what actions are wanted, and define some standardized
 keys to trigger these actions. A PERCENT key that moves a progress bar
 would be one example.

 They add, "I think the existing syntax is a good foundation to build on."
 (Referring to what shipped in [https://blog.torproject.org/new-release-
 tor-0401-alpha tor 0.4.0.1-alpha].)

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