README 1.1 KB

12345678910111213141516171819202122232425262728293031
  1. This is chutney. It doesn't do much so far. It isn't ready for prime-time.
  2. If it breaks, you get to keep all the pieces.
  3. It is supposed to be a good tool for:
  4. - Configuring a testing tor network
  5. - Launching and monitoring a testing tor network
  6. - Running tests on a testing tor network
  7. Right now it only sorta does the first two.
  8. You will need, at the moment:
  9. - Tor installed somewhere in your path or the location of the 'tor' and
  10. 'tor-gencert' binaries specified through the environment variables
  11. CHUTNEY_TOR and CHUTNEY_TOR_GENCERT, respectively.
  12. - Python 2.7 or later
  13. Stuff to try:
  14. ./chutney configure networks/basic
  15. ./chutney start networks/basic
  16. ./chutney status networks/basic
  17. ./chutney hup networks/basic
  18. ./chutney stop networks/basic
  19. The configuration files:
  20. networks/basic holds the configuration for the network you're configuring
  21. above. It refers to some torrc template files in torrc_templates/.
  22. The working files:
  23. chutney sticks its working files, including all data directories, log
  24. files, etc, in ./net/. Each tor instance gets a subdirectory of net/nodes.