hashcash - Online in de cloud

PROGRAMMA:

NAAM

hashcash - hashcash anti-spam / denial of service tegenmaatregel tool

KORTE INHOUD

Mint (creëren) postzegels:

hasjgeld -m [[ opties ] [ hulpbron ... ] ... ]

Check postzegels:

hasjgeld -c [[ opties ] -r hulpbron ... ] [ stempelen ...]

Speed schattingen:

hasjgeld -s [ opties ] [ -b stukjes ]

Zuivering databank:

hasjgeld -p nu [ -j hulpbron ] [ -k ] [ -t niet de tijd of ] [ -u ]

Tellen botsing stukjes:

hasjgeld -w [ opties ] [ stempelen ...]

Krijgen hulpbron naam:

hasjgeld -n [ opties ] [ stempelen ...]

Krijgen niet de tijd of resterende tot verstrijken

hasjgeld -l [ opties ] -e periode [ stempelen ...]

PRODUCTBESCHRIJVING

Hashcash is een hulpmiddel voor het meten van denial-of-service. Het belangrijkste huidige gebruik ervan is om te helpen
hashcash-gebruikers voorkomen dat ze e-mail verliezen dankzij op inhoud gebaseerde en op zwarte lijsten gebaseerde anti-spam
systemen.

Met de hashcash-tool kunt u hashcash-stempels maken die u kunt toevoegen aan e-mails die u verzendt, en
om hashcash-zegels te verifiëren die zijn gekoppeld aan e-mails die u ontvangt. E-mailafzenders voegen hashcash toe
postzegels met de X-Hashcash: header. Verkopers en auteurs van anti-spamtools worden aangemoedigd
om e-mail die met hashcash is verzonden uit te sluiten van hun zwarte lijsten en op inhoud gebaseerde filterregels.

Een hashcash-zegel vormt een proof-of-work dat een parametreerbare hoeveelheid werk vergt
berekenen voor de afzender. De ontvanger kan ontvangen zegels efficiënt verifiëren.

De hashcash proof-of-work-functie is om gedeeltelijke hash-botsingen te berekenen (de SHA1-hash
functie wordt gebruikt). Door het aantal botsbits te kiezen, is het werk dat nodig is om:
het berekenen van een botsing kan willekeurig duur worden gemaakt -- van fracties van een seconde tot
minuten of uren. De verificatie is efficiënt en vereist hoe dan ook dezelfde kleine kosten
de botsingsgrootte.

Voor een meer gedetailleerde bespreking van andere toepassingen is hashcash gebruikt voor zie
http://www.hashcash.org/

GEBRUIK OPMERKINGEN

In deze man-pagina is een resourcenaam de naam van de service of het adres waarop de stempel staat
gemaakt voor. In het geval van e-mail is de bronnaam het e-mailadres van de ontvanger in
het formulier [e-mail beveiligd].

Muntslagen postzegels

De -m vlag moet worden gegeven om een ​​postzegel te slaan.

De naam van de bron (het e-mailadres van de ontvanger) waartegen de stempel moet worden geslagen, kan worden doorgegeven als
een argument, of, indien weggelaten, wordt gelezen uit stdin. Als stdin een tty is, wordt de gebruiker gevraagd of
stdin is een pijp de naam van de resource wordt gewoon stil gelezen. De gewenste botsingsgrootte kan
gespecificeerd worden met de -b optie. Als er geen botsingsgrootte is opgegeven, is de standaard 20
stukjes. Zie ook de -b verzuim optie.

Controleren postzegels

De -c vlag moet worden gegeven om de vervaldatum van een postzegel te controleren. De te controleren stempel kan worden gegeven als een
argument tegen "hashcash". Als er geen stempel wordt gegeven, wordt de stempel gelezen uit stdin. Als stdin een is
tty wordt de gebruiker gevraagd, als stdin een pijp is, wordt de stempel gewoon stil gelezen. EEN
bronnaam (het e-mailadres van de ontvanger) kan worden gegeven met de -r optie. Als een
resourcenaam wordt gegeven de resourcenaam wordt vergeleken met de resourcenaam in de stempel, als
ze niet overeenkomen, wordt de postzegel afgewezen.

Opmerking: als er geen resourcenaam wordt gegeven, wordt de stempel toch gecontroleerd om te zien of het anders is
geldig, maar het kan worden geslagen voor een andere bron, waardoor postzegels kunnen worden
hergebruikt voor verschillende bronnen, dus hashcash retourneert een niet-aangevinkte afsluitcode bij het afsluiten.

Stempels worden standaard beschouwd als geldig voor 28 dagen. De geldigheidsduur kan zijn:
gewijzigd met de -e vlag.

Als de stempel is verlopen of een datum in de toekomst heeft, wordt de stempel afgewezen en wordt het programma
vertrekt onmiddellijk.

