Fix two compile-blockers in tor_vasprintf().
[tor.git] / doc / tor-resolve.1.txt
blobeb519667b747e6cad564db52d34974bdefe8148e
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
9 NAME
10 ----
11 tor-resolve - resolve a hostname to an IP address via tor
13 SYNOPSIS
14 --------
15 **tor-resolve** [-4|-5] [-v] [-x] __hostname__ [__sockshost__[:__socksport__]]
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.
22 OPTIONS
23 -------
24 **-v**::
25     Display verbose output.
27 **-x**::
28     Perform a reverse lookup: get the PTR record for an IPv4 address.
30 **-5**::
31     Use the SOCKS5 protocol. (Default)
33 **-4**::
34     Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't
35     support reverse DNS.
37 SEE ALSO
38 --------
39 **tor**(1), **torify**(1). +
41 See doc/socks-extensions.txt in the Tor package for protocol details.
43 AUTHORS
44 -------
45 Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.