doc/tor-resolve.1.txt

   1 // Copyright (c) The Tor Project, Inc.
   2 // See LICENSE for licensing information
   3 // This is an asciidoc file used to generate the manpage/html reference.
   4 // Learn asciidoc on http://www.methods.co.nz/asciidoc/userguide.html
   5 tor-resolve(1)
   6 ==============
   7 Peter Palfrader
   8
   9 NAME
  10 ----
  11 tor-resolve - resolve a hostname to an IP address via tor
  12
  13 SYNOPSIS
  14 --------
  15 **tor-resolve** [-4|-5] [-v] [-x] __hostname__ [__sockshost__[:__socksport__]]
  16
  17 DESCRIPTION
  18 -----------
  19 **tor-resolve** is a simple script to connect to a SOCKS proxy that knows about
  20 the SOCKS RESOLVE command, hand it a hostname, and return an IP address.
  21
  22 By default, **tor-resolve** uses the Tor server running on 127.0.0.1 on SOCKS
  23 port 9050.  If this isn't what you want, you should specify an explicit
  24 __sockshost__ and/or __socksport__ on the command line.
  25
  26 OPTIONS
  27 -------
  28 **-v**::
  29     Display verbose output.
  30
  31 **-x**::
  32     Perform a reverse lookup: get the PTR record for an IPv4 address.
  33
  34 **-5**::
  35     Use the SOCKS5 protocol. (Default)
  36
  37 **-4**::
  38     Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't
  39     support reverse DNS.
  40
  41 SEE ALSO
  42 --------
  43 **tor**(1), **torify**(1). +
  44
  45 See doc/socks-extensions.txt in the Tor package for protocol details.
  46
  47 AUTHORS
  48 -------
  49 Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.