Als een vereiste botsingsgrootte wordt gegeven met de -b vlag, de waarde van de postzegels wordt berekend en
vergeleken, als de postzegel onvoldoende waarde heeft, wordt deze afgewezen en wordt het programma afgesloten
direct. Als de -b vlag wordt niet gegeven, de stempel wordt gecontroleerd om te zien of het anders is
geldig, maar hashcash retourneert de niet-aangevinkte exit-code bij het afsluiten.

Als de zegel dubbel wordt uitgegeven, wordt de zegel afgewezen. Bescherming tegen dubbele uitgaven is:
hieronder in meer detail besproken in "Dubbele uitgavenbescherming". Als dubbele uitgaven
bescherming is niet ingeschakeld, de postzegel kan dubbel worden uitgegeven, dus hashcash komt terug
niet-aangevinkte exit-code (exit-code 2) bij exit.

De -w vlag kan worden gebruikt om te vragen dat het aantal bits van de botsing wordt geteld
en weergegeven. De -n vlag kan worden gebruikt om te vragen dat de resourcenaam in de stempel is
ontleed en weergegeven. De -l vlag kan worden gebruikt om het aantal seconden op te vragen tot
vervaldatum van de stempel wordt uitgevoerd.

Het programma retourneert alleen geldige of ongeldige exit-codes als de -c vlag wordt gebruikt, de -b
vlag wordt gebruikt, -d, -r hulpbron worden gebruikt. Dit zijn de minimale set opties die nodig zijn om:
controleer de geldigheid van een stempel volledig. Als niet aan deze criteria wordt voldaan, zal het programma
return exit code niet aangevinkt (exit code 2) bij exit. (Zie ook de -y vlag.)

Dubbel Uitgaven Bescherming

Indien de -d vlag wordt gebruikt bij het controleren van zegels, wordt een database met gebruikte zegels bijgehouden.

Standaard verlopen postzegels na 28 dagen, zonder vervaldatum zou de database groeien
voor onbepaalde tijd. U kunt een alternatieve vervalperiode specificeren met de -e vlag. De
aanbevolen (en standaard) vervaltermijn voor e-mail is 28 dagen. Na de vervaltermijn
tijd, wordt de stempel hoe dan ook als verlopen beschouwd en kan deze uit de database worden verwijderd
om ruimte te besparen. (Zie "Periodiek opschonen versus bij volgende toegang" voor informatie over het opschonen van stempels.)

Om efficiëntieredenen wordt een stempel gecontroleerd voordat het in de database wordt gecontroleerd; als het is
anders ongeldig zal er geen database-activiteit plaatsvinden.

Opmerking: De beslissing over hoe lang de zegel geldig moet zijn, is aan de
verificateur. Als het te kort is, is het voor sommige toepassingen mogelijk dat de stempel zal
verlopen voordat ze bij de ontvanger aankomen (bijvoorbeeld met e-mail.) De voorgestelde waarde van 28 dagen
moet veilig zijn voor normale vertragingen bij de levering van e-mail. De keuze is een afweging tussen
grootte van de database en het risico van verlopen vóór aankomst, en is afhankelijk van de toepassing.

Opmerking: verschillende zegels in dezelfde database kunnen verschillende geldigheidsperioden hebben, dus voor:
voorbeeldzegels voor verschillende bronnen met verschillende geldigheidsperioden kunnen worden opgeslagen in
dezelfde database, of de ontvanger kan de geldigheidsperiode voor toekomstige postzegels wijzigen
zonder de geldigheid van oude zegels aan te tasten.

Doorspoelen Periodiek vs on Volgende Toegang tot

Om oude postzegels periodiek te verwijderen terwijl u postzegels controleert, gebruikt u de -p periode optie om te zuiveren
niet eerder dan de opgegeven tijdsperiode sinds de laatste zuivering. Zuiveren kan worden gebruikt met de
-k optie om niet-verlopen zegels ook te wissen, en met de -j hulpbron vlag om alleen te wissen
stempels voor de gegeven bron.

Er zijn omstandigheden waarin het onhandig kan zijn om stempels te wissen bij de volgende toegang,
bijvoorbeeld als er een grote database met dubbele uitgaven is die enige tijd nodig heeft om op te schonen, en
de responstijd van de hashcash checker is belangrijk. Om dit probleem te voorkomen, kunt u het volgende doen:
kan afzonderlijk worden gedaan met alleen de -p nu optie om alleen de zuiveringsbewerking aan te vragen.
Op Unix zou je bijvoorbeeld één keer per dag "hashcash -p now" in een cronjob kunnen aanroepen, of op
vraag wanneer de schijf bijna leeg was.

Speed schattingen

De -s vlag vraagt ​​meting van hoeveel botsingen per seconde kunnen worden getest. Nee
stempel is geslagen of geverifieerd.

