``xplanet`` =========== This command spits out valid `xplanet `_ configuartion files for the "marker" files. If you pass the ``--execute`` (``-x``) argument, a tempdir is created with a top-level xplanet configuration and xplanet is run against that (causing a map to appear on your root window). You can use ``--all`` (``-A``) to output markers for ALL routers (instead of just ones active for you right now). Note that the position of many will overlap as we don't do anything smart when two co-ordinates are identical. xplanet can include an ``arc_file`` for drawing lines between relays. With ``-x`` or ``-f`` this is used to draw links between relays in a circuit. You can also use ``--arc-file`` (``-a``) if you're not using ``-x`` or ``-f``. .. warning:: Obviously, this could easily leak some information about which relays and circuits you are currently using. Since your guard-nodes (first hop of a circuit) are long-lived, it's advisable to use this for entertainment purposes mainly, and clear your root window when done. Examples -------- .. sourcecode:: shell-session $ carml xplanet -f Connected to a Tor version "0.2.4.21 (git-c5a648cc6f218339)" (status: recommended). 3 (23%) routers with no geoip information. xplanet -num_times 1 -projection rectangular -config /tmp/tmp_32oE5/xplanet-config 4 (27%) routers with no geoip information. xplanet -num_times 1 -projection rectangular -config /tmp/tmp_32oE5/xplanet-config 5 (29%) routers with no geoip information. xplanet -num_times 1 -projection rectangular -config /tmp/tmp_32oE5/xplanet-config