Hi,
I wanted to help improve the man page section for MyFamily in the light of today's MyFamily change [1].
I sometimes contact relay operators about their MyFamily configuration and a common request is: "Please send me an example"
So I added an example to the man page (including the new multiline support in 031)
- replaced "node" with "fingerprint" (no one is using nicknames anymore, or onionoo does not display fingerprints?) Are nicknames still supported? (Roger started to remove remaining bits of the past Named "world" so this might be another place?) - made clear that you can still have multiple fingerprints in a single line (if this will be deprecated at some point I can add a deprecation info) - added info that the fingerprint can be prefixed with $ - changed "This option can be repeated many times, for multiple families" to "This option can be repeated many times, for multiple fingerprints" (from one relay's view there is only one family)
nusenu
inline patch below (I can paste it to trac if you like)
[1] https://gitweb.torproject.org/tor.git/commit/?id=d76cffda601eed40d6a81eadb12... https://trac.torproject.org/projects/tor/ticket/4998#comment:11
1735c1735 < [[MyFamily]] **MyFamily** __node__:: ---
[[MyFamily]] **MyFamily** __fingerprint__,__fingerprint__,__...__::
1738,1739c1738,1741 < their identity fingerprints. This option can be repeated many times, for < multiple families. When two servers both declare that they are in the ---
their (possibly $-prefixed) identity fingerprints. This option can be repeated many times, for multiple fingerprints, all fingerprints in all MyFamily lines will
be merged.
When two servers both declare that they are in the
1745,1746c1747,1753 < When listing a node, it's better to list it by fingerprint than by < nickname: fingerprints are more reliable. ---
Example: + MyFamily
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB +
MyFamily CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC +
- is identical to: +
- MyFamily
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB,CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
nusenu:
no one is using nicknames anymore, or onionoo does not display fingerprints?) Are nicknames still supported?
correction, I found some nicknames in onionoo's alleged_family field of the following relays, so they use it, but didn't find any in effective_family. So it should be fine to use 'fingerprint' only in the documentation?
list of relays with nicknames in their alleged_family 02326AE8AAA771BFF9718012672636BC31156E51 0C039F35C2E40DCB71CD8A07E97C7FD7787D42D6 0CA982E2458AA0CC5A31B426D27B40D538C8DFD1 12E7506C5842B51BA0F6C3A9B0390158688D7CFA 16446628702AD87A369C63DA6F0D0FDD28B405D3 16F7E9E93D6CC469392AD0BA020A3F359DF98345 16F8469B848F9DCB4590BCC5CEA5F24980BDC806 1802AE6297FAC65BEF81401BB82207F8A40E5F7E 1A51BD3B4BC752D175CC5123E83C099F2A0D5004 1BF05882C1C103731DB2CA7E4D07302CEDED2256 1C5E0E941F46B5B0219C0893298688994D517236 1D8ED54EA9DF2D46558AD0096DD5D9DD297F13A8 1E5A7C498A9F085ACB12B6C10CC510E1426121E9 233864ABC44228059D8BC21058E45F586719050F 346019C3757C1649E7586F06A69993D68883D25F 38594065185DD418373F9AE365A8030DBC29EE64 38B63BB8DE8B63BBE634C8AB84E51BA733EBE874 3B50CF566B45E0BCC47FE90DE0A7103AF00C1B67 3C4814E9C1C4BD558A4D46B0DD848A0BDB7A159F 3FDD2586B98C33652F2F1512321EF43A5874C9AD 40F32747DA9C12CF59B7CAF2EA0FA918528C993B 4185C7D340B73B081F181C094B30032B59082BE3 4E1A81B90F4FB498EFB1CA023260C8BEC2E02083 56BF3B636ADF50B2013B3164EBEDE59D0C1C2ACE 5E99CA5F45A8757FACA7628278A08F8D6C1891E2 62652D3DB1D8CD7873E01BB4089545BE0567DE80 6DFBF0FF50456125AD98DE665CC60031863FEB98 8096EA61F733C3030351401944F54F254185098C 88F413062CF8A702B01F43BDEF9E43A2669A76EF 8CB33A002002ABAE3F3E2C91E006494FD64A09DD 8CB3BBC8CEEA91734CF2A275FA52FC55ECBC8A5B 9231DF741915AA1630031A93026D88726877E93A 94541F30DE462C066F4504D397C10776DFAD475F 9536B457F01F40696B131A72BC102343759F46AA 97FC02820912441BC2DFE3ACF433E455714B0AF5 9A9BC34468AC1677782E4E56B27D947A9C991E2E 9F7B124E664F37938B36ED0E73EECFF7D653C3B4 A5E3D05A4F44A915C429BF712334A4E28E46A10C AC9803701F9EE18194D40B38E47CE4C68CF2F567 BCEDF6C193AA687AE471B8A22EBF6BC57C2D285E C3636ECA4B40900056590AA7DBFC6ED09379852F CFEC81B97F6C15689ED8451C3DB0F8C399C01724 D50DF76982F0D2BFDB28A753079CDD63A192C32F D8C1E05325C108D848057F42A881D511CFB12409 D9065F9E57899B3D272AA212317AF61A9B14D204 DA379D7B0CD1F7CF2FB3F0AC64B54150E784BF5B DCAA1CED7183B561D18CF580BE9933BD9168D101 DFF328E9305A4D22AD19D1F9D54404F8DDCD85E5 E3DB2E354B883B59E8DC56B3E7A353DDFD457812 E41B16F7DDF52EBB1DB4268AB2FE340B37AD8904 E727D0B4179549BB3F82ED3C256F209E54CE0B23 EBDE762412D1F0D75338053F5A5A9B6EE053D642 F0A13CA98D8F392EE9FC3AF331DE0C3E69B073AD F7181ED08E1A2E564105C3620AFA0D78A131F4E5 FB61107EAC51E731334FD56FBD6C4C4A647714B9
On 11 May 2017, at 07:30, nusenu nusenu-lists@riseup.net wrote:
...
inline patch below (I can paste it to trac if you like)
Trac please, emails are easy to lose track of.
And we prefer branches if possible:
https://gitweb.torproject.org/tor.git/tree/doc/HACKING/CodingStandards.md#n1...
On 11 May 2017, at 07:54, nusenu nusenu-lists@riseup.net wrote:
nusenu:
no one is using nicknames anymore, or onionoo does not display fingerprints?) Are nicknames still supported?
Nicknames are supported, but deprecated, as multiple relays can have the same nickname.
correction, I found some nicknames in onionoo's alleged_family field of the following relays, so they use it, but didn't find any in effective_family. So it should be fine to use 'fingerprint' only in the documentation?
That's ok, there's no need to mention a deprecated, insecure feature.
...
T -- Tim Wilson-Brown (teor)
teor2345 at gmail dot com PGP C855 6CED 5D90 A0C5 29F6 4D43 450C BA7F 968F 094B ricochet:ekmygaiu4rzgsk6n xmpp: teor at torproject dot org ------------------------------------------------------------------------
Trac please, emails are easy to lose track of.
https://trac.torproject.org/projects/tor/ticket/22223
And we prefer branches if possible:
Actually I aimed for a github url for you but the import failed https://twitter.com/nusenu_/status/862364712570421249
so I made a quick 'n dirty version (instead of no version).
-
nusenu -
teor