Indien de -b vlag wordt gebruikt met deze optie, in plaats daarvan een schatting van hoeveel seconden het zou
nemen om een ​​zegel van de opgegeven grootte in bits te slaan, wordt berekend. Om erachter te komen hoeveel tijd het is
duurt om een ​​standaardformaat stempel te gebruiken -s -b verzuim.

Opmerkingen

Alle informatieve output wordt afgedrukt op stderr. Geslagen postzegels, en resultaten van postzegel
verificatie en timing zijn afgedrukt op stdout. De stille vlag -q onderdrukt alles
informatieve uitgang. De -v vlag vraagt ​​om meer informatieve output. Het gevraagde
output, wat de enige informatie is die wordt uitgevoerd in de stille modus (wanneer -q is gespecificeerd)
wordt afgedrukt op standaarduitvoer. Als stdout een pijp is, of wanneer de stille modus actief is, is de
output wordt afgedrukt zonder beschrijving (dwz alleen bits, slechts seconden, alleen resource).

OPTIES

-c Controleer de vervalgegevens van zegels die als argument of op stdin worden gegeven. (Gebruiken met
-b, -d en -r hulpbron om zegels volledig te controleren).

-m Muntzegels met de middelen die als argumenten of op stdin worden gegeven.

-b stukjes
Maak bij het slaan van een postzegel een botsing van minstens zoveel bits. Bij het verifiëren van een
stempel vereisen dat het een botsing heeft van minimaal zoveel bits, anders weigeren
het. Indien weggelaten wordt de standaardwaarde gebruikt.

Bij het controleren van postzegels moet u ervoor zorgen dat de postzegels zoveel bits hebben.

Het standaard aantal bits kan worden gespecificeerd met -b verzuim. Bits ten opzichte van de
standaard kan ook worden opgegeven met -b +n voor n bits meer dan de standaard en -b -n
voor n bits minder dan de standaardwaarde.

-b verzuim, -b +0 en -b -0 zijn allemaal gelijkwaardig.

Bij het doen van de snelheidstest -s, kan om de snelheid van het standaardtoken te meten met -s -b
verzuim.

-r hulpbron
Bij het slaan van postzegels, de naam van de bron (e-mailadres van de ontvanger) om de postzegel te slaan
tegen kan worden gegeven met -r hulpbron of als argument voor "hashcash".

Bij het controleren van postzegels wordt de bronnaam (uw eigen e-mailadres) gegeven met de -r
optie. Als de resourcenaam is opgegeven, wordt deze vergeleken met de resourcenaam in de
stempel, en als ze niet overeenkomen, wordt de stempel afgewezen. Let op als de resourcenaam is
niet gegeven, worden zegels voor andere bronnen geaccepteerd, en daarom hashcash
retourneert exit code uitgeschakeld (exit code 2) bij exit.

-o Bij het verifiëren van zegels kunnen meerdere bronnen worden opgegeven. Standaard zijn de bronnen:
net een voor een gecontroleerd totdat een overeenkomende geldige bron is gevonden. Maar wanneer je
gebruik jokertekens of reguliere expressies (zie -E), is het handig om te kunnen specificeren dat
de ene bron overschrijft de andere. Bijvoorbeeld dit: -b15 -r [e-mail beveiligd] -o -b10
*@dev.null stelt dat mail naar adres [e-mail beveiligd] vereist 15 bits, maar mail naar
*@dev.null vereist slechts 10 bits. Als we de . weglaten -o overschrijven relatie tussen
de twee bronnen, zou een stempel van 10 bits worden geaccepteerd voor adres [e-mail beveiligd]
omdat hoewel het zou worden afgewezen omdat het onvoldoende bits heeft onder de eerste regel,
het zou worden geaccepteerd onder de 2e regel. De -o optie kunt u dit probleem vermijden.

-e niet de tijd of
Vervaltermijn voor gebruikte zegels. Tijdens het controleren van postzegels (met de -c vlag), als de
stempel meer dan de opgegeven hoeveelheid tijd geleden is geslagen, wordt deze als verlopen beschouwd.
Als deze optie niet wordt gebruikt, verlopen postzegels standaard na 28 dagen. De vervaltermijn
wordt standaard in seconden gegeven (een argument van 0 betekent voor altijd). Een enkel teken
achtervoegsel kan worden gebruikt om alternatieve eenheden te specificeren (m = minuten, h = uren, d = dagen, M =
maanden, y = Y = jaar en s = seconden).

Indien gebruikt met de -d optie, worden de gebruikte zegel en de vervalperiode geregistreerd in de
databank. Zie de -p optie voor een beschrijving van het verwijderen van postzegels uit de database.

Tijdens het slaan van postzegels, -e vlag kan een effect hebben op de resolutie van de gecreëerde tijd
op de postzegel. Zonder de -e optie, is de standaardresolutie dagen (tijdnotatie:
JJMMDD). Alternatieve formaten op basis van het bereik van de vervalperiode zijn als volgt:

Tijdens het minten kun je ook een expliciete tijdsbreedte meegeven met de -z optie in plaats daarvan.
(-z overschrijvingen -e als beide worden gegeven. Als geen van beide wordt gegeven, is de standaard 6 tekens (tijd
formaat: JJMMDD)).

De regels voor het automatisch bepalen van de juiste tijdbreedte van -e als Nee -z optie
wordt gegeven zijn:

* periode >= 2 jaar, dan wordt tijdnotatie YY gebruikt, naar beneden afgerond op het dichtstbijzijnde jaar
begin;
* 2 jaar < periode <= 2 maanden, daarna wordt tijdnotatie JJMM gebruikt, naar beneden afgerond op
dichtstbijzijnde start van de maand;
* 2 maanden < periode <= 2 dagen, daarna wordt de tijdnotatie JJMMDD gebruikt, naar beneden afgerond op de
begin van de dichtstbijzijnde dag;
* 2 dagen < periode <= 2 minuten, daarna wordt de tijdnotatie JJMMDDuumm gebruikt, naar beneden afgerond op de
begin van de dichtstbijzijnde minuut;
* periode < 2 minuten, daarna wordt het tijdformaat JJMMDDuummss gebruikt in seconden.

Merk op dat de afronding naar beneden is gebaseerd op UTC-tijd, niet op lokale tijd. Dit kan leiden tot
aanvankelijk verrassende resultaten bij afronding naar bijv. dagen in andere tijdzones dan GMT
(UTC = GMT). Het kan duidelijker zijn om te begrijpen als u de -u optie.

-z Breedte
De -z optie is voor gebruik tijdens het slaan en stelt de gebruiker in staat om de breedte van de tijdsbreedte te kiezen
veld. Zie ook de -e optie gegeven in combinatie met -m een impliciete specificeren
tijdveldbreedte onder de beschrijving van de -e vlag. Geldige breedtes zijn 6,10 of 12
tekens die respectievelijk overeenkomen met: JJMMDD, JJMMDDuumm en JJMMDDuummss naar beneden afgerond
naar respectievelijk de dichtstbijzijnde dag of minuut.

Merk op dat de afronding naar beneden is gebaseerd op UTC-tijd, niet op lokale tijd. Dit kan leiden tot
aanvankelijk verrassende resultaten bij afronding naar bijv. dagen in andere tijdzones dan GMT
(UTC = GMT). Het kan duidelijker zijn om te begrijpen als u de -u optie.

-g periode
De -g optie is voor gebruik bij het controleren van hashcash-zegels met de -c optie en
specificeert een respijtperiode voor het scheeftrekken van de klok, dat wil zeggen als een hashcash-stempel arriveert met een datum in
de toekomst of in het verleden zal niet worden afgewezen omdat het een futuristische datum heeft (of als
verlopen) tenzij het meer futuristisch is (of al langer is verlopen) dan dit
punt uit. De standaard is 2 dagen, wat betekent dat de klok van het verzendende systeem
niet meer dan 2 dagen (of 2 dagen achter) op de klok van het ontvangende systeem, de
hashcash-stempel wordt nog steeds geaccepteerd.

De standaardeenheden voor respijtperiode zijn seconden. Er kan een achtervoegsel van één teken worden gebruikt
om alternatieve eenheden te specificeren (m = minuten, h = uren, d = dagen, M = maanden, y = Y =
jaar, en s = seconden).

-d Bewaar postzegels in een database met dubbele uitgaven. Als de postzegel eerder is gezien, zal het zijn
afgewezen, zelfs als het anderszins geldig is. Het standaard databasebestand is database.sdb in
de huidige map. Alleen anders geldige zegels worden in de database opgeslagen.
Alleen volledig gevalideerde zegels worden in de database opgeslagen, tenzij de -y Optie is
gegeven.

-f dbnaam
Te gebruiken dbnaam in plaats van de standaard bestandsnaam voor database met dubbele uitgaven.

-p periode
Verwijdert de database van verlopen zegels als de opgegeven tijdsperiode is verstreken sinds de
de laatste keer dat het werd opgeruimd. voor het gemak -p nu is gelijk aan -p 0 waarvan beide
bedoel nu opschonen, ongeacht wanneer de database voor het laatst is opgeschoond.

Indien gebruikt in combinatie met -j hulpbron alleen de zegels geslagen voor de gegeven bron
zijn gezuiverd.

Indien gebruikt in combinatie met -k alle postzegels, zelfs niet-verlopen, worden verwijderd. Kan zijn
gebruikt in combinatie met -t niet de tijd of vervallen alsof de huidige tijd de gegeven tijd is.

-k Gebruik met optie -p om te verzoeken dat alle zegels worden verwijderd in plaats van alleen verlopen.

