hashcash - Online sa Cloud

PROGRAMA:

NAME

hashcash - hashcash anti-spam / denial of service counter-measure tool

SINOPSIS

Gawaan ng kuwaltang metal (lumikha) mga selyo:

hashcash -m [[ pagpipilian ] [ mapagkukunan ... ] ... ]

Tsek mga selyo:

hashcash -c [[ pagpipilian ] -r mapagkukunan ... ] [ tatakan ... ]

bilis mga pagtatantya:

hashcash -s [ pagpipilian ] [ -b bits ]

magpurga database:

hashcash -p ngayon [ -j mapagkukunan ] [ -k ] [ -t oras ] [ -u ]

Bilangin banggaan mga piraso:

hashcash -w [ pagpipilian ] [ tatakan ... ]

Magsimula mapagkukunan pangalan:

hashcash -n [ pagpipilian ] [ tatakan ... ]

Magsimula oras natitira hanggang pag-expire

hashcash -l [ pagpipilian ] -e panahon [ tatakan ... ]

DESCRIPTION

Ang Hashcash ay isang denial-of-service counter measure tool. Ang pangunahing kasalukuyang gamit nito ay ang tumulong
Iniiwasan ng mga gumagamit ng hashcash na mawalan ng email dahil sa content based at blacklist based na anti-spam
systems.

Ang hashcash tool ay nagbibigay-daan sa iyo na lumikha ng hashcash na mga selyo upang ilakip sa mga email na iyong ipinadala, at
para i-verify ang mga hashcash stamp na naka-attach sa mga email na natatanggap mo. Ang mga nagpapadala ng email ay naglalagay ng hashcash
mga selyo na may X-Hashcash: header. Hinihikayat ang mga vendor at may-akda ng mga anti-spam na tool
upang i-exempt ang mail na ipinadala gamit ang hashcash mula sa kanilang mga blacklist at content based na mga panuntunan sa pag-filter.

Ang isang hashcash stamp ay bumubuo ng isang proof-of-work na nangangailangan ng isang parameterizable na dami ng trabaho
para kalkulahin ang nagpadala. Maaaring i-verify ng tatanggap ang mga natanggap na selyo nang mahusay.

Ang hashcash proof-of-work function ay upang kalkulahin ang bahagyang pagbangga ng hash (ang SHA1 hash
ginagamit ang function). Sa pamamagitan ng pagpili ng bilang ng mga piraso ng banggaan, ang trabaho ay kinakailangan upang
makalkula ang isang banggaan ay maaaring gawing arbitraryong mahal -- mula sa mga fraction ng isang segundo hanggang
minuto o oras. Ang pag-verify ay mahusay na nangangailangan ng parehong maliit na halaga anuman
ang laki ng banggaan.

Para sa mas detalyadong talakayan ng iba pang mga application, ginamit ang hashcash para makita
http://www.hashcash.org/

PAGGAMIT NOTA

Sa man page na ito ang pangalan ng mapagkukunan ay ang pangalan ng serbisyo o address kung saan ang selyo
nilikha para sa. Sa kaso ng email, ang pangalan ng mapagkukunan ay ang email address ng tatanggap sa
ang form [protektado ng email].

Pagmimina selyo

Ang -m dapat ibigay ang watawat upang maglagay ng selyo.

Ang pangalan ng mapagkukunan (email address ng tatanggap) upang i-mint ang selyo ay maaaring ipasa bilang
isang argumento, o kung tinanggal ay binabasa mula sa stdin. Kung ang stdin ay isang tty ang user ay sinenyasan, kung
Ang stdin ay isang pipe na ang pangalan ng mapagkukunan ay tahimik na binabasa. Ang nais na laki ng banggaan ay maaaring
matukoy gamit ang -b na opsyon. Kung walang tinukoy na laki ng banggaan, ang default ay 20
bits. Tingnan din ang -b default pagpipilian.

Sinusuri selyo

Ang -c dapat ibigay ang watawat upang suriin ang pag-expire ng mga selyo. Ang selyo upang suriin ay maaaring ibigay bilang isang
argumento sa "hashcash". Kung walang ibinigay na selyo ang selyo ay binabasa mula sa stdin. Kung ang stdin ay a
tty ang user ay ipo-prompt, kung ang stdin ay isang pipe ang stamp ay tahimik lang na binabasa. A
pangalan ng mapagkukunan (email address ng tatanggap) ay maaaring ibigay kasama ng -r opsyon. Kung ang
pangalan ng mapagkukunan ay ibinigay ang pangalan ng mapagkukunan ay inihambing sa pangalan ng mapagkukunan sa stamp, kung
hindi sila magkatugma, ang selyo ay tinanggihan.

Tandaan: kung walang ibinigay na pangalan ng mapagkukunan, susuriin pa rin ang selyo upang makita kung ito ay iba
wasto, ngunit maaari itong i-minted para sa ibang mapagkukunan, na magpapahintulot sa mga selyo na maging
ginamit muli sa iba't ibang mapagkukunan, kaya ibabalik ng hashcash ang walang check na exit code sa paglabas.

Ang mga selyo ay bilang default na itinuturing na wasto sa loob ng 28 araw. Ang panahon ng bisa ay maaaring
binago gamit ang -e bandila.

Kung ang selyo ay nag-expire na o may petsa sa hinaharap ang selyo ay tatanggihan at ang programa
lalabas agad.

