Ticket #18620: control-spec.2.diff

File control-spec.2.diff, 1.1 KB (added by str4d, 3 years ago)

Patch to add HSFORGET command to control-spec.txt

  • control-spec.txt

    diff --git a/control-spec.txt b/control-spec.txt
    index a3c1647..7b3d2ee 100644
    a b  
    14611461
    14621462  [HSPOST was added in Tor 0.2.7.1-alpha]
    14631463
     14643.26. HSFORGET
     1465
     1466  The syntax is:
     1467    "HSFORGET" SP HSAddress [SP DescCookie] CRLF
     1468
     1469    HSAddress = 16*Base32Character
     1470    DescCookie = 22*Base64Character as specified in rend-spec.txt section 2.3.
     1471
     1472  This command clears any cached client state relating to the the given
     1473  HSAddress. It can be used to flush state that is likely to be stale before
     1474  trying to connect to a hidden service via an unstable network connection
     1475  (such as a mobile data connection).
     1476
     1477  If the HSAddress or descriptor cookie is invalid, a 513 error is returned and
     1478  the command is stopped. On success, Tor replies with "250 OK".
     1479
     1480  Examples:
     1481     C: HSFORGET ajkhdsfuygaesfaa
     1482     S: 250 OK
     1483
     1484     C: HSFORGET secretonion12345 aaaaaaaaaaaaaaaaaaaaaa
     1485     S: 250 OK
     1486
     1487  [HSFORGET was added in Tor 0.2.XXX]
     1488
    146414894. Replies
    14651490
    14661491  Reply codes follow the same 3-character format as used by SMTP, with the