-j hulpbron
Gebruik met optie -p om te verzoeken dat alleen stempels die overeenkomen met de opgegeven resourcenaam zijn:
worden verwijderd, in plaats van de standaardinstelling die is om alle verlopen zegels te wissen. Als de
resourcenaam is de lege tekenreeks, alle stempels komen overeen (dit komt overeen met
het weglaten van de -j keuze).

Merk op -E, -M en -S type wedstrijdvlaggen zijn ook van toepassing op middelen gegeven met de -j
hulpbron vlag.

-s Druk alleen tijdsinformatie af en ga niet verder met het maken van een stempel. Indien gecombineerd met
-b stukjes vlag afdrukken schatting van hoe lang de gevraagde botsingsgrootte zou duren om
berekenen, als -s op zichzelf gegeven, drukt alleen de snelheid van de botsingzoeker af. Printen
een schatting van hoe lang het standaard aantal bits zou duren -b verzuim.

-h Korte gebruiksinformatie afdrukken.

-v Druk meer uitgebreide informatieve output af over het slaan of verifiëren van de postzegel. (Indien
-v is het enige argument, drukt het versienummer van het gereedschap af.)

-V Drukt het versienummer van het gereedschap af.

-q Batch-modus. Drukt geen andere informatie af dan uitvoer. Deze optie overschrijft de -v
optie.

-X Bij het slaan wordt de hashcash-e-mail X-header 'X-Hashcash:' vóór de postzegel afgedrukt.
Zonder deze optie wordt alleen de kale stempel gedrukt.

Bij het controleren, na het scannen van stempels die als argumenten zijn opgegeven, wordt stdin gescand op regels
beginnend met de string 'X-Hashcash:', en gebruikt de rest van de overeenkomende regel als de
stempel. Alleen de regels tot en met de eerste lege regel worden gescand (zie ook
-i vlag die kan worden gebruikt om dit te negeren). Een lege regel is het scheidingsteken dat wordt gebruikt om
scheid de kopteksten van de hoofdtekst van een e-mailbericht of USENET-artikel. Dit is bedoeld
om het gemakkelijk te maken om een ​​e-mailbericht of USENET-artikel door te sturen naar hashcash op stdin.

-x uitbreiding
Een extensietekenreeks die is samengesteld uit naamwaardesets. Het extensieformaat wordt beschreven
hieronder in het gedeelte over het hashcash-zegelformaat. Hiermee kunnen gebruikers hun
eigen postzegelextensies die in de postzegel worden gehasht, geverifieerd door ontvangers die:
ondersteunen, en genegeerd door ontvangers die ze niet ondersteunen. Let op de extensie
haakmechanisme is nog niet geïmplementeerd. Dit komt in een volgende release.

-i Bij het controleren en gebruiken van de -X vlag, negeer de lege regelgrens tussen kopteksten
en de hoofdtekst van het bericht, en controleer ook op een botsing in de hoofdtekst als er geen wordt gevonden
in de koppen.

-t niet de tijd of
Doe alsof de huidige tijd de tijd is die wordt gegeven voor het slaan van postzegels, om te verifiëren dat
postzegels en het verwijderen van oude postzegels uit de database. Tijd wordt gegeven in een formaat op basis van
UTCTIME-indeling JJMMDD[uumm[ss]].

Tijd wordt standaard uitgedrukt in lokale tijd. Gebruiken met -u vlag om tijd te geven in UTC
(GMT).

Je kunt ook tijd geven ten opzichte van de huidige tijd door het argument vooraf te laten gaan met +
of -. De standaardeenheden voor relatieve tijd zijn seconden. Een achtervoegsel van één teken kan
worden gebruikt om alternatieve eenheden te specificeren (m = minuten, h = uren, d = dagen, M = maanden, y =
Y = jaar, en s = seconden).

Let op: als de tijd wordt uitgedrukt in lokale tijd, als er zomertijd is in uw
tijdzone zijn er één of twee onduidelijke uren per jaar op het moment van wijziging van
zomertijd naar normale tijd.

-u Invoer en uitvoer absolute tijden in UTC (GMT) in plaats van lokale tijd.

-a periode
Optellen (of aftrekken als getal negatief is) een willekeurige waarde van de huidige tijd ervoor
het slaan van de postzegel. Dit verbergt de tijd waarop de stempel is gemaakt, wat handig kan zijn voor
anonieme gebruikers. Merk op dat het optellen (in plaats van aftrekken) van een willekeurige tijd riskant kan zijn als:
de postzegel duurt minder dan de extra tijd om aan te komen, omdat de ontvanger postzegels zal weigeren
met tijdstempels in de toekomst.

-n Naam van afdrukbron geparseerd van stempel wordt geverifieerd. Retourneert exit-code uitgeschakeld op
Uitgang.

-l Druk het aantal resterende seconden af ​​voordat de stempel verloopt. Retourneert exit-code uitgeschakeld op
Uitgang.