Kung ang isang kinakailangang laki ng banggaan ay ibinigay sa -b flag, ang halaga ng mga selyo ay nakalkula at
kumpara, kung ang selyo ay may hindi sapat na halaga ito ay tatanggihan, at ang programa ay lalabas
kaagad. Kung ang -b watawat ay hindi ibinigay, ang selyo ay nasuri upang makita kung ito ay kung hindi man
wasto, ngunit ibabalik ng hashcash ang walang check na exit code sa exit.

Kung ang selyo ay doble na ginugol ang selyo ay tatanggihan. Ang proteksyon sa dobleng paggastos ay
tinalakay nang mas detalyado sa ibaba sa "Dobleng Proteksyon sa Paggastos". Kung doble ang paggastos
hindi pinagana ang proteksyon, ang selyo ay maaaring dobleng ginastos, kaya babalik ang hashcash
walang check na exit code (exit code 2) sa exit.

Ang -w flag ay maaaring gamitin upang humiling na ang bilang ng mga bits ng banggaan ay mabibilang
at ipinakita. Ang -n maaaring gamitin ang flag para hilingin na ang pangalan ng mapagkukunan sa stamp ay
na-parse out at ipinakita. Ang -l maaaring gamitin ang flag para humiling ng bilang ng mga segundo hanggang
ang pag-expire ng selyo ay output.

Ibabalik lang ng program ang mga exit code na valid o invalid kung ang -c ginagamit ang watawat, ang -b
bandila ang ginagamit, -d, -r mapagkukunan ay ginamit. Ito ang pinakamababang hanay ng mga opsyon na kinakailangan upang
ganap na suriin ang bisa ng isang selyo. Kung hindi matugunan ang mga pamantayang ito, gagawin ng programa
ibalik ang exit code na walang check (exit code 2) sa exit. (Tingnan din ang -y bandila.)

Double Paggastos proteksyon

Kung ang -d ginagamit ang watawat kapag sinusuri ang mga selyo, pinapanatili ang isang database ng mga ginugol na selyo.

Bilang default, ang mga selyo ay mag-e-expire pagkalipas ng 28 araw, nang walang pag-expire ay lalago ang database
walang katiyakan. Maaari kang tumukoy ng kahaliling panahon ng pag-expire gamit ang -e bandila. Ang
ang inirerekomenda (at default) na panahon ng pag-expire para sa email ay 28 araw. Pagkatapos ng panahon ng pag-expire
Sa haba ng oras, ang selyo ay itinuturing pa rin na nag-expire at maaaring ma-purged mula sa database
para makatipid ng espasyo. (Tingnan ang "Purging Pana-panahon kumpara sa Susunod na Pag-access" para sa kung paano linisin ang mga selyo.)

Para sa kahusayan, ang isang selyo ay na-verify bago ito masuri sa database; kung ito ay
kung hindi ay hindi wasto walang aktibidad sa database ang magaganap.

Tandaan: Ang desisyon tungkol sa kung gaano katagal dapat ituring na wasto ang selyo ay nakasalalay sa
taga-verify. Kung ito ay masyadong maikli posible para sa ilang mga aplikasyon na gagawin ng selyo
mawawalan ng bisa bago dumating sa tatanggap (hal. sa email.) Ang iminungkahing halaga ng 28 araw
dapat ay ligtas para sa mga normal na pagkaantala sa paghahatid ng email. Ang pagpili ay isang trade-off sa pagitan
laki ng database at panganib ng pag-expire bago ang pagdating, at depende sa aplikasyon.

Tandaan: Ang iba't ibang mga selyo sa parehong database ay maaaring magkaroon ng iba't ibang panahon ng bisa, kaya para sa
Ang mga halimbawang selyo para sa iba't ibang mapagkukunan na may iba't ibang panahon ng bisa ay maaaring maimbak sa
ang parehong database, o maaaring baguhin ng tatanggap ang panahon ng bisa para sa mga selyo sa hinaharap
nang hindi naaapektuhan ang bisa ng mga lumang selyo.

Paglilinis Pana-panahon vs on susunod daan

Upang pana-panahong linisin ang mga lumang selyo habang sinusuri ang mga selyo, gamitin ang -p panahon pagpipilian upang linisin
hindi mas maaga kaysa sa ibinigay na yugto ng panahon mula noong huling paglilinis. Maaaring gamitin ang purging kasama ang
-k opsyon na linisin din ang mga hindi pa natatapos na selyo, at kasama ang -j mapagkukunan watawat upang linisin lamang
mga selyo para sa ibinigay na mapagkukunan.

May mga pagkakataon kung saan maaaring hindi maginhawang linisin ang mga selyo sa susunod na pag-access,
halimbawa kung mayroong isang malaking database ng dobleng gastos na tumatagal ng ilang oras upang linisin, at
ang oras ng pagtugon ng hashcash checker ay mahalaga. Upang maiwasan ang problemang ito, purging
maaaring gawin nang hiwalay gamit lamang ang -p ngayon opsyon na humiling lamang ng operasyon ng paglilinis.
Sa unix halimbawa maaari mong tawagan ang "hashcash -p ngayon" sa isang cron job isang beses bawat araw, o sa
demand kapag ubos na ang disk.

bilis Estimates

Ang -s ang bandila ay humihiling ng pagsukat kung gaano karaming mga banggaan ang maaaring masuri bawat segundo. Hindi
ang selyo ay ginawa, o na-verify.

Kung ang -b flag ay ginagamit sa pagpipiliang ito, sa halip ay isang pagtatantya kung gaano karaming mga segundo ang gagawin nito
take to mint isang stamp ng ibinigay na laki sa bits ay nakalkula. Para malaman kung gaano katagal
ay magdadala sa paggawa ng isang default na laki ng paggamit ng selyo -s -b default.

