aboutsummaryrefslogtreecommitdiff
path: root/doc/tor-resolve.1.txt
blob: 341d3022448d8ed96c72afe88ff858c8ea225149 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// Copyright (c) The Tor Project, Inc.
// See LICENSE for licensing information
// This is an asciidoc file used to generate the manpage/html reference.
// Learn asciidoc on http://www.methods.co.nz/asciidoc/userguide.html
:man source:   Tor
:man manual:   Tor Manual
tor-resolve(1)
==============
Peter Palfrader

NAME
----
tor-resolve - resolve a hostname to an IP address via tor

SYNOPSIS
--------
**tor-resolve** [-4|-5] [-v] [-x] __hostname__ [__sockshost__[:__socksport__]]

DESCRIPTION
-----------
**tor-resolve** is a simple script to connect to a SOCKS proxy that knows about
the SOCKS RESOLVE command, hand it a hostname, and return an IP address.

By default, **tor-resolve** uses the Tor server running on 127.0.0.1 on SOCKS
port 9050.  If this isn't what you want, you should specify an explicit
__sockshost__ and/or __socksport__ on the command line.

OPTIONS
-------
**-v**::
    Display verbose output.

**-x**::
    Perform a reverse lookup: get the PTR record for an IPv4 address.

**-5**::
    Use the SOCKS5 protocol. (Default)

**-4**::
    Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't
    support reverse DNS.

SEE ALSO
--------
**tor**(1), **torify**(1). +

See doc/socks-extensions.txt in the Tor package for protocol details.

AUTHORS
-------
Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.