Let op: de berekening omvat de respijtperiode, dus deze kan tot 2 keer de respijtperiode zijn
langer dan je anders zou verwachten (klok snel maar systeem moet aannemen dat het zou kunnen)
wees langzaam). Als u de respijtperiode wilt uitsluiten, voeg dan toe -g0 om de respijtperiode in te stellen op 0
voor de berekening.

-w Print aantal bits van botsing van postzegel. Retourneert exit-code uitgeschakeld bij afsluiten.

-y Retourneert succes als de stempel geldig is, zelfs als deze niet volledig is gecontroleerd. Gebruiken met -c
waar niet allemaal -d, -r zijn opgegeven om een ​​succesvolle exit-code op geldig maar gedeeltelijk te krijgen
gecontroleerde stempel. Op dezelfde manier kan gebruiken met -n, -l, -w met hetzelfde effect.

-M Bij het controleren van postzegels, wildcard toestaan * overeenkomend in de resourcenaam om het te maken
eenvoudiger om meerdere e-mailadressen op te geven en om overeenkomende verzameladressen toe te staan
en adressen inclusief subdomeinen. Dit is de standaardinstelling. Zie ook -S, -E en -C

-S Gebruik bij het controleren van stempels eenvoudige tekstvergelijking om de namen van bronnen te vergelijken met die in
postzegels. Zie ook -M, -E en -C.

-E Gebruik bij het controleren van stempels reguliere expressies om resourcenamen op te geven om het te maken
eenvoudiger om meerdere e-mailadressen, verzameladressen, extensieklassen op te geven
adressen en adressen inclusief subdomeinen. Merk op dat de syntaxis van reguliere expressies POSIX is
stijl: speciale tekens hoeven niet te worden aangehaald om hun speciale betekenis te hebben; maar
ze moeten wel tussen \ aan dat teken in de gezochte string staan. De
reguliere expressie heeft automatisch ^ toegevoegd aan het begin en $ toegevoegd aan het einde,
als ze niet zijn gespecificeerd. De speciale tekens ^ komen overeen met het begin van de
resouce, en $ komt overeen met het einde van de resource.

(Merk op dat zelfs indien gecompileerd met reguliere BSD-expressies, de POSIX-stijlsyntaxis wordt gebruikt; ook:
opmerking BSD reguliere expressies ondersteunen geen bereiken {}.)

-C Standaard zijn bronnen gecanoniseerd naar kleine letters bij het slaan en controleren. De
-C vlag overschrijft dit zodat bronnen bij controle als hoofdlettergevoelig worden behandeld,
en niet heilig verklaard op het slaan.

-P Voortgangsinfo afdrukken (aantal iteraties, verwachte iteraties, percentage voltooid, best
tot nu toe gevonden postzegelformaat).

-O kern
Selecteer hashcash core met dat nummer. Momenteel zijn 0-9 geldige kernen. Niet alle kernen
werken aan alle architecturen. Sommige zijn bijvoorbeeld x86-specifieke assembler, andere PPC-specifiek
assembler. Als een kern niet geldig is, retourneert hashcash een fout en legt uit wat:
gebeurd.

-Z n
Comprimeer de stempel. Dit is een afweging tussen tijd en ruimte. Grotere postzegels zijn sneller, maar
misschien een beetje lelijk. Gebruik voor de snelste stempels (de standaardinstelling) -Z 0; voor gedeeltelijk
gecomprimeerde postzegels gebruiken -Z 1; gebruik voor zeer gecomprimeerde, maar ietwat trage stempels -Z 2.
(Opmerking: vanwege een laat ontdekte bug is -Z2 voorlopig hetzelfde als -Z1 totdat ik het kan repareren)
dat.)

Voorbeelden

Wij creëren postzegels

"hashcash -s"
Print timinginformatie over hoeveel botsingen de machine per seconde kan proberen.

"hashcash -sv"
Nauwkeuriger maar vrij langzame benchmarking van verschillende processorspecifieke minting
kleuren.

"hashcash -s -b standaard"
Druk af hoe lang het zou duren voordat de machine een botsing van standaardformaat zou berekenen (maar
bereken niet echt een botsing).

"hashcash -s -b 32"
Druk af hoe lang het zou duren voordat de machine een 32-bits botsing zou berekenen (maar niet doen)
daadwerkelijk een botsing berekenen).

"hashcash -m"
Een postzegel slaan. Vraagt ​​om resourcenaam en mint met standaardwaarde (aantal
botsingsbits).

"hashcash -m foo"
Compute-botsing op resource foo. Zal munt slaan met standaardwaarde (aantal botsingen)
stukjes).

"hashcash -m foo -b 10"
Bereken 10-bits botsing op resource foo.

"hashcash -a -3d"
Trek een willekeurige tijd tussen 0 dagen en 3 dagen af ​​van de aanmaaktijd van de stempel.
Dit is dezelfde fuzz-factor die door mixmaster wordt gebruikt om het risico op timing-correlaties te verminderen.