Mga Tala

Ang lahat ng output ng impormasyon ay naka-print sa stderr. Mga minted na selyo, at mga resulta ng selyo
ang pag-verify at timing ay naka-print sa stdout. Ang tahimik na bandila -q pinipigilan ang lahat
output ng impormasyon. Ang -v ang bandila ay humihiling ng higit pang impormasyon na output. Ang hiniling
output, na siyang tanging impormasyon na na-output sa mode na tahimik (kapag -q ay tinukoy)
ay naka-print sa karaniwang output. Kung ang stdout ay isang pipe, o kapag ang quiet mode ay gumagana ang
ang output ay naka-print nang walang paglalarawan (ibig sabihin, mga bit lamang, mga segundo lamang, mapagkukunan lamang).

Opsyon

-c Suriin ang impormasyon ng pag-expire ng mga selyo na ibinigay bilang argumento o sa stdin. (Gamitin kasama ang
-b, -d at -r mapagkukunan upang ganap na suriin ang mga selyo).

-m Mint stamp na may mga mapagkukunang ibinigay bilang mga argumento o sa stdin.

-b bits
Kapag nag-minting ng selyo, gumawa ng banggaan ng kahit gaano karaming piraso. Kapag nagpapatunay a
Kinakailangan ng stamp na mayroon itong banggaan na hindi bababa sa kasing dami ng mga piraso, kung hindi man ay tanggihan
ito. Kung tinanggal ang default ay ginagamit.

Kapag sinusuri ang mga selyo, hilingin na ang mga selyo ay may ganito karaming piraso.

Ang default na bilang ng mga bit ay maaaring tukuyin gamit ang -b default. Mga bit na nauugnay sa
ang default ay maaari ding tukuyin sa -b +n para sa n bit na higit pa sa default at -b -n
para sa n bit na mas mababa kaysa sa default.

-b default, -b +0 at -b -0 lahat ay katumbas.

Kapag gumagawa ng speed test -s, maaaring sukatin ang bilis ng default na token gamit ang -s -b
default.

-r mapagkukunan
Kapag gumagawa ng mga selyo, ang pangalan ng mapagkukunan (email address ng tatanggap) upang i-mint ang selyo
laban ay maaaring ibigay alinman sa -r mapagkukunan o bilang argumento sa "hashcash".

Kapag sinusuri ang mga selyo, ang pangalan ng mapagkukunan (iyong sariling email address) ay ibinibigay kasama ng -r
opsyon. Kung ang pangalan ng mapagkukunan ay ibinigay ito ay nasuri laban sa pangalan ng mapagkukunan sa
selyo, at kung hindi tumugma ang selyo ay tatanggihan. Tandaan kung ang pangalan ng mapagkukunan ay
hindi ibinigay, ang mga selyo para sa iba pang mapagkukunan ay tatanggapin, at samakatuwid ay hashcash
ibinabalik ang exit code na walang check (exit code 2) sa exit.

-o Kapag nagbe-verify ng mga selyo, maraming mapagkukunan ang maaaring ibigay. Bilang default, ang mga mapagkukunan ay
suriin lamang ng isa-isa hanggang sa makita ang isang katugmang wastong mapagkukunan. Gayunpaman kapag ikaw
gumamit ng mga wildcard o regular na expression (tingnan -E), ito ay kapaki-pakinabang upang matukoy iyon
ang isang mapagkukunan ay nangingibabaw sa isa pa. Halimbawa ito: -b15 -r [protektado ng email] -o -b10
*@dev.null nagsasaad na mail to address [protektado ng email] nangangailangan ng 15 bits, ngunit i-mail sa
*@dev.null nangangailangan lamang ng 10 bits. Kung tinanggal natin ang -o i-override ang relasyon sa pagitan ng
ang dalawang mapagkukunan, isang stamp ng 10 bits ay tatanggapin para sa address [protektado ng email]
dahil habang ito ay tatanggihan bilang hindi sapat na mga piraso sa ilalim ng unang panuntunan,
ito ay tatanggapin sa ilalim ng 2nd rule. Ang -o pinapayagan ka ng opsyon na maiwasan ang problemang ito.

-e oras
Panahon ng pag-expire para sa mga ginugol na selyo. Habang sinusuri ang mga selyo (gamit ang -c bandila), kung ang
ang selyo ay ginawa nang higit sa tinukoy na tagal ng panahon ang nakalipas, ito ay itinuturing na nag-expire na.
Kung hindi ginagamit ang opsyong ito, bilang default, mag-e-expire ang mga selyo pagkalipas ng 28 araw. Ang panahon ng pag-expire
ay ibinigay sa mga segundo bilang default (ang argumento ng 0 ay nangangahulugang magpakailanman). Isang karakter
maaaring gamitin ang suffix upang tukuyin ang mga kahaliling unit (m = minuto, h = oras, d = araw, M =
buwan, y = Y = taon, at s = segundo).

Kung gagamitin sa -d opsyon, ang ginugol na selyo at ang panahon ng pag-expire nito ay naitala sa
database. Tingnan ang -p opsyon para sa paglalarawan kung paano i-purge ang mga selyo mula sa database.

Habang gumagawa ng mga selyo, ang -e Ang bandila ay maaaring magkaroon ng epekto sa paglutas ng oras na nilikha
sa selyo. Kung wala ang -e opsyon, ang default na resolution ay mga araw (format ng oras:
YYMMDD). Ang mga alternatibong format batay sa hanay ng panahon ng pag-expire ay ang mga sumusunod:

