Debian Bug report logs - #802466
man refers to missing control-spec.txt

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Jean-Michel Vourgère <nirgal@debian.org>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: man refers to missing control-spec.txt

Date: Tue, 20 Oct 2015 12:10:00 +0200

Package: tor
Version: 0.2.5.12-1
Severity: minor

Hi

I'd like to switch virtual circuits in some cases.

I can do that interactively using vidalia "New identity" option. So I looked
in the manual how it's done. But tor manual says "using the Tor Control
Protocol (described in control-spec.txt)."

However, there is no such file in Debian. I tried apt-file search.

This file should be added in the package, or the manual should be fixed.

-- System Information:
Debian Release: 8.2
  APT prefers stable
  APT policy: (990, 'stable'), (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 3.16.0-4-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.utf8, LC_CTYPE=en_GB.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages tor depends on:
ii  adduser         3.113+nmu3
ii  libc6           2.19-18+deb8u1
ii  libevent-2.0-5  2.0.21-stable-2
ii  libseccomp2     2.1.1-1
ii  libssl1.0.0     1.0.1k-3+deb8u1
ii  lsb-base        4.1+Debian13+nmu1
ii  zlib1g          1:1.2.8.dfsg-2+b1

Versions of packages tor recommends:
ii  logrotate    3.8.7-1+b1
ii  tor-geoipdb  0.2.5.12-1
ii  torsocks     2.0.0-3

Versions of packages tor suggests:
pn  apparmor-utils     <none>
pn  mixmaster          <none>
pn  obfsproxy          <none>
ii  privoxy            3.0.21-7
ii  socat              1.7.2.4-2
pn  tor-arm            <none>
pn  xul-ext-torbutton  <none>

-- Configuration Files:
/etc/tor/torrc changed [not included]

-- no debconf information

Message #10 received at 802466@bugs.debian.org (full text, mbox, reply):

From: Jérémy Bobbio <lunar@debian.org>

To: Jean-Michel Vourgère <nirgal@debian.org>, 802466@bugs.debian.org

Subject: Re: Bug#802466: man refers to missing control-spec.txt

Date: Tue, 20 Oct 2015 12:21:48 +0200

[Message part 1 (text/plain, inline)]

Jean-Michel Vourgère:
> I'd like to switch virtual circuits in some cases.
> 
> I can do that interactively using vidalia "New identity" option. So I looked
> in the manual how it's done. But tor manual says "using the Tor Control
> Protocol (described in control-spec.txt)."

It's unrelated to this specific bug, but if you want to do stuff with
the Tor control protocol, I highly recommend you look at Stem, available
in the python-stem package, and its `tor-prompt` utility:
https://stem.torproject.org/tutorials/down_the_rabbit_hole.html

Running:

$ tor-prompt
SIGNAL NEWNYM

Will do the same as the “New identity” feature of Vidalia.

Another more flexible option is to pass different SOCKS
username/password to get different circuits. This is how the “New
circuit for this site” and per domain circuit isolation is done in Tor
Browser.
(This is the `IsolateSOCKSAuth` option, enabled by default.)

Hope that helps,
-- 
Lunar                                .''`. 
lunar@debian.org                    : :Ⓐ  :  # apt-get install anarchism
                                    `. `'` 
                                      `-   

[signature.asc (application/pgp-signature, inline)]

Message #15 received at submit@bugs.debian.org (full text, mbox, reply):

From: Peter Palfrader <weasel@debian.org>

To: Jean-Michel Vourgère <nirgal@debian.org>, 802466@bugs.debian.org

Cc: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: Re: Bug#802466: man refers to missing control-spec.txt

Date: Tue, 20 Oct 2015 12:41:29 +0200

On Tue, 20 Oct 2015, Jean-Michel Vourgère wrote:

>                              But tor manual says "using the Tor Control
> Protocol (described in control-spec.txt)."

The spec files can be found at
https://gitweb.torproject.org/torspec.git/tree/

I agree that maybe the manual should link to that resource.

Cheers,
-- 
                            |  .''`.       ** Debian **
      Peter Palfrader       | : :' :      The  universal
 https://www.palfrader.org/ | `. `'      Operating System
                            |   `-    https://www.debian.org/

Message #27 received at 802466-done@bugs.debian.org (full text, mbox, reply):

From: Peter Palfrader <weasel@debian.org>

To: 802466-done@bugs.debian.org

Subject: Re: Bug#802466: man refers to missing control-spec.txt

Date: Wed, 1 Jun 2016 19:18:39 +0000

Version: 0.2.8.2-alpha-1

On Tue, 20 Oct 2015, Peter Palfrader wrote:

> On Tue, 20 Oct 2015, Jean-Michel Vourgère wrote:
> 
> >                              But tor manual says "using the Tor Control
> > Protocol (described in control-spec.txt)."
> 
> The spec files can be found at
> https://gitweb.torproject.org/torspec.git/tree/
> 
> I agree that maybe the manual should link to that resource.

This was fixed upstream with 0.2.8.1-alpha-1.
cf. https://bugs.torproject.org/17392

-- 
                            |  .''`.       ** Debian **
      Peter Palfrader       | : :' :      The  universal
 https://www.palfrader.org/ | `. `'      Operating System
                            |   `-    https://www.debian.org/

Send a report that this bug log contains spam.