Onderzoeken Postzegels

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Rapporteer de waarde van de zegel (hoeveel bits van botsing) er zijn. Het voorbeeld is:
een 24-bits botsing, die gemiddeld 25 seconden duurt om te creëren op een 3Ghz P4.

"hashcash -mq -b 10 foo ⎪ hashcash -w"
Maak een stempel in batchmodus, geef het door aan hashcash op stdin om te verifiëren, laat het afdrukken hoe
veel stukjes waren er.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Rapporteer de resourcenaam van de stempel. De resourcenaam in het voorbeeld is foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Rapporteer hoe lang het duurt voordat de stempel verloopt als deze vervalt binnen 30 jaar vanaf de creatie ervan
datum. (Let op datums die te ver in de toekomst liggen, lopen tegen het einde van Epoch in 2038, dat is
de unix time analoog van de y2k bug).

Het verifiëren Postzegels

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Controleer of de stempel geldig is. Let op, want we controleren de zegel niet bij een dubbele uitgave
database, en specificeerde geen resourcenaam of vereist aantal botsingsbits
en hashcash beschouwt de zegel als niet volledig gecontroleerd en rapporteert deze als geldig
maar niet volledig uitgeschakeld, of als ongeldig als er een probleem is met de stempel.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Controleer of de waarde van de zegel groter of gelijk is aan 24 bits. Dit voorbeeld heeft 24
beetje waarde. Als u het gevraagde aantal bits verhoogt of de stempel vervangt door één
bij een botsing van minder dan 24 bits wordt de stempel geweigerd.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Controleer zoals hierboven of de zegel voldoende waarde heeft, maar controleer ook of de
gegeven resourcenaam komt overeen met de resourcenaam in de stempel.

Dubbel Uitgaven het voorkomen

De voorbeelden in "Stempels verifiëren" kunnen worden aangepast om een ​​database met dubbele uitgaven te behouden
zodat dezelfde postzegel niet twee keer wordt geaccepteerd. Let op een stempel wordt alleen ingecheckt
en toegevoegd aan de database als deze anderszins geldig en volledig gecontroleerd is (een vereist aantal
botsingsbits is opgegeven en een bron is opgegeven).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Controleer de stempel en voeg toe aan de dubbele uitgegeven database als deze geldig is (heeft de juiste bron)
naam en voldoende waarde).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Probeer de postzegel dubbel uit te geven. Het wordt afgewezen als dubbel uitgegeven.

Uitstansen houdbaarheid

Om te voorkomen dat de database met dubbele uitgaven voor onbepaalde tijd groeit, kan de ontvanger daarom verzoeken:
zegels niet ouder zijn dan een bepaalde periode. Na de vervaldatum kunnen oude zegels uit de
database met dubbele uitgaven omdat ze niet langer nodig zijn -- verlopen zegels kunnen worden geweigerd
puur gebaseerd op hun oude datum, dus de ruimte die wordt ingenomen door verlopen zegels in de dubbele uitgave
database kan worden opgeslagen zonder het risico te lopen een verlopen, maar verder geldige stempel te accepteren.

Het derde veld van de zegel is de UTC-tijd sinds 1 januari 1970. De standaardtijd
formaat is JJMMDD, tijd naar beneden afgerond op de dichtstbijzijnde dag. De standaard geldigheidsduur is 28
dagen.

U kunt een alternatieve geldigheidsduur opgeven met de -e optie.

"hashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Probeer een oude zegel te verifiëren, de bovenstaande zegel is gemaakt op 11 aug 2002.

We gaven optie -e 2d dus de vervaldatum van de postzegels is 2 dagen na aanmaak, wat nu is
in het verleden.

Let op: als de aanmaaktijd in de stempel in dagen wordt uitgedrukt, is de precieze aanmaak
datum is het begin van de gespecificeerde dag in UTC-tijd (vergelijkbaar voor alternatieve eenheden
de aanmaaktijd wordt naar beneden afgerond op het begin van de eenheid waarin deze wordt uitgedrukt).
Voor eenheden in dagen kan dit bijvoorbeeld, afhankelijk van uw tijdzone, betekenen dat de
stempel lijkt ongeldig te zijn binnen de opgegeven vervaltermijn in dagen
ten opzichte van uw relatieve weergave van welke dag het is, zoals de berekening is gebaseerd op
huidige tijd in UTC, en de aanmaaktijd van de stempel wordt uitgedrukt in UTC-tijd.

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Test of de stempel anders geldig is, behalve dat deze is verlopen. het weglaten van de -e
vertelt hashcash dat de stempel nooit zal verlopen. Een vervaltermijn van voor altijd kan ook
expliciet als volgt worden gegeven: -e 0, waarbij een vervalperiode van 0 voor altijd betekent.

Doorspoelen oud postzegels

Indien de -c, -d opties worden samen gebruikt, elke keer dat een stempel wordt gecontroleerd, of deze geldig is en
alle verplichte aspecten van de stempel zijn geverifieerd (controle van botsingsbits, resource
name check), dan worden de stempel en de vervalperiode naar het databasebestand geschreven. De
standaard vervaltermijn als er niet expliciet een vervaltermijn is opgegeven met de -e optie is 28
dagen (dwz zegels verlopen na 4 weken).

Eerst munt en daarna een stempel:

"hashcash -m -b 10 foo -e 1m > stempel"
Opmerking: in dit voorbeeld hebben we een vervaldatum bij het slaan gespecificeerd om ervoor te zorgen dat de stempel
aanmaaktijd wordt gegeven in een resolutie die hoog genoeg is in de stempel zodat de stempel dat niet zal doen
op het moment van creatie als verlopen worden beschouwd. (Onthoud dat de standaardresolutie in dagen is,
een stempel gemaakt met een aanmaaktijd naar beneden afgerond op het begin van de dag is
het is onwaarschijnlijk dat het 1 minuut later als geldig wordt beschouwd, tenzij je het om middernacht UTC munt
tijd.)

"hashcash -cd -e 1m -b 10 -r foo < stempel"
De stempel verloopt over 1 minuut. Wacht 1 minuut en vraag dan expliciet om dat verlopen
postzegels worden verwijderd:

"hashcash -p nu"
Probeer vervolgens dezelfde stempel opnieuw in te dienen:

"hashcash -cd -e 1m -b 10 -r foo < stempel"
en de postzegel wordt hoe dan ook afgewezen omdat deze is verlopen, wat illustreert waarom dit niet het geval was
nodig om deze stempel in de database te houden.

Met de standaarddatabase (het sdb-formaat) is de inhoud van de database door mensen leesbaar,
zodat u hun inhoud kunt bekijken door ze naar de terminal te sturen:

"kat hashcash.sdb"
om te zien dat de stempel echt is toegevoegd en vervolgens na het zuiveren vervolgens wordt verwijderd vanwege
verstrijken.

Doorspoelen oud postzegels on Vraag

Voor het gemak kunt u tegelijk met het controleren van de postzegels opschonen door gebruik te maken van de -p optie
met de -c optie.

"hashcash -m -b 10 foo > stempel"
"hashcash -cd -p nu -e 1 -b 10 -r foo < stempel"
Het kan inefficiënt zijn om bij elk gebruik stempels te verwijderen, aangezien de hele database moet worden
gescand op verlopen zegels. Door een tijdsperiode te geven aan de -p optie, je kunt het zien
"hashcash" om niet vaker te wissen dan in de periode sinds de vorige opschoning.

Bijvoorbeeld:

"hashcash -cd -p 1d -e 1 -b 10 -r foo < stempel"
vertelt "hashcash" om verlopen zegels niet meer dan één keer per dag te verwijderen.

"hashcash -p 1M -j foo"
vertelt "hashcash" om één keer per maand alleen verlopen postzegels die overeenkomen met de resource foo te verwijderen.

"hashcash -p nu -k"
vertelt "hashcash" om alle postzegels (verlopen en niet-verlopen) nu te verwijderen.

stempelen formaat (versie 1)

Het huidige postzegelformaat is versie 1. Deze tool kan hashcash versie 0 postzegels verifiëren
ook, maar versie 0-zegels worden niet langer gemaakt omdat ze worden uitgefaseerd ten gunste van
het meer uitbreidbare v1-stempelformaat.

ver:stukjes:gegevens:hulpbron:[ext]:rand:teller

WAAR

ver = 1
stukjes = hoeveel stukjes gedeeltelijke botsing de postzegel zou hebben
gegevens = JJMMDD[uumm[ss]]
hulpbron = resource string (bijv. IP-adres, e-mailadres)
ext = extensie -- genegeerd in de huidige versie
Formaat van extensie:

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Merk op dat de waarde ook = kan bevatten. Voorbeeldextensie (geen echte):

name1=2,3;name2;name3=var1=2,var2=3,2,val

Welke extensie naam1 zou zijn, heeft waarden 2 en 3; extensie naam2 heeft geen waarden;
extensie naam3 heeft 3 waarden "var1=2", "var2=3", "2" en "val". de hasj
extensie kan de waarden naar eigen inzicht interpreteren, bijvoorbeeld "var1=2" kan de waarde zijn
van een optie op de extensie name3.

rand = reeks willekeurige tekens uit het alfabet a-zA-Z0-9+/= om botsingen met . te voorkomen
postzegels van andere afzenders
teller = om een ​​stempel met het gewenste aantal botsingsbits te vinden, moet je veel proberen
verschillende strings wordt deze teller bij elke poging verhoogd. De teller bestaat ook uit:
tekens uit het alfabet a-zA-Z0-9+/=. (Let op: een implementatie is niet vereist om
opeenvolgend tellen).

Hashcash online gebruiken met onworks.net-services