Habang nagmi-minting maaari ka ring magbigay ng tahasang lapad ng oras kasama ang -z opsyon sa halip.
(-z overrides -e kung pareho ang binigay. Kung wala ang ibinigay na default ay 6 na karakter (time
format: YYMMDD)).

Ang mga patakaran para sa awtomatikong pagtukoy ng naaangkop na lapad ng oras mula sa -e kung hindi -z opsyon
ay ibinigay ay:

* panahon >= 2 taon pagkatapos ay ginagamit ang format ng oras na YY na bilugan pababa sa pinakamalapit na taon
simulan;
* 2 taon < panahon <= 2 buwan pagkatapos ay ginagamit ang format ng oras na YYMM na bilugan pababa sa
pinakamalapit na simula ng buwan;
* 2 buwan < panahon <= 2 araw pagkatapos ay ginagamit ang format ng oras na YYMMDD na bilugan pababa sa
simula ng pinakamalapit na araw;
* 2 araw < panahon <= 2 minuto pagkatapos ay ginagamit ang format ng oras na YYMMDDhhmm na bilugan pababa sa
simula ng pinakamalapit na minuto;
* tagal < 2 minuto pagkatapos ay ginagamit ang format ng oras na YYMMDDhhmmss sa mga segundo.

Tandaan na ang pag-round down ay batay sa oras ng UTC, hindi sa lokal na oras. Ito ay maaaring humantong sa
sa una ay nakakagulat na mga resulta kapag ni-round down sa hal. araw sa mga time zone maliban sa GMT
(UTC = GMT). Maaaring mas malinaw na maunawaan kung gagamitin mo ang -u pagpipilian.

-z lapad
Ang -z ang opsyon ay para sa paggamit sa panahon ng pagmimina at nagbibigay-daan sa pagpili ng user ng lapad ng lapad ng oras
patlang. Tingnan din ang -e opsyon na ibinigay kasama ng -m upang tukuyin ang isang implicit
lapad ng field ng oras sa ilalim ng paglalarawan ng -e bandila. Ang mga wastong lapad ay 6,10 o 12
mga character na naaayon ayon sa pagkakabanggit sa: YYMMDD, YYMMDDhhmm, at YYMMDDhhmmss na bilugan pababa
sa pinakamalapit na araw, o minuto ayon sa pagkakabanggit.

Tandaan na ang pag-round down ay batay sa oras ng UTC, hindi sa lokal na oras. Ito ay maaaring humantong sa
sa una ay nakakagulat na mga resulta kapag ni-round down sa hal. araw sa mga time zone maliban sa GMT
(UTC = GMT). Maaaring mas malinaw na maunawaan kung gagamitin mo ang -u pagpipilian.

-g panahon
Ang -g ang opsyon ay para sa paggamit kapag sinusuri ang mga hashcash stamp gamit ang -c pagpipilian at
tumutukoy ng palugit para sa clock skew, ibig sabihin, kung may dumating na hashcash stamp na may petsa sa
ang hinaharap o sa nakaraan ay hindi ito tatanggihan bilang may futuristic na petsa (o bilang
na nag-expire) maliban kung ito ay mas futuristic (o mas matagal nang nag-expire) kaysa dito
panahon. Ang default ay 2 araw, ibig sabihin hangga't ang orasan ng nagpapadalang system ay
hindi hihigit sa 2 araw bago (o 2 araw sa huli) ng relo ng sistema ng pagtanggap, ang
tatanggapin pa rin ang hashcash stamp.

Ang mga default na unit para sa palugit na panahon ay mga segundo. Maaaring gumamit ng solong character na suffix
upang tukuyin ang mga kahaliling unit (m = minuto, h = oras, d = araw, M = buwan, y = Y =
taon, at s = segundo).

-d Mag-imbak ng mga selyo sa database ng dobleng gastos. Kung ang selyo ay nakita na bago ito ay magiging
tinanggihan kahit na ito ay may bisa. Ang default na file ng database ay database.sdb in
ang kasalukuyang direktoryo. Tanging kung hindi man wastong mga selyo ang maiimbak sa database.
Tanging ang mga ganap na napatunayang selyo lamang ang itatabi sa database, maliban kung ang -y Ang opsyon ay
binigay

-f dbname
paggamit dbname sa halip na default na filename para sa double spend database.

-p panahon
Nililinis ang database ng mga nag-expire na selyo kung lumipas na ang ibinigay na yugto ng panahon mula noong
huling beses itong napurga. Bilang kaginhawaan -p ngayon ay katumbas ng -p 0 kapwa nito
ibig sabihin ng paglilinis ngayon, anuman ang huling na-purge ang database.

Kung ginamit kasabay ng -j mapagkukunan tanging ang mga selyo na ginawa para sa ibinigay na mapagkukunan
ay nililinis.

Kung ginamit kasabay ng -k lahat ng mga selyo maging ang mga hindi pa natatapos na mga selyo ay nililinis. Ay maaaring maging
ginamit kasama ng -t oras mag-expire na parang ang kasalukuyang oras ay ang ibinigay na oras.

-k Gamitin na may opsyon -p na humiling na ang lahat ng mga selyo ay napurga sa halip na mga nag-expire na lamang.

-j mapagkukunan
Gamitin na may opsyon -p upang humiling na ang mga selyong tumutugma lamang sa ibinigay na pangalan ng mapagkukunan ay upang
purged, sa halip na ang default na kung saan ay upang linisin ang lahat ng nag-expire na mga selyo. Kung ang
Ang pangalan ng mapagkukunan ay ang walang laman na string, lahat ng mga selyo ay tumutugma (ito ay katumbas ng
tinatanggal ang -j pagpipilian).

Tandaan ang -E, -M at -S uri ng mga flag ng tugma ay nalalapat din sa mga mapagkukunang ibinigay kasama ang -j
mapagkukunan bandila.

-s Mag-print lamang ng impormasyon sa timing, at huwag magpatuloy sa paggawa ng stamp. Kung isasama sa
-b bits pagtatantya ng flag print kung gaano katagal ang hinihiling na laki ng banggaan
kalkulahin, kung -s na ibinigay ng sarili nito, nagpi-print lamang ng bilis ng tagahanap ng banggaan. Upang i-print
isang pagtatantya kung gaano katagal gagamitin ang default na bilang ng mga bit -b default.

-h Mag-print ng maikling impormasyon sa paggamit.

-v Mag-print ng mas maraming verbose na output ng impormasyon tungkol sa paggawa ng stamp o pag-verify. (Kung
-v ay ang tanging argumento, nagpi-print ng numero ng bersyon ng tool.)

-V Nagpi-print ng numero ng bersyon ng tool.

-q Batch mode. Walang nai-print na impormasyon maliban sa output. Ino-override ng opsyong ito ang -v
pagpipilian.

-X Kapag minting, ipi-print ang hashcash email X-header 'X-Hashcash: ' bago ang stamp.
Kung wala ang pagpipiliang ito, ang hubad na selyo lamang ang naka-print.

Kapag sinusuri, pagkatapos i-scan ang mga selyong ibinigay bilang mga argumento, ini-scan ang stdin para sa mga linya
nagsisimula sa string na 'X-Hashcash:', at ginagamit ang natitirang linya ng pagtutugma bilang ang
selyo. Tanging ang mga linya hanggang sa at nagtatapos sa unang blangko na linya ang na-scan (tingnan din
-i bandila na maaaring magamit upang i-override ito). Ang isang blangkong linya ay ang separator na ginamit
paghiwalayin ang mga header mula sa katawan ng isang mensaheng mail o artikulo ng USENET. Ito ay sinadya
upang gawing maginhawa ang pag-pipe ng isang mensaheng mail o artikulo ng USENET sa hashcash sa stdin.

-x karugtong
Isang extension string na binubuo ng mga hanay ng halaga ng pangalan. Inilarawan ang format ng extension
sa ibaba sa seksyon sa format ng hashcash stamp. Nagbibigay-daan ito sa mga user na tukuyin ang kanilang
sariling mga extension ng selyo na na-hash sa stamp, na na-verify ng mga tatanggap na
suportahan sila, at hindi pinansin ng mga tatanggap na hindi sumusuporta sa kanila. Tandaan ang extension
Ang mekanismo ng kawit ay hindi pa naipatupad. Darating ito sa kasunod na paglabas.

-i Kapag sinusuri at ginagamit ang -X bandila, huwag pansinin ang blangko na hangganan ng linya sa pagitan ng mga header
at katawan ng mensahe, at suriin din kung may banggaan sa katawan kung hindi matagpuan
sa mga header.

-t oras
Magpanggap na ang kasalukuyang oras ay ang oras na ibinigay para sa mga layunin ng paggawa ng mga selyo, pagbe-verify
mga selyo at paglilinis ng mga lumang selyo mula sa database. Ang oras ay ibinibigay sa isang format batay sa
UTCTIME format YYMMDD[hhmm[ss]].

Ang oras ay ipinahayag sa lokal na oras bilang default. Gamitin kasama ang -u bandila para magbigay ng oras sa UTC
(GMT).

Maaari ka ring magbigay ng oras na nauugnay sa kasalukuyang oras sa pamamagitan ng paglalagay ng prefix sa argumento na may +
o -. Ang mga default na unit para sa relatibong oras ay mga segundo. Maaari ang isang solong character na suffix
gagamitin upang tukuyin ang mga kahaliling unit (m = minuto, h = oras, d = araw, M = buwan, y =
Y = taon, at s = segundo).

Tandaan: kapag ang oras ay ipinahayag sa lokal na oras, kung mayroong daylight savings sa iyong
timezone, mayroong isa o dalawang hindi maliwanag na oras bawat taon sa oras ng pagbabago mula sa
daylight savings time sa normal na oras.

-u Input at output absolute times sa UTC (GMT) sa halip na lokal na oras.

-a panahon
Magdagdag (o ibawas kung negatibo ang numero) ng random na halaga mula sa kasalukuyang oras bago
pagmimina ng selyo. Itinatago nito ang oras na ginawa ang selyo, na maaaring maging kapaki-pakinabang para sa
hindi kilalang mga gumagamit. Tandaan na ang pagdaragdag (sa halip na pagbabawas) ng random na oras ay maaaring mapanganib kung
ang selyo ay tumatagal ng mas kaunti kaysa sa idinagdag na oras bago dumating dahil tatanggihan ng tatanggap ang mga selyo
na may mga time stamp sa hinaharap.

-n Pangalan ng mapagkukunan ng pag-print na na-parse mula sa selyo na na-verify. Ibinabalik ang exit code na walang check
lumabas.

-l I-print ang bilang ng mga segundo na natitira bago mag-expire ang selyo. Ibinabalik ang exit code na walang check
lumabas.

Tandaan: kasama sa kalkulasyon ang palugit, kaya maaaring hanggang 2 beses na palugit
mas mahaba kaysa sa maaari mong asahan (mabilis ang orasan ngunit kailangang isipin ng system na magagawa nito
maging mabagal). Kung gusto mong ibukod ang panahon ng palugit idagdag -g0 upang itakda ang palugit na panahon sa 0
para sa pagkalkula.

-w I-print ang bilang ng mga piraso ng banggaan ng stamp. Ibinabalik ang exit code na walang check sa exit.

-y Nagbabalik ng tagumpay kung ang selyo ay may bisa kahit na hindi ito ganap na nasuri. Gamitin kasama ang -c
kung saan hindi lahat -d, -r ay tinukoy upang makakuha ng tagumpay na exit code sa wasto ngunit bahagyang
may tsek na selyo. Katulad nito ay maaaring gamitin sa -n, -l, -w na may parehong epekto.

-M Kapag sinusuri ang mga selyo, payagan ang wildcard * tumutugma sa pangalan ng mapagkukunan upang gawin ito
mas simple upang tukuyin ang maramihang mga email address at upang payagan ang pagtutugma ng catch-all na mga address
at mga address kabilang ang mga subdomain. Ito ang default. Tingnan din -S, -E at -C

-S Kapag sinusuri ang mga selyo, gumamit ng simpleng text na ihambing upang ihambing ang mga pangalan ng mapagkukunan sa mga nasa
mga selyo. Tingnan din -M, -E at -C.

-E Kapag sinusuri ang mga selyo, gumamit ng mga regular na expression upang tukuyin ang mga pangalan ng mapagkukunan upang gawin ito
mas madaling tumukoy ng maraming email address, catch-all na address, mga klase ng extension
mga address at address kabilang ang mga subdomain. Tandaan na ang regular na expression syntax ay POSIX
istilo: ang mga espesyal na karakter ay hindi kailangang banggitin upang magkaroon ng kanilang espesyal na kahulugan; ngunit
ang mga ito ay kailangang ma-quote ng \ sa karakter na iyon sa hinanap na string. Ang
ang regular na expression ay awtomatikong may ^ idinagdag sa simula at $ idinagdag sa dulo,
kung hindi sila tinukoy. Ang mga espesyal na karakter ^ ay tumutugma sa simula ng
resource, at $ tumutugma sa dulo ng mapagkukunan.

(Tandaan kahit na pinagsama-sama sa mga regular na expression ng BSD, ginagamit ang POSIX style syntax; gayundin
tandaan na ang mga regular na expression ng BSD ay hindi sumusuporta sa mga hanay {}.)

-C Bilang default, ang mga mapagkukunan ay naka-canonical sa lower case sa pag-minting at sa pagsuri. Ang
-C Ino-override ito ng flag upang ang mga mapagkukunan ay ituring bilang case sensitive sa pagsuri,
at hindi canonizalized sa minting.

-P I-print ang impormasyon sa pag-unlad (bilang ng mga pag-ulit, inaasahang pag-ulit, porsyento na tapos na, pinakamahusay
natagpuan ang laki ng selyo sa ngayon).

-O ubod
Piliin ang hashcash core gamit ang numerong iyon. Sa kasalukuyan, 0-9 ang mga wastong core. Hindi lahat ng core
gumana sa lahat ng mga arkitektura. Halimbawa ang ilan ay x86 specific assembler, ang iba ay PPC specific
assembler. Kung ang isang core ay hindi wastong hashcash ay nagbabalik ng kabiguan at nagpapaliwanag kung ano
nangyari.

-Z n
I-compress ang selyo. Ito ay isang oras vs space trade off. Ang mas malalaking selyo ay mas mabilis, ngunit
masasabing medyo pangit. Para sa pinakamabilis na mga selyo (ang default) gamitin -Z 0; para sa bahagyang
ginagamit ng mga naka-compress na selyo -Z 1; para sa napaka-compress, ngunit medyo mabagal na mga selyo ay gumagamit ng -Z 2.
(Tandaan: dahil sa huli na natuklasang bug, -Z2 ay kapareho ng -Z1 sa ngayon hanggang sa maaayos ko
iyon.)

HALIMBAWA

Paglikha selyo

"hashcash -s"
Mag-print ng impormasyon sa timing tungkol sa kung gaano karaming banggaan ang maaaring subukan ng makina bawat segundo.

"hashcash -sv"
Mas tumpak ngunit medyo mabagal na pag-benchmark ng iba't ibang processor na partikular na minting
mga core

"hashcash -s -b default"
I-print kung gaano katagal ang aabutin ng makina upang makalkula ang isang default na laki ng banggaan (ngunit
huwag talagang kalkulahin ang isang banggaan).

"hashcash -s -b 32"
I-print kung gaano katagal ang aabutin ng makina upang makalkula ang isang 32 bit na banggaan (ngunit huwag
aktwal na kalkulahin ang isang banggaan).

"hashcash -m"
Mint ng selyo. Mag-prompt para sa pangalan ng mapagkukunan at mint na may default na halaga (bilang ng
mga piraso ng banggaan).

"hashcash -m foo"
Compute collision sa resource foo. Mag-mint na may default na halaga (bilang ng banggaan
bits).

"hashcash -m foo -b 10"
Compute 10 bit banggaan sa resource foo.

"hashcash -a -3d"
Magbawas ng random na oras sa pagitan ng 0 araw at 3 araw mula sa oras ng paggawa ng stamp.
Ito ang parehong fuzz factor na ginagamit ng mixmaster upang mabawasan ang panganib ng timing-correlations.

Pagsusuri Stamp

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Iulat ang halaga ng selyo (kung gaano karaming mga piraso ng banggaan) ang mayroon. Ang halimbawa ay
isang 24 bit na banggaan, na tumatagal sa average na 25 segundo upang makagawa sa isang 3Ghz P4.

"hashcash -mq -b 10 foo ⎪ hashcash -w"
Gumawa ng stamp sa batch mode, ipasa sa hashcash sa stdin para ma-verify, ipa-print kung paano
maraming piraso doon.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Iulat ang pangalan ng mapagkukunan mula sa stamp. Ang pangalan ng mapagkukunan sa halimbawa ay foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Iulat kung gaano katagal hanggang sa mag-expire ang selyo kung mag-e-expire ito sa loob ng 30 taon mula sa paggawa nito
petsa. (Tandaan ang mga petsa na masyadong malayo sa hinaharap hanggang sa 2038 na pagtatapos ng Epoch, na
ang unix time analog ng y2k bug).

Pag-verify Stamp

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Suriin kung wasto ang selyo. Tandaan dahil hindi namin sinusuri ang selyo sa dobleng paggastos
database, at hindi tinukoy ang pangalan ng mapagkukunan o kinakailangang bilang ng mga piraso ng banggaan
at isasaalang-alang ng hashcash ang selyo na hindi ganap na nasuri, at iuulat ito bilang wasto
ngunit hindi ganap na na-uncheck, o bilang hindi wasto kung may anumang problema sa selyo.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Suriin kung ang halaga ng stamp ay mas malaki o katumbas ng 24 bits. Ang halimbawang ito ay may 24
kaunting halaga. Kung dinadagdagan mo ang hiniling na bilang ng mga bit o palitan ang selyo ng isa
na may mas mababa sa 24 bit na banggaan ang selyo ay tatanggihan.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Tulad ng sa itaas suriin kung ang selyo ay may sapat na halaga, ngunit sa karagdagan suriin na ang
Ang pangalan ng mapagkukunan na ibinigay ay tumutugma sa pangalan ng mapagkukunan sa stamp.

Double Paggastos Pagpigil

Ang mga halimbawang ibinigay sa "Pag-verify ng Mga Selyo" ay maaaring baguhin upang mapanatili ang isang database ng dobleng gastos
upang ang parehong selyo ay hindi tatanggapin ng dalawang beses. Tandaan na ang isang selyo ay i-check in lamang
at idinagdag sa database kung ito ay wasto at ganap na nasuri (isang kinakailangang bilang ng
ang mga piraso ng banggaan ay tinukoy at isang mapagkukunan ay tinukoy).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Suriin ang stamp at idagdag sa double spent database kung ito ay wasto (may tamang mapagkukunan
pangalan at sapat na halaga).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Subukang doblehin ang paggastos ng selyo. Ito ay tatanggihan bilang dobleng ginastos.

Lagyan ng selyo Pag-expire

Upang maiwasan ang paglaki ng database ng dobleng gastos nang walang katiyakan, maaaring hilingin iyon ng tatanggap
ang mga selyo ay hindi lalampas sa isang tinukoy na panahon. Pagkatapos mag-expire ang lumang mga selyo ay maaaring bumaba mula sa
double spend database dahil hindi na sila kakailanganin -- maaaring tanggihan ang mga expired na selyo
batay lamang sa kanilang lumang petsa, kaya ang puwang na kinuha ng mga nag-expire na selyo sa dobleng paggastos
database ay maaaring i-save nang walang panganib ng pagtanggap ng isang nag-expire na kahit na balidong stamp.

Ang ikatlong field ng stamp ay ang oras ng UTC mula noong ika-1 ng Enero 1970. Ang default na oras
ang format ay YYMMDD, ang oras ay ni-round down sa pinakamalapit na araw. Ang default na panahon ng bisa ay 28
araw.

Maaari kang magbigay ng alternatibong panahon ng bisa kasama ang -e pagpipilian.

"hashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Subukang i-verify ang isang lumang stamp, ang stamp sa itaas ay nilikha noong Agosto 11, 2002.

Nagbigay kami ng pagpipilian -e 2d kaya ang petsa ng pag-expire ng mga selyo ay 2 araw pagkatapos ng paglikha, na ngayon
sa nakaraan.

Tandaan: kung ang oras ng paglikha ay ipinahayag sa selyo sa mga araw, ang tumpak na paglikha
Ang petsa ay ang simula ng tinukoy na araw sa oras ng UTC (katulad din para sa mga kahaliling unit
ang oras ng paglikha ay bilugan pababa hanggang sa simula ng yunit kung saan ito ipinahayag).
Para sa mga unit sa mga araw, halimbawa, ito ay maaaring mangahulugan depende sa iyong time zone na ang
lumilitaw na ang selyo ay itinuturing na hindi wasto sa ilalim ng tinukoy na panahon ng pag-expire sa mga araw
kaugnay sa iyong kamag-anak na pagtingin sa kung anong araw ito, dahil ang pagkalkula ay batay sa
kasalukuyang oras sa UTC, at ang oras ng paglikha ng selyo ay ipinahayag sa oras ng UTC.

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Subukan kung ang selyo ay may bisa, bukod sa nag-expire na. Tinatanggal ang -e
nagsasabi sa hashcash na ang selyo ay hindi mawawalan ng bisa. Ang isang panahon ng pag-expire ng magpakailanman ay maaari ding
ibigay nang malinaw tulad nito: -e 0, kung saan ang panahon ng pag-expire na 0 ay nangangahulugang magpakailanman.

Paglilinis luma selyo

Kung ang -c, -d ang mga opsyon ay ginagamit nang magkasama, sa tuwing susuriin ang isang selyo, kung ito ay wasto at
lahat ng mga mandatoryong aspeto ng stamp ay na-verify (collision bits check, resource
name check) pagkatapos ay isusulat ang selyo at ang panahon ng pag-expire nito sa database file. Ang
default expiry period kung ang isang expiry period ay hindi malinaw na ibinigay kasama ng -e ang opsyon ay 28
araw (ibig sabihin, ang mga selyo ay mawawalan ng bisa pagkatapos ng 4 na linggo).

Unang mint at pagkatapos ay magdagdag ng selyo:

"hashcash -m -b 10 foo -e 1m > stamp"
Tandaan: tinukoy namin ang isang expiry sa pag-minting sa halimbawang ito, upang matiyak na ang stamp
Ang oras ng paglikha ay ibinibigay sa sapat na mataas na resolusyon sa selyo na hindi gagawin ng selyo
maituturing na expired na sa oras ng paglikha. (Tandaan ang default na resolution ay sa mga araw,
ang isang selyo na ginawa gamit ang oras ng paglikha na binilog hanggang sa simula ng araw ay
malamang na hindi maituturing na wasto pagkalipas ng 1 minuto maliban kung i-mint mo ito sa hatinggabi UTC
oras.)

"hashcash -cd -e 1m -b 10 -r foo < stamp"
Mag-e-expire ang stamp sa loob ng 1 minuto. Maghintay ng 1 minuto at pagkatapos ay tahasang hilingin na nag-expire na iyon
linisin ang mga selyo:

"hashcash -p ngayon"
Pagkatapos ay subukang muling isumite ang parehong selyo:

"hashcash -cd -e 1m -b 10 -r foo < stamp"
at tatanggihan pa rin ang selyo dahil nag-expire na ito, na naglalarawan kung bakit hindi
kinakailangan upang mapanatili ang selyong ito sa database.

Gamit ang default na database (ang sdb format) ang mga nilalaman ng database ay nababasa ng tao,
upang matingnan mo ang kanilang mga nilalaman sa pamamagitan ng paglalagay sa kanila sa terminal:

"cat hashcash.sdb"
upang makita na ang selyo ay talagang idinagdag at pagkatapos ay pagkatapos ng puring kasunod na purged dahil sa
pag-expire

Paglilinis luma selyo on Pangangailangan

Bilang kaginhawahan maaari kang mag-purge kasabay ng pagsuri sa mga selyo sa pamamagitan ng paggamit ng -p opsyon
sa -c pagpipilian.

"hashcash -m -b 10 foo > stamp"
"hashcash -cd -p ngayon -e 1 -b 10 -r foo < stamp"
Maaaring hindi mahusay na linisin ang mga selyo sa bawat paggamit dahil ang buong database ay dapat
na-scan para sa mga nag-expire na selyo. Sa pamamagitan ng pagbibigay ng takdang panahon sa -p pagpipilian, maaari mong sabihin
"hashcash" upang mag-purge nang hindi mas madalas kaysa sa yugto ng panahon mula noong nakaraang paglilinis.

Halimbawa:

"hashcash -cd -p 1d -e 1 -b 10 -r foo < stamp"
nagsasabi sa "hashcash" na linisin ang anumang mga nag-expire na selyo nang hindi hihigit sa isang beses bawat araw.

"hashcash -p 1M -j foo"
nagsasabi sa "hashcash" na i-purge lang ang mga nag-expire na selyo na tumutugma sa resource foo isang beses bawat buwan.

"hashcash -p ngayon -k"
nagsasabi sa "hashcash" na i-purge ang lahat ng mga selyo (nag-expire at hindi nag-expire) ngayon.

tatakan format (bersyon 1)

Ang kasalukuyang format ng selyo ay bersyon 1. Maaaring i-verify ng tool na ito ang hashcash na bersyon 0 na mga selyo
gayundin, ngunit ang bersyon 0 na mga selyo ay hindi na nilikha dahil ang mga ito ay inalis na pabor sa
ang mas pinalawak na v1 stamp format.

ver:bits:petsa:mapagkukunan:[ext]:Rand:kontrahin

saan

ver = 1
bits = kung gaano karaming mga piraso ng bahagyang banggaan ang inaangkin na mayroon ang selyo
petsa = YYMMDD[hhmm[ss]]
mapagkukunan = resource string (hal. IP address, email address)
ext = extension -- binalewala sa kasalukuyang bersyon
Format ng extension:

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Tandaan na ang halaga ay maaari ding maglaman ng =. Halimbawa ng extension (hindi tunay):

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

Alin ang magiging extension name1 ay may mga halaga 2 at 3; Ang pangalan ng extension2 ay walang mga halaga;
Ang extension name3 ay may 3 value na "var1=2", "var2=3", "2" at "val". Ang hashcash
Maaaring bigyang-kahulugan ng extension ang mga halaga ayon sa nakikita nitong akma hal. "var1=2" ay maaaring ang halaga
ng isang opsyon sa pangalan ng extension3.

Rand = string ng mga random na character mula sa alpabeto a-zA-Z0-9+/= upang maiwasan ang mga banggaan
mga selyo ng ibang nagpadala
kontrahin = para makahanap ng stamp na may gustong bilang ng mga collision bit ay kailangang subukan ang maraming
iba't ibang mga string ang counter na ito ay nadaragdagan sa bawat pagsubok. Ang Counter ay binubuo din ng
mga character mula sa alpabeto a-zA-Z0-9+/=. (Tandaan ang isang pagpapatupad ay hindi kinakailangan upang
bilangin nang sunud-sunod).

Gumamit ng hashcash online gamit ang mga serbisyo ng onworks.net