Nick Mathewson
25c8a3d66b
Remove "AUTHORS" sections from manual pages.
...
These sections were incomplete and outdated; their presence is
strongly discouraged by man-pages(7).
Closes #40149 .
2020-10-05 12:10:26 -04:00
Nick Mathewson
f2968c3aac
Fix authors stanza in tor-gencert manpage
...
Closes #40148 .
2020-10-02 09:08:33 -04:00
Nick Mathewson
5c9b4a0060
Remove support for old android "logcat" API
...
This is apparently obsolete; syslog is modern instead. If users
have an android log configured, given them a syslog if we can.
Closes #32181 .
2020-09-23 12:33:58 -04:00
Nick Mathewson
d0b83c7423
state-contents: correcct the description of unusable_circuits
2020-09-22 16:51:26 -04:00
Nick Mathewson
ce1dfb46fc
Add a changes file for 40136 (state-contents.txt updates)
2020-09-22 14:46:41 -04:00
Nick Mathewson
5ffd8bf2b8
state-contents.txt: try to document circ-build-timeout fields
...
This should also get feedback from @mikeperry.
Closes #40136
2020-09-22 14:44:30 -04:00
Nick Mathewson
371cd7ac4f
Try to document pathbias fields in state file.
...
This will require feedback from @mikeperry, since these are a bit
subtle and I've likely mangled some of these.
2020-09-22 14:35:11 -04:00
Nick Mathewson
d1a94a3a7f
Improve doc/state-contents.txt
...
Part of a fix for #40136 .
This patch adds all the state file entries to the documentation, and
documents the ones that I understand well.
2020-09-22 14:17:26 -04:00
Nick Mathewson
33380f6b27
Update remaining trac.tpo wiki urls
2020-09-14 11:02:38 -04:00
Nick Mathewson
563f8610fd
Revise trac.torproject.org urls to refer to gitlab replacements.
...
Closes #40101 .
2020-08-14 09:21:28 -04:00
Nick Mathewson
e82f36bccc
Update ReleasingTor.md to current practice
2020-08-13 09:56:27 -04:00
Nick Mathewson
e151442037
Merge remote-tracking branch 'tor-gitlab/mr/62'
2020-08-12 14:37:21 -04:00
Nick Mathewson
b56985f022
CodingStandards.md: allow "bugfix on all supported versions.
...
Closes tpo/core/team#1 .
2020-08-11 17:58:11 -04:00
Daniel Pinto
0b633b1f6d
Improved documentation and comments #25140
2020-08-11 18:26:41 +01:00
Nick Mathewson
d89c1799af
manual: Describe Sandbox more accurately.
...
Closes #23378
2020-08-04 14:06:25 -04:00
Daniel Pinto
1474ab3395
Add --format argument to --key-expiration option. #30045
2020-08-01 01:08:37 +01:00
Nick Mathewson
4e71fc92c8
WritingTests.md: add a section about shells
...
Closes #29485
2020-07-28 22:59:47 -04:00
Nick Mathewson
92fc0d3699
Edit AddressDisableIPv6 man entry
2020-07-21 09:01:31 -04:00
David Goulet
c3d113a464
relay: Add AddressDisableIPv6 torrc option
...
This option controls if a tor relay will attempt address auto discovery and
thus ultimately publish an IPv6 ORPort in the descriptor.
Behavior is from proposal 312 section 3.2.6.
Closes #33245
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-21 08:18:31 -04:00
Nick Mathewson
5f969681a0
Combine text into existing "what does not need a changes file" section.
2020-07-16 14:54:17 -04:00
Nick Mathewson
85219d887d
Merge remote-tracking branch 'tor-gitlab/mr/57'
2020-07-16 14:53:03 -04:00
David Goulet
e66eba664a
doc: Fix wrong path in include.am
...
Tracing.md moved to doc/tracing/ so fix the distcheck path in include.am. Also
add the new EventsCircuit.md file.
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-16 14:07:33 -04:00
David Goulet
ca1003b791
doc: Update our requirements for changes file
...
Closes tpo/core/team#3.
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-16 13:34:52 -04:00
David Goulet
9c653e58b4
doc: Document circuit subsystem tracing events
...
Create a doc/tracing/ directory to contain a top level README.md which is the
previously named Tracing.md and add the EventsCircuit.md which describes the
circuit subsystem tracing events in depth.
Closes #40036
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-16 14:19:04 +00:00
Daniel Pinto
34fa2c4d0d
Add support for patterns on %include #25140
...
Also adds generic tor_glob function to expand globs.
2020-07-15 22:01:08 +01:00
Alexander Færøy
aba0ff4cb5
Merge remote-tracking branch 'tor-gitlab/merge-requests/48'
2020-07-14 16:07:36 +00:00
David Goulet
770e047c83
doc: Fix aesthetic issues in HACKING/Tracing.md
...
Remove all the escape character "\" which is not needed for Markdown files.
This also fixes the tracing event include to the correct path.
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-14 10:09:01 -04:00
David Goulet
456be93956
doc: Move manpages into doc/man/
...
Closes #40044
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-14 09:02:03 -04:00
Nick Mathewson
ecb43ce21c
Merge branch 'maint-0.4.4'
2020-07-13 10:45:04 -04:00
JeremyRand
0be80fb650
Bug 31812: Change http URL's to https
2020-07-13 10:42:46 -04:00
Guinness
b119c55776
Syntax highlighting in the docs
...
This adds the syntax highlights in the MarkDown files.
Fixes #33741
2020-07-13 11:45:14 +02:00
Nick Mathewson
6fb1637255
Merge remote-tracking branch 'tor-gitlab/mr/29'
2020-07-10 12:53:46 -04:00
Nick Mathewson
be6b30e642
Merge branch 'maint-0.4.4'
2020-07-09 09:59:54 -04:00
David Goulet
942ecfa835
doc: Add a WARNING section to Tracing.md
...
Explain what is safe or not with tracing data.
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-08 11:11:58 -04:00
David Goulet
79d6127a47
trace: Comments and improve doc/HACKING/Tracing.md
...
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-08 09:12:36 -04:00
David Goulet
66d5292ee6
Revert "config: Make clients tell dual-stack exits they prefer IPv6"
...
This reverts commit bf2a399fc0
.
Don't set by default the prefer IPv6 feature on client ports because it breaks
the torsocks use case. The SOCKS resolve command is lacking a mechanism to ask
for a specific address family (v4 or v6) thus prioritizing IPv6 when an IPv4
address is asked on the resolve SOCKS interface resulting in a failure.
Tor Browser explicitly set PreferIPv6 so this should not affect the majority
of our users.
Closes #33796
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-07-07 12:58:41 -04:00
David Goulet
b039d3e803
Merge branch 'tor-github/pr/1953'
2020-07-01 09:47:26 -04:00
Nick Mathewson
5336ac2669
Move remaining CodeStructure.md contents into doxygen.
2020-06-26 10:11:42 -04:00
Nick Mathewson
a7aa97298b
Remove special authority semantics for AssumeReachable.
...
AssumeReachable should only be about whether a relay thinks that it
is reachable itself. But previously, we've had it also turn off
reachability checking of _other_ relays on authorities.
(Technically, reachability tests were still run, but we would ignore
the results.)
With this patch, there is a new AuthDirTestReachability option
(default 1) that controls whether authorities run reachability
tests.
Making this change allows us to have test networks where authorities
set AssumeReachable without disabling their reachability testing
entirely.
Closes ticket #34445 .
2020-06-26 08:37:36 -04:00
Nick Mathewson
dbc2b75009
Merge branch 'assume_reachable_revamp'
2020-06-26 08:34:56 -04:00
Nick Mathewson
62e1d983cf
Deprecate the "--dump-config non-builtin" option
...
When it works, "non-builtin" doesn't do anything different from
"short". (When it doesn't work, it gives an assertion failure.)
Closes ticket #33398 .
2020-06-25 10:01:40 -04:00
Nick Mathewson
edb023b1e7
Add an AssumeReachableIPv6 autobool option.
...
This option tells Tor that our IPv6 orport is reachable, and doesn't
need to be checked.
Closes the rest of 33224.
2020-06-24 15:25:34 -04:00
Nick Mathewson
9fdaede3f7
Remove AssumeReachable from TestingTorNetwork.
...
Closes ticket 34446.
2020-06-15 14:08:42 -04:00
Nick Mathewson
354f085e5f
Merge remote-tracking branch 'tor-github/pr/1888/head'
2020-06-09 15:44:58 -04:00
c
284e9459b8
doc: specify C99 coding standards
...
Make clear that Tor's C code targets C99 standards. This makes it more
explicit what to expect for new code, because guessing from existing
code is not always reliable, especially for code that predates the
change in standard.
2020-06-04 13:28:24 +00:00
Nick Mathewson
b6e60f26dd
Merge branch 'maint-0.4.3'
2020-06-01 09:50:04 -04:00
Roger Dingledine
d6186c7435
Man page: MinUptimeHidServDirectoryV2 defaults to 96 hours
...
Bugfix on 0.2.6.3-alpha; fixes bug 34299.
2020-05-23 04:37:57 -04:00
George Kadianakis
3121e5c103
Merge branch 'tor-github/pr/1850'
2020-05-21 16:24:32 +03:00
teor
e2bd15b6f3
doc: Some tor features may not work with MiddleNodes
...
And fix a formatting issue in the MiddleNodes man page entry.
Part of 33226.
2020-05-11 17:06:43 +10:00
Daniel Pinto
cc169eb120
Add documentation about %include and seccomp sandbox limitations
2020-05-08 00:21:12 +01:00
David Goulet
cd2121a126
client: Revert setting PreferIPv6 on by default
...
This change broke torsocks that by default is expecting an IPv4 for hostname
resolution because it can't ask tor for a specific IP version with the SOCKS5
extension.
PreferIPv6 made it that sometimes the IPv6 could be returned to torsocks that
was expecting an IPv4.
Torsocks is probably a very unique case because the runtime flow is that it
hijacks DNS resolution (ex: getaddrinfo()), gets an IP and then sends it back
for the connect() to happen.
The libc has DNS resolution functions that allows the caller to request a
specific INET family but torsocks can't tell tor to resolve the hostname only
to an IPv4 or IPv6 and thus by default fallsback to IPv4.
Reverting this change into 0.4.3.x series but we'll keep it in the 0.4.4.x
series in the hope that we add this SOCKS5 extension to tor for DNS resolution
and then change torsocks to use that.
Fixes #33804
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-04-09 11:05:32 +10:00
Roger Dingledine
9bd73da7cf
fix typos from #32542
2020-04-08 19:13:52 -04:00
David Goulet
dd25805152
man: Update tor.1 ExtendedErrors section with latest
...
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-04-08 18:15:21 +03:00
teor
065ccda4f6
Merge branch 'pr1838_squashed'
2020-04-07 17:36:17 +10:00
teor
7adf72f1b4
Merge branch 'maint-0.4.3'
2020-04-05 17:17:51 +10:00
teor
80a306c6e7
doc: Fix another man page typo
...
The default value of the option is "auto", not "default".
2020-04-05 17:17:03 +10:00
teor
5c35bb38df
Merge branch 'maint-0.4.3'
2020-04-05 17:12:11 +10:00
teor
613077229f
doc: Fix a typo in the man page
...
"proceeding" means starting an action.
"preceding" means the thing before this thing.
In this context, it's a bit ambiguous.
2020-04-05 17:10:37 +10:00
teor
c0fe88b236
doc: Also stop running practracker in hooks
...
When making a new maint branch, stop running practracker in hooks.
2020-04-03 22:10:01 +10:00
teor
6db2e59f20
doc: Minor restructure for Release Lifecycle
...
* make end and beginning of life into second-level sections
* write an intro for beginning
* tweak intro for end
2020-04-03 22:06:27 +10:00
teor
0f10ddaa29
Re-apply: doc: Replace "underline" with "## Section name".
...
Re-applying changes after merge.
2020-04-03 22:02:11 +10:00
teor
0efcdb8918
Merge remote-tracking branch 'tor-github/pr/1739'
...
Ignored conflicting style changes: they will be re-applied in
the next commit.
2020-04-03 21:59:19 +10:00
teor
442e0caea2
Merge branch 'maint-0.4.3'
2020-04-03 14:44:34 +10:00
teor
7d2b6cacee
doc: Rewrite the approved-routers man page entry
...
Obviously correct documentation changes.
2020-04-03 14:43:48 +10:00
Steven Engler
cc5319bf8e
Updated the TestingTorNetwork man page options
...
Updated 'doc/tor.1.txt' to match 'src/app/config/testnet.inc'.
2020-04-01 01:00:09 -04:00
Nick Mathewson
c323cc0913
Document the --dbg- prefix in tor.1
2020-03-26 12:17:28 -04:00
Bartosz Duszel
df22ee26fb
doc: Remove TODO secion in README.1st.md
...
It seems like this section is not valid anymore.
Most of this topics are already explained in different
files.
2020-03-26 16:32:13 +01:00
Bartosz Duszel
b210aefb7f
doc: Replace "underline" with "## Section name".
...
This approach doesn't require variable-length underlines.
2020-03-26 16:19:42 +01:00
Bartosz Duszel
af4b5eba34
doc: Remove first, empty line in the file.
2020-03-26 15:59:17 +01:00
Bartosz Duszel
8863408cad
doc: Updates paths to the top of the source tree.
...
Example:
.../doc/HACKING is now doc/HACKING
2020-03-26 15:54:29 +01:00
Nick Mathewson
b1a571f038
Edits requested by teor
2020-03-23 09:27:16 -04:00
Bartosz Duszel
fd6a35eb59
Update README files with common style.
...
- external links use markdown's []() format,
- local files are formated with backquotes,
- duplicated new lines were removed,
- unnecesary single spaces were removed,
- broken links and local paths were updated.
2020-03-22 13:50:58 +01:00
teor
e9bb00d8c4
Merge branch 'maint-0.4.3'
2020-03-19 18:03:26 +10:00
teor
725efb7c98
doc: Fix a manual page typo
...
And consistently talk about extra-info document publishing.
Obviously correct documentation changes.
2020-03-19 18:02:32 +10:00
teor
fe5ecaa270
Merge branch 'maint-0.4.3'
2020-03-19 17:02:02 +10:00
teor
85414e1c18
doc: Fix a man page typo
...
Obviously correct changes to already-reviewed code.
2020-03-19 09:24:15 +10:00
David Goulet
05aab3fd21
Merge branch 'maint-0.4.3'
2020-03-10 09:14:44 -04:00
rl1987
72550c18c8
Tweak double-underscore
2020-03-10 09:13:29 -04:00
rl1987
94a2376e01
Document __OwningControllerProcess torrc option and mention polling interval
2020-03-10 09:13:19 -04:00
David Goulet
6684c6e17f
Merge branch 'tor-github/pr/1751'
2020-03-09 09:33:05 -04:00
Neel Chauhan
7d673e70b0
Remove the ClientAutoIPv6ORPort option
2020-03-09 09:33:00 -04:00
rl1987
ef991b04e2
Refrain from mentioning nicknames in manpage section for MyFamily.
...
Also, fix a typo.
2020-03-05 17:41:49 +02:00
Nick Mathewson
c9bd3579f7
Tweak a couple of URLs in gettingstarted.md
2020-02-24 08:10:20 -05:00
Nick Mathewson
b6d9484fa7
Merge remote-tracking branch 'tor-github/pr/1761/head'
2020-02-24 08:06:42 -05:00
Nick Mathewson
caa392a73a
Merge remote-tracking branch 'tor-github/pr/1685/head'
2020-02-24 07:45:20 -05:00
George Kadianakis
93cb8072be
Final touches to #32709 based on Nick's feedback.
...
- Fix a bug and add unittest.
- Add changes file.
- Add man page entry.
2020-02-24 12:15:35 +02:00
Taylor Yu
b7c7feb2e4
manpage: fix up toc attribute
2020-02-20 16:49:08 -06:00
Nick Mathewson
09fb7987c5
Merge branch 'maint-0.4.3'
2020-02-20 08:50:18 -05:00
Nick Mathewson
f733b8acd6
Merge remote-tracking branch 'tor-github/pr/1719/head' into maint-0.4.3
2020-02-20 08:48:17 -05:00
swati
dba5c15893
#33369:Added TOC and hyperlinks for cross-refs
2020-02-20 17:50:32 +05:30
Roger Dingledine
98bf7604a3
fix typo from 7920fc35
2020-02-19 14:53:36 -05:00
Nick Mathewson
dca2c00aca
Merge remote-tracking branch 'tor-github/pr/1755/head'
2020-02-19 11:39:05 -05:00
Taylor Yu
a46e585d6d
manpage: Add a missing out-of-order comment
2020-02-18 13:28:57 -06:00
swati
fa48b0363e
Revised and incorportaed comments from #33275
2020-02-17 22:47:06 +05:30
Nick Mathewson
455ea05bdf
Rename EndOfLifeTor to ReleaseSeriesLifecycle; expand it.
...
Closes ticket 30917.
2020-02-14 08:47:17 -05:00
swati
7920fc3569
Update tor.1.txt
2020-02-14 00:34:39 +05:30
Nick Mathewson
3147cbba52
Merge remote-tracking branch 'tor-github/pr/1728/head' into maint-0.4.3
2020-02-12 13:48:39 -05:00
swati
d33c80f0ee
Moved [[RephistTrackTime]] to General Options.
2020-02-12 23:17:31 +05:30
swati
809090d24d
Addressed minor changes suggested in the ticket
2020-02-12 23:07:00 +05:30
David Goulet
f0964628e6
Merge branch 'ticket33029_042_01' into ticket33029_043_03
...
Conflicts:
doc/tor.1.txt
src/app/config/config.c
src/app/config/or_options_st.h
src/core/mainloop/connection.h
Between 042 and 043, the dirauth options were modularized so this merge commit
address this by moving the AuthDirRejectUncompressedRequests to the module
along with a series of accessors.
Signed-off-by: David Goulet <dgoulet@torproject.org>
2020-02-11 10:30:29 -05:00