TOR: update to v0.2.5.12
[tomato.git] / release / src / router / tor / doc / tor-resolve.1.in
blobd32f964ecc539c1fde53c32a6f5e23aefb799708
1 '\" t
2 .\"     Title: tor-resolve
3 .\"    Author: Peter Palfrader
4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
5 .\"      Date: 03/12/2015
6 .\"    Manual: Tor Manual
7 .\"    Source: Tor
8 .\"  Language: English
9 .\"
10 .TH "TOR\-RESOLVE" "1" "03/12/2015" "Tor" "Tor Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 tor-resolve \- resolve a hostname to an IP address via tor
32 .SH "SYNOPSIS"
33 .sp
34 \fBtor\-resolve\fR [\-4|\-5] [\-v] [\-x] \fIhostname\fR [\fIsockshost\fR[:\fIsocksport\fR]]
35 .SH "DESCRIPTION"
36 .sp
37 \fBtor\-resolve\fR 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\&.
38 .sp
39 By default, \fBtor\-resolve\fR uses the Tor server running on 127\&.0\&.0\&.1 on SOCKS port 9050\&. If this isn\(cqt what you want, you should specify an explicit \fIsockshost\fR and/or \fIsocksport\fR on the command line\&.
40 .SH "OPTIONS"
41 .PP
42 \fB\-v\fR
43 .RS 4
44 Display verbose output\&.
45 .RE
46 .PP
47 \fB\-x\fR
48 .RS 4
49 Perform a reverse lookup: get the PTR record for an IPv4 address\&.
50 .RE
51 .PP
52 \fB\-5\fR
53 .RS 4
54 Use the SOCKS5 protocol\&. (Default)
55 .RE
56 .PP
57 \fB\-4\fR
58 .RS 4
59 Use the SOCKS4a protocol rather than the default SOCKS5 protocol\&. Doesn\(cqt support reverse DNS\&.
60 .RE
61 .SH "SEE ALSO"
62 .sp
63 \fBtor\fR(1), \fBtorify\fR(1)\&.
64 .sp
65 See doc/socks\-extensions\&.txt in the Tor package for protocol details\&.
66 .SH "AUTHORS"
67 .sp
68 Roger Dingledine <arma@mit\&.edu>, Nick Mathewson <nickm@alum\&.mit\&.edu>\&.
69 .SH "AUTHOR"
70 .PP
71 \fBPeter Palfrader\fR
72 .RS 4
73 Author.
74 .RE