Document tor's --dump-config command in the man page

I went to find the documentation for tor --dump-config today, but there's nothing in the man page.

Nick, can you do a quick man page update? I think you wrote tor --dump-config in 0.3.2 ?

changed milestone to %Tor: 0.4.3.x-final

Trac:
Parent Ticket: #29211 (moved)

added 042-backport-maybe 043-can actualpoints::0 component::core tor/tor consider-backport-immediately milestone::Tor: 0.4.3.x-final owner::nickm parent::29211 points::0.1 priority::medium resolution::implemented reviewer::ahf severity::normal status::closed type::defect version::tor 0.3.2.1-alpha labels

Possible documentation in ticket32467 with PR at https://github.com/torproject/tor/pull/1532.

I kinda forgot what non-builtin did, so I had to look at the code.

Trac:
Actualpoints: N/A to 0
Status: assigned to needs_review

Looks good to me.

Trac:
Reviewer: N/A to ahf
Status: needs_review to merge_ready

Okay, merged to master. Teor, please reopen if you'd like this to say more?

Trac:
Resolution: N/A to implemented
Status: merge_ready to closed

Replying to nickm:

Possible documentation in ticket32467 with PR at https://github.com/torproject/tor/pull/1532.

I kinda forgot what non-builtin did, so I had to look at the code.

As far as I can tell, non-builtin and short are now synonyms.

Because when non-builtin passes config_dump(..., /* default_options */ NULL, ...), config_dump() replaces NULL with a newly-allocated copy of the default options. Instead, it should replace them with a zeroed-out copy.

Can you give a command-line where non-builtin and short differ?

Here's what I tried:

tor --dump-config short
tor --dump-config non-builtin
tor --dump-config short SOCKSPort 0
tor --dump-config non-builtin SOCKSPort 0
tor --dump-config short SOCKSPort 1
tor --dump-config non-builtin SOCKSPort 1

(Also string-based options like Nickname and ContactInfo.)

Trac:
Status: closed to reopened
Resolution: implemented to N/A

I checked master, 0.4.2, and 0.4.1, and they all behave the same. So this might not even be a regression. (It's hard to tell without a counter-example.)

Trac:
Status: reopened to needs_revision

Trac:
Keywords: consider-backport-immediately deleted, consider-backport-immediately 043-can added

Sponsor closed. Remove from roadmap.

Trac:
Sponsor: Sponsor31-can to N/A
Keywords: consider-backport-immediately 043-can deleted, 043-can, consider-backport-immediately added

Trac:
Keywords: network-team-roadmap-november deleted, N/A added

I've opened #33398 (moved) to address the situation with non-builtin

Trac:
Status: needs_revision to closed
Resolution: N/A to implemented

closed

changed time estimate to 48m

mentioned in issue #33398 (moved)

mentioned in issue #29211 (moved)

moved to tpo/core/tor#32467 (closed)

mentioned in issue tpo/core/tor#33398 (closed)