hashcash - Dalam Talian di Awan

JADUAL:

NAMA

hashcash - hashcash anti-spam / penolakan perkhidmatan alat ukuran balas

SINOPSIS

Mint (buat) setem:

hashcash -m [ [ pilihan ] [ sumber ... ] ... ]

daftar setem:

hashcash -c [ [ pilihan ] -r sumber ... ] [ setem ... ]

Mempercepatkan anggaran:

hashcash -s [ pilihan ] [ -b bit ]

Purge pangkalan data:

hashcash -p kini [ -j sumber ] [ -k ] [ -t masa ] [ -u ]

Pengiraan perlanggaran bit:

hashcash -w [ pilihan ] [ setem ... ]

Dapatkan sumber nama:

hashcash -n [ pilihan ] [ setem ... ]

Dapatkan masa baki sehingga tamatnya tempoh

hashcash -l [ pilihan ] -e tempoh [ setem ... ]

DESCRIPTION

Hashcash ialah alat ukuran kaunter penafian perkhidmatan. Kegunaan semasa utamanya adalah untuk membantu
pengguna hashcash mengelak daripada kehilangan e-mel kerana berasaskan kandungan dan anti-spam berasaskan senarai hitam
sistem.

Alat hashcash membolehkan anda membuat setem hashcash untuk dilampirkan pada e-mel yang anda hantar, dan
untuk mengesahkan setem hashcash yang dilampirkan pada e-mel yang anda terima. Pengirim e-mel melampirkan hashcash
setem dengan pengepala X-Hashcash:. Penjual dan pengarang alat anti-spam adalah digalakkan
untuk mengecualikan mel yang dihantar dengan hashcash daripada senarai hitam dan peraturan penapisan berasaskan kandungan mereka.

Setem hashcash membentuk bukti kerja yang memerlukan jumlah kerja yang boleh diparameterkan
untuk mengira penghantar. Penerima boleh mengesahkan setem yang diterima dengan cekap.

Fungsi hashcash proof-of-work adalah untuk mengira perlanggaran cincang separa (cincang SHA1
fungsi digunakan). Dengan memilih bilangan bit perlanggaran, kerja yang diperlukan untuk
mengira perlanggaran boleh dibuat mahal sewenang-wenangnya -- daripada pecahan sesaat hingga
minit atau jam. Pengesahan adalah cekap memerlukan kos kecil yang sama
saiz perlanggaran.

Untuk perbincangan yang lebih terperinci tentang aplikasi lain hashcash telah digunakan untuk lihat
http://www.hashcash.org/

PENGGUNAAN NOTA

Dalam halaman lelaki ini nama sumber ialah nama perkhidmatan atau alamat setem itu
dicipta untuk. Dalam kes e-mel, nama sumber ialah alamat e-mel penerima dalam
borang [e-mel dilindungi].

Pencetakan setem

. -m bendera mesti diberikan untuk menempa setem.

Nama sumber (alamat e-mel penerima) untuk mencetak setem boleh dihantar sebagai
hujah, atau jika ditinggalkan dibaca daripada stdin. Jika stdin ialah tty pengguna digesa, jika
stdin ialah paip yang nama sumber hanya dibaca secara senyap. Saiz perlanggaran yang dikehendaki boleh
ditentukan dengan pilihan -b. Jika tiada saiz perlanggaran dinyatakan, lalai ialah 20
bit. Lihat juga -b lalai pilihan.

Semakan setem

. -c bendera mesti diberikan untuk menyemak tamat tempoh setem. Setem untuk menyemak boleh diberikan sebagai
hujah untuk "hashcash". Jika tiada setem diberikan setem dibaca daripada stdin. Jika stdin ialah a
tty pengguna akan digesa, jika stdin adalah paip setem hanya dibaca senyap. A
nama sumber (alamat e-mel penerima) boleh diberikan dengan -r pilihan. Sekiranya
nama sumber diberi nama sumber dibandingkan dengan nama sumber dalam setem, jika
mereka tidak sepadan, setem ditolak.

Nota: jika tiada nama sumber diberikan, setem akan disemak untuk melihat sama ada sebaliknya
sah, tetapi ia boleh ditempa untuk sumber yang berbeza, yang membolehkan setem menjadi
digunakan semula merentas sumber yang berbeza, jadi hashcash akan mengembalikan kod keluar yang tidak ditandai semasa keluar.

Setem secara lalai dianggap sah selama 28 hari. Tempoh sah boleh
diubah menggunakan -e bendera.

Jika setem telah tamat tempoh atau mempunyai tarikh pada masa hadapan setem ditolak dan program
segera keluar.

Jika saiz perlanggaran yang diperlukan diberikan dengan -b bendera, nilai setem dikira dan
dibandingkan, jika setem mempunyai nilai yang tidak mencukupi ia ditolak, dan program keluar
serta merta. Sekiranya -b bendera tidak diberikan, setem diperiksa untuk melihat sama ada sebaliknya
sah, tetapi hashcash akan mengembalikan kod keluar yang tidak ditandai semasa keluar.

Jika setem dibelanjakan dua kali setem ditolak. Perlindungan perbelanjaan berganda adalah
dibincangkan dengan lebih terperinci di bawah dalam "Perlindungan Perbelanjaan Berganda". Jika perbelanjaan berganda
perlindungan tidak didayakan, setem boleh dibelanjakan dua kali ganda, jadi hashcash akan kembali
kod keluar tidak ditandai (kod keluar 2) semasa keluar.

. -w flag boleh digunakan untuk meminta bilangan bit perlanggaran dikira
dan dipaparkan. The -n bendera boleh digunakan untuk meminta nama sumber dalam setem adalah
dihuraikan dan dipaparkan. The -l bendera boleh digunakan untuk meminta bilangan saat sehingga
tamat tempoh setem adalah keluaran.

Program ini hanya akan mengembalikan kod keluar yang sah atau tidak sah jika -c bendera digunakan, iaitu -b
bendera digunakan, -d, -r sumber digunakan. Ini adalah set minimum pilihan yang diperlukan untuk
semak sepenuhnya kesahihan setem. Sekiranya kriteria ini tidak dipenuhi, program akan
kembalikan kod keluar tanpa tanda (kod keluar 2) semasa keluar. (Lihat juga -y bendera.)

Dua kali ganda Perbelanjaan perlindungan

Jika -d bendera digunakan semasa menyemak setem, pangkalan data setem yang dibelanjakan disimpan.

Secara lalai setem tamat tempoh selepas 28 hari, tanpa tamat tempoh pangkalan data akan berkembang
selama-lamanya. Anda boleh menentukan tempoh tamat alternatif dengan -e bendera. The
tempoh tamat yang disyorkan (dan lalai) untuk e-mel ialah 28 hari. Selepas tempoh luput
tempoh masa, setem itu bagaimanapun dianggap telah tamat tempoh dan mungkin dihapuskan daripada pangkalan data
untuk menjimatkan ruang. (Lihat "Membersihkan Secara Berkala lwn pada Akses Seterusnya" untuk cara membersihkan setem.)

Atas sebab kecekapan setem disahkan sebelum disemak dalam pangkalan data; jika ia adalah
jika tidak tidak sah tiada aktiviti pangkalan data akan berlaku.

Nota: Keputusan tentang berapa lama setem harus dianggap sah adalah terpulang kepada
pengesah. Jika ia terlalu pendek adalah mungkin untuk beberapa aplikasi yang akan dilakukan oleh setem
tamat tempoh sebelum tiba di penerima (cth dengan e-mel.) Nilai yang dicadangkan selama 28 hari
harus selamat untuk kelewatan penghantaran e-mel biasa. Pilihan adalah pertukaran antara
saiz pangkalan data dan risiko tamat tempoh sebelum ketibaan, dan bergantung pada aplikasi.

Nota: Setem yang berbeza dalam pangkalan data yang sama boleh mempunyai tempoh sah yang berbeza, jadi untuk
contoh setem untuk sumber yang berbeza dengan tempoh sah yang berbeza boleh disimpan dalam
pangkalan data yang sama, atau penerima boleh menukar tempoh sah untuk setem masa hadapan
tanpa menjejaskan kesahihan setem lama.

Pembersihan Secara berkala vs on Seterusnya Mengakses

Untuk membersihkan setem lama secara berkala semasa menyemak setem gunakan -p tempoh pilihan untuk membersihkan
tidak lebih awal daripada tempoh masa yang diberikan sejak pembersihan terakhir. Pembersihan boleh digunakan dengan
-k pilihan untuk membersihkan setem yang belum luput juga, dan dengan -j sumber bendera untuk membersihkan sahaja
setem untuk sumber yang diberikan.

Terdapat keadaan di mana ia mungkin menyusahkan untuk membersihkan setem pada akses seterusnya,
contohnya jika terdapat pangkalan data perbelanjaan berganda yang besar yang mengambil sedikit masa untuk dibersihkan, dan
masa tindak balas penyemak hashcash adalah penting. Untuk mengelakkan masalah ini, pembersihan
boleh dilakukan secara berasingan menggunakan hanya -p kini pilihan untuk meminta hanya operasi pembersihan.
Pada unix sebagai contoh, anda boleh memanggil "hashcash -p sekarang" dalam tugas cron sekali sehari, atau pada
permintaan apabila cakera hampir habis.

Mempercepatkan Anggaran

. -s bendera meminta ukuran berapa banyak perlanggaran boleh diuji sesaat. Tidak
setem dicetak, atau disahkan.

Jika -b bendera digunakan dengan pilihan ini, sebaliknya anggaran berapa saat ia akan berlaku
ambil untuk mencetak setem saiz yang diberikan dalam bit dikira. Untuk mengetahui berapa lama masa itu
akan mengambil masa untuk mencetak penggunaan setem bersaiz lalai -s -b lalai.

Nota

Semua output maklumat dicetak pada stderr. Setem ditempa, dan hasil setem
pengesahan dan masa dicetak pada stdout. Bendera yang tenang -q menindas semua
output maklumat. The -v bendera meminta lebih banyak output maklumat. Yang diminta
output, yang merupakan satu-satunya maklumat yang dikeluarkan dalam mod senyap (apabila -q dinyatakan)
dicetak pada output standard. Jika stdout ialah paip, atau apabila mod senyap sedang berkuat kuasa
output dicetak tanpa penerangan (iaitu hanya bit, hanya saat, hanya sumber).

PILIHAN

-c Semak maklumat tamat tempoh setem yang diberikan sebagai hujah atau pada stdin. (Gunakan dengan
-b, -d and -r sumber untuk menyemak setem sepenuhnya).

-m Setem pudina dengan sumber yang diberikan sebagai hujah atau pada stdin.

-b bit
Apabila menempa setem, buat perlanggaran sekurang-kurangnya sebanyak bit ini. Apabila mengesahkan a
setem memerlukan bahawa ia mempunyai perlanggaran sekurang-kurangnya banyak bit ini, jika tidak, tolak
ia. Jika ditinggalkan lalai digunakan.

Apabila menyemak setem, pastikan setem mempunyai bit sebanyak ini.

Bilangan lalai bit boleh ditentukan dengan -b lalai. Bit relatif kepada
lalai juga boleh ditentukan dengan -b +n untuk n bit lebih daripada lalai dan -b -n
untuk n bit kurang daripada lalai.

-b lalai, -b +0 and -b -0 semuanya setara.

Semasa melakukan ujian kelajuan -s, boleh mengukur kelajuan token lalai dengan -s -b
lalai.

-r sumber
Semasa mencetak setem, nama sumber (alamat e-mel penerima) untuk mencetak setem
terhadap boleh diberikan sama ada dengan -r sumber atau sebagai hujah kepada "cashcash".

Apabila menyemak setem, nama sumber (alamat e-mel anda sendiri) diberikan bersama -r
pilihan. Jika nama sumber diberikan, ia disemak terhadap nama sumber dalam
setem, dan jika tidak sepadan setem itu ditolak. Perhatikan jika nama sumber ialah
tidak diberikan, setem untuk sumber lain akan diterima, dan oleh itu hashcash
mengembalikan kod keluar tanpa tanda (kod keluar 2) semasa keluar.

-o Apabila mengesahkan setem pelbagai sumber boleh diberikan. Secara lalai sumbernya adalah
hanya diperiksa satu persatu sehingga sumber sah yang sepadan ditemui. Namun apabila anda
gunakan kad bebas atau ungkapan biasa (lihat -E), adalah berguna untuk dapat menentukannya
satu sumber mengatasi sumber lain. Contohnya ini: -b15 -r [e-mel dilindungi] -o -b10
*@dev.null menyatakan bahawa mel ke alamat [e-mel dilindungi] memerlukan 15 bit, tetapi mel ke
*@dev.null hanya memerlukan 10 bit. Jika kita meninggalkan -o mengatasi hubungan antara
kedua-dua sumber, setem 10 bit akan diterima untuk alamat [e-mel dilindungi]
kerana walaupun ia akan ditolak kerana mempunyai bit yang tidak mencukupi di bawah peraturan pertama,
ia akan diterima di bawah peraturan ke-2. The -o pilihan membolehkan anda mengelakkan masalah ini.

-e masa
Tempoh luput untuk setem yang dibelanjakan. Semasa menyemak setem (menggunakan -c bendera), jika
setem telah ditempa lebih daripada jumlah masa yang ditentukan lalu, ia dianggap telah tamat tempoh.
Jika pilihan ini tidak digunakan, secara lalai setem tamat tempoh selepas 28 hari. Tempoh luput
diberikan dalam beberapa saat secara lalai (hujah 0 bermakna selama-lamanya). Satu watak
akhiran boleh digunakan untuk menentukan unit ganti (m = minit, h = jam, d = hari, M =
bulan, y = Y = tahun, dan s = saat).

Jika digunakan dengan -d opsyen, setem yang dibelanjakan dan tempoh tamatnya direkodkan dalam
pangkalan data. Lihat -p pilihan untuk penerangan tentang cara membersihkan setem daripada pangkalan data.

Semasa menempa setem, yang -e bendera boleh memberi kesan pada resolusi masa yang dibuat
dalam setem. Tanpa -e pilihan, resolusi lalai ialah hari (format masa:
YYMMDD). Format alternatif berdasarkan julat tempoh tamat adalah seperti berikut:

Semasa mencetak anda juga boleh memberikan lebar masa yang jelas dengan -z pilihan sebaliknya.
(-z mengatasi -e jika kedua-duanya diberikan. Jika kedua-duanya tidak diberi nilai lalai ialah 6 aksara (time
format: YYMMDD)).

Peraturan untuk secara automatik menentukan lebar masa yang sesuai dari -e jika tidak -z pilihan
diberikan ialah:

* tempoh >= 2 tahun kemudian format masa YY digunakan dibundarkan ke bawah kepada tahun terdekat
mulakan;
* 2 tahun < tempoh <= 2 bulan kemudian format masa YYMM digunakan dibundarkan ke bawah kepada
permulaan bulan terdekat;
* 2 bulan < tempoh <= 2 hari kemudian format masa YYMMDD digunakan dibundarkan ke bawah kepada
permulaan hari terdekat;
* 2 hari < tempoh <= 2 minit kemudian format masa YYMMDDhhmm digunakan dibundarkan ke bawah kepada
permulaan minit terdekat;
* tempoh < 2 minit kemudian format masa YYMMDDhhmmss digunakan dalam saat.

Ambil perhatian bahawa pembundaran ke bawah adalah berdasarkan waktu UTC, bukan waktu tempatan. Ini boleh membawa kepada
hasil yang mengejutkan pada mulanya apabila dibundarkan ke bawah kepada cth hari dalam zon waktu selain GMT
(UTC = GMT). Ia mungkin lebih jelas untuk difahami jika anda menggunakan -u pilihan.

-z lebar
. -z pilihan adalah untuk digunakan semasa mencetak dan membolehkan pengguna memilih lebar lebar masa
padang. Lihat juga -e pilihan yang diberikan dalam kombinasi dengan -m untuk menentukan sesuatu yang tersirat
lebar medan masa di bawah perihalan -e bendera. Lebar yang sah ialah 6,10 atau 12
aksara yang sepadan masing-masing dengan: YYMMDD, YYMMDDhhmm dan YYMMDDhhmmss dibundarkan ke bawah
kepada hari terdekat, atau minit masing-masing.

Ambil perhatian bahawa pembundaran ke bawah adalah berdasarkan waktu UTC, bukan waktu tempatan. Ini boleh membawa kepada
hasil yang mengejutkan pada mulanya apabila dibundarkan ke bawah kepada cth hari dalam zon waktu selain GMT
(UTC = GMT). Ia mungkin lebih jelas untuk difahami jika anda menggunakan -u pilihan.

-g tempoh
. -g pilihan adalah untuk digunakan apabila menyemak setem hashcash dengan -c pilihan dan
menentukan tempoh tangguh untuk jam condong, iaitu jika setem hashcash tiba dengan tarikh dalam
masa depan atau pada masa lalu ia tidak akan ditolak sebagai mempunyai tarikh futuristik (atau sebagai
telah tamat tempoh) melainkan ia lebih futuristik (atau telah tamat tempoh lebih lama) daripada ini
tempoh. Lalai ialah 2 hari, yang bermaksud selagi jam sistem penghantaran adalah
tidak lebih daripada 2 hari lebih awal (atau 2 hari di belakang) jam sistem penerima,
setem hashcash masih akan diterima.

Unit lalai untuk tempoh tangguh ialah saat. Akhiran aksara tunggal boleh digunakan
untuk menentukan unit ganti (m = minit, h = jam, d = hari, M = bulan, y = Y =
tahun, dan s = saat).

-d Simpan setem dalam pangkalan data perbelanjaan berganda. Jika setem telah dilihat sebelum ia akan menjadi
ditolak walaupun sebaliknya sah. Fail pangkalan data lalai ialah pangkalan data.sdb in
direktori semasa. Hanya sebaliknya setem yang sah akan disimpan dalam pangkalan data.
Hanya setem yang disahkan sepenuhnya akan disimpan dalam pangkalan data, melainkan setem -y pilihan adalah
diberi.

-f dbname
Penggunaan dbname bukannya nama fail lalai untuk pangkalan data perbelanjaan berganda.

-p tempoh
Membersihkan pangkalan data setem yang telah tamat tempoh jika tempoh masa yang diberikan telah berlalu sejak
kali terakhir ia dibersihkan. Sebagai kemudahan -p kini adalah bersamaan dengan -p 0 kedua-duanya
bermakna pembersihan sekarang, tidak kira bila pangkalan data terakhir dibersihkan.

Jika digunakan dalam kombinasi dengan -j sumber hanya setem yang ditempa untuk sumber yang diberikan
dibersihkan.

Jika digunakan dalam kombinasi dengan -k semua setem walaupun setem yang belum tamat tempohnya dibersihkan. Boleh jadi
digunakan dalam kombinasi dengan -t masa untuk tamat tempoh seolah-olah masa semasa adalah masa yang diberikan.

-k Gunakan dengan pilihan -p untuk meminta semua setem dibersihkan daripada hanya yang telah tamat tempoh.

-j sumber
Gunakan dengan pilihan -p untuk meminta bahawa hanya setem yang sepadan dengan nama sumber yang diberikan adalah untuk
dibersihkan, bukannya lalai iaitu membersihkan semua setem yang telah tamat tempoh. Sekiranya
nama sumber ialah rentetan kosong, semua setem dipadankan (ini bersamaan dengan
meninggalkan -j pilihan).

Perhatikan -E, -M and -S jenis bendera perlawanan juga digunakan untuk sumber yang diberikan dengan -j
sumber bendera.

-s Cetak maklumat masa sahaja dan jangan teruskan membuat setem. Jika digabungkan dengan
-b bit anggaran cetakan bendera berapa lama saiz perlanggaran yang diminta akan diambil
hitung, jika -s diberikan dengan sendirinya, hanya mencetak kelajuan pencari perlanggaran. Untuk mencetak
anggaran berapa lama bilangan bit lalai akan digunakan -b lalai.

-h Cetak maklumat penggunaan ringkas.

-v Cetak lebih banyak keluaran maklumat terperinci tentang pencetakan atau pengesahan setem. (Jika
-v ialah satu-satunya hujah, mencetak nombor versi alat.)

-V Mencetak nombor versi alat.

-q Mod kumpulan. Tidak mencetak maklumat selain output. Pilihan ini mengatasi -v
pilihan.

-X Apabila mencetak, cetak e-mel hashcash X-header 'X-Hashcash: ' sebelum setem.
Tanpa pilihan ini hanya setem kosong dicetak.

Apabila menyemak, selepas mengimbas setem yang diberikan sebagai hujah, imbas stdin untuk baris
bermula dengan rentetan 'X-Hashcash:', dan menggunakan selebihnya baris padanan sebagai
setem. Hanya garisan sehingga dan berakhir pada baris kosong pertama diimbas (lihat juga
-i bendera yang boleh digunakan untuk mengatasi ini). Garis kosong ialah pemisah yang digunakan
asingkan pengepala daripada badan mesej mel atau artikel USENET. Ini yang dimaksudkan
untuk memudahkan penghantaran mesej mel atau artikel USENET ke hashcash pada stdin.

-x lanjutan
Rentetan sambungan yang terdiri daripada set nilai nama. Format sambungan diterangkan
di bawah dalam bahagian pada format setem hashcash. Ini membolehkan pengguna untuk menentukan mereka
sambungan setem sendiri yang dicincang ke dalam setem, disahkan oleh penerima bahawa
menyokong mereka dan diabaikan oleh penerima yang tidak menyokong mereka. Perhatikan sambungan
mekanisme cangkuk masih belum dilaksanakan. Ini akan datang dalam keluaran seterusnya.

-i Apabila menyemak dan menggunakan -X bendera, abaikan sempadan garisan kosong antara pengepala
dan badan mesej, dan semak perlanggaran dalam badan juga jika satu tidak ditemui
dalam tajuk.

-t masa
Berpura-pura masa semasa ialah masa yang diberikan untuk tujuan mencetak setem, mengesahkan
setem dan membersihkan setem lama daripada pangkalan data. Masa diberikan dalam format berdasarkan
Format UTCTIME YYMMDD[hhmm[ss]].

Masa dinyatakan dalam waktu tempatan secara lalai. Gunakan dengan -u bendera untuk memberi masa dalam UTC
(GMT).

Anda juga boleh memberi masa relatif kepada masa semasa dengan memberi awalan hujah dengan +
atau -. Unit lalai untuk masa relatif ialah saat. Akhiran aksara tunggal boleh
digunakan untuk menentukan unit ganti (m = minit, h = jam, d = hari, M = bulan, y =
Y = tahun, dan s = saat).

Nota: apabila masa dinyatakan dalam waktu tempatan, jika terdapat penjimatan siang hari dalam anda
zon waktu, terdapat satu atau dua jam samar-samar setiap tahun pada masa perubahan dari
masa penjimatan siang kepada waktu biasa.

-u Waktu mutlak input dan output dalam UTC (GMT) dan bukannya waktu tempatan.

-a tempoh
Tambah (atau tolak jika nombor negatif) nilai rawak daripada masa semasa sebelum ini
menempa setem. Ini menyembunyikan masa setem dibuat, yang mungkin berguna
pengguna tanpa nama. Perhatikan menambah (bukan menolak) masa rawak mungkin berisiko jika
setem mengambil masa kurang daripada masa tambahan untuk tiba kerana penerima akan menolak setem
dengan setem masa pada masa hadapan.

-n Nama sumber cetakan dihuraikan daripada setem yang disahkan. Mengembalikan kod keluar yang dinyahtandai
keluar.

-l Cetak bilangan saat yang tinggal sebelum setem tamat tempoh. Mengembalikan kod keluar yang dinyahtandai
keluar.

Nota: pengiraan termasuk tempoh tangguh, jadi boleh sehingga 2 kali tempoh tangguh
lebih lama daripada yang anda jangkakan (jam pantas tetapi sistem perlu menganggap ia boleh
lambat). Jika anda ingin mengecualikan tempoh tangguh tambah -g0 untuk menetapkan tempoh tangguh kepada 0
untuk pengiraan.

-w Cetak nombor bit perlanggaran setem. Mengembalikan kod keluar yang dinyahtandai semasa keluar.

-y Mengembalikan kejayaan jika setem itu sah walaupun tidak disemak sepenuhnya. Gunakan dengan -c
di mana tidak semua -d, -r ditentukan untuk mendapatkan kod keluar kejayaan pada sah tetapi sebahagiannya
setem disemak. Begitu juga boleh digunakan dengan -n, -l, -w dengan kesan yang sama.

-M Apabila menyemak setem, benarkan kad bebas * memadankan dalam nama sumber untuk menjadikannya
lebih mudah untuk menentukan berbilang alamat e-mel dan membenarkan padanan alamat tangkap-semua
dan alamat termasuk subdomain. Ini adalah lalai. Lihat juga -S, -E and -C

-S Apabila menyemak setem, gunakan teks ringkas berbanding untuk membandingkan nama sumber dengan nama yang terdapat dalam
setem. Lihat juga -M, -E and -C.

-E Apabila menyemak setem gunakan ungkapan biasa untuk menentukan nama sumber untuk membuatnya
lebih mudah untuk menentukan berbilang alamat e-mel, alamat catch-all, kelas sambungan
alamat dan alamat termasuk subdomain. Perhatikan sintaks ungkapan biasa ialah POSIX
gaya: watak istimewa tidak perlu dipetik untuk mempunyai makna istimewa; tetapi
mereka perlu dipetik dengan \ kepada watak itu dalam rentetan yang dicari. The
ungkapan biasa secara automatik mempunyai ^ ditambah pada permulaan dan $ ditambah pada akhir,
jika ia tidak dinyatakan. Watak khas ^ sepadan dengan permulaan
resouce, dan $ sepadan dengan akhir sumber.

(Perhatikan walaupun jika disusun dengan ungkapan biasa BSD, sintaks gaya POSIX digunakan; juga
perhatikan ungkapan biasa BSD tidak menyokong julat {}.)

-C Secara lalai sumber dikanonikalkan kepada huruf kecil semasa mencetak dan semasa menyemak. The
-C bendera mengatasi ini supaya sumber dianggap sebagai sensitif huruf besar pada pemeriksaan,
dan tidak dikanonisasi pada penempaan.

-P Cetak maklumat kemajuan (bilangan lelaran, jangkaan lelaran, peratusan selesai, terbaik
saiz setem ditemui setakat ini).

-O teras
Pilih teras hashcash dengan nombor itu. Pada masa ini 0-9 adalah teras yang sah. Bukan semua teras
bekerja pada semua seni bina. Contohnya sesetengahnya adalah pemasang khusus x86, yang lain khusus PPC
penghimpun. Jika teras tidak sah hashcash mengembalikan kegagalan dan menerangkan apa
berlaku.

-Z n
Mampatkan setem. Ini adalah pertukaran masa vs ruang. Setem yang lebih besar lebih cepat, tetapi
boleh dikatakan hodoh sedikit. Untuk setem terpantas (lalai) gunakan -Z 0; untuk sebahagian
setem mampat menggunakan -Z 1; untuk setem yang sangat mampat, tetapi agak perlahan gunakan -Z 2.
(Nota: disebabkan pepijat yang lewat ditemui, -Z2 adalah sama dengan -Z1 buat masa ini sehingga saya boleh membetulkan
itu.)

CONTOH

mewujudkan setem

"cashcash -s"
Cetak maklumat masa tentang berapa banyak perlanggaran yang boleh dicuba oleh mesin sesaat.

"cashcash -sv"
Penanda aras yang lebih tepat tetapi agak perlahan bagi pencetakan khusus pemproses yang berbeza
teras.

"cashcash -s -b lalai"
Cetak berapa lama masa yang diperlukan mesin untuk mengira perlanggaran bersaiz lalai (tetapi
sebenarnya tidak mengira perlanggaran).

"cashcash -s -b 32"
Cetak berapa lama masa yang diperlukan mesin untuk mengira perlanggaran 32 bit (tetapi jangan
sebenarnya mengira perlanggaran).

"cashcash -m"
Mint setem. Akan meminta nama sumber dan pudina dengan nilai lalai (bilangan
bit perlanggaran).

"cashcash -m foo"
Kira perlanggaran pada foo sumber. Akan dicetak dengan nilai lalai (bilangan perlanggaran
bit).

"cashcash -m foo -b 10"
Kira perlanggaran 10 bit pada foo sumber.

"cashcash -a -3d"
Tolak masa rawak antara 0 hari dan 3 hari daripada masa penciptaan setem.
Ini adalah faktor fuzz yang sama yang digunakan oleh mixmaster untuk mengurangkan risiko korelasi masa.

Pemeriksaan Setem

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan nilai setem (berapa banyak bit perlanggaran) yang ada. Contohnya ialah
perlanggaran 24 bit, yang mengambil masa purata 25 saat untuk dibuat pada P3 4Ghz.

"cashcash -mq -b 10 foo ⎪ hashcash -w"
Buat setem dalam mod kelompok, hantar ke hashcash pada stdin untuk mengesahkan, minta ia mencetak caranya
banyak bit yang ada.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan nama sumber daripada setem. Nama sumber dalam contoh ialah foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan berapa lama sehingga setem tamat tempoh jika ia tamat tempoh dalam 30 tahun dari penciptaannya
Tarikh. (Perhatikan tarikh terlalu jauh ke masa hadapan hingga ke penghujung Epoch 2038, iaitu
analog masa unix bagi pepijat y2k).

Mengesahkan Setem

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Semak sama ada setem itu sah. Perhatikan kerana kami tidak menyemak setem dalam perbelanjaan berganda
pangkalan data, dan tidak menyatakan nama sumber atau bilangan bit perlanggaran yang diperlukan
dan hashcash akan menganggap setem tidak disemak sepenuhnya, dan ia akan melaporkannya sebagai sah
tetapi tidak dinyahtanda sepenuhnya, atau sebagai tidak sah jika terdapat sebarang masalah dengan setem.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Semak sama ada nilai setem lebih besar atau sama dengan 24 bit. Contoh ini mempunyai 24
nilai bit. Jika anda menambah bilangan bit yang diminta atau menggantikan setem dengan satu
dengan perlanggaran kurang daripada 24 bit setem akan ditolak.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Seperti di atas semak jika setem mempunyai nilai yang mencukupi, tetapi sebagai tambahan semak bahawa
nama sumber yang diberikan sepadan dengan nama sumber dalam setem.

Dua kali ganda Perbelanjaan pencegahan

Contoh yang diberikan dalam "Mengesahkan Setem" boleh diubah suai untuk mengekalkan pangkalan data perbelanjaan dua kali
supaya setem yang sama tidak akan diterima dua kali. Ambil perhatian bahawa setem hanya akan didaftar masuk
dan ditambah pada pangkalan data jika sebaliknya sah dan disemak sepenuhnya (jumlah yang diperlukan daripada
bit perlanggaran telah ditentukan dan sumber telah ditentukan).

"cashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Semak setem dan tambah pada pangkalan data yang dibelanjakan dua kali jika ia sah (mempunyai sumber yang betul
nama dan nilai yang mencukupi).

"cashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Cuba dua kali ganda menghabiskan setem. Ia akan ditolak sebagai dibelanjakan dua kali ganda.

Setem Tamat tempoh

Untuk mengelakkan pangkalan data perbelanjaan berganda berkembang selama-lamanya, penerima boleh memintanya
setem tidak lebih lama daripada tempoh yang ditetapkan. Selepas tamat tempoh setem lama boleh digugurkan dari
pangkalan data perbelanjaan berganda kerana ia tidak lagi diperlukan -- setem yang telah tamat tempoh boleh ditolak
berdasarkan semata-mata pada tarikh lama mereka, jadi ruang yang diambil oleh setem tamat tempoh dalam perbelanjaan berganda
pangkalan data boleh disimpan tanpa risiko menerima setem yang telah tamat tempoh walaupun sebaliknya sah.

Medan ketiga setem ialah waktu UTC sejak 1 Januari 1970. Masa lalai
format ialah YYMMDD, masa dibundarkan ke bawah kepada hari terdekat. Tempoh sah lalai ialah 28
hari.

Anda boleh menyediakan tempoh sah alternatif dengan -e pilihan.

"cashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Cuba sahkan setem lama, setem di atas telah dibuat pada 11 Ogos 2002.

Kami memberi pilihan -e 2d jadi tarikh luput setem ialah 2 hari selepas penciptaan, iaitu sekarang
pada masa lalu.

Nota: jika masa penciptaan dinyatakan dalam setem dalam hari, penciptaan yang tepat
tarikh ialah permulaan hari yang ditentukan dalam waktu UTC (begitu juga untuk unit ganti
masa penciptaan dibundarkan ke bawah kepada permulaan unit yang dinyatakan dalam).
Untuk unit dalam hari, sebagai contoh, ini mungkin bermakna bergantung pada zon waktu anda yang
setem nampaknya dianggap tidak sah di bawah tempoh tamat yang ditetapkan dalam beberapa hari
relatif kepada pandangan relatif anda tentang hari itu, kerana pengiraan adalah berdasarkan
masa semasa dalam UTC, dan masa penciptaan setem dinyatakan dalam masa UTC.

"cashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Uji sama ada setem itu sah, selain daripada telah tamat tempoh. Meninggalkan -e
memberitahu hashcash bahawa setem itu tidak akan luput. Tempoh tamat selama-lamanya juga boleh
diberikan secara jelas seperti ini: -e 0, di mana tempoh tamat 0 bermakna selama-lamanya.

Pembersihan lama setem

Jika -c, -d pilihan digunakan bersama, setiap kali setem disemak, jika ia sah dan
semua aspek wajib setem disahkan (semakan bit perlanggaran, sumber
semak nama) maka setem dan tempoh tamatnya ditulis pada fail pangkalan data. The
tempoh tamat lalai jika tempoh tamat tidak diberikan secara jelas dengan -e pilihan ialah 28
hari (iaitu setem tamat tempoh selepas 4 minggu).

Pudina pertama dan kemudian tambahkan setem:

"cashcash -m -b 10 foo -e 1m > setem"
Nota: kami menyatakan tamat tempoh penempaan dalam contoh ini, untuk memastikan bahawa setem
masa penciptaan diberikan dalam resolusi yang cukup tinggi dalam setem yang tidak akan diberikan oleh setem
dianggap luput pada masa penciptaan. (Ingat resolusi lalai adalah dalam hari,
setem yang dicipta dengan masa penciptaan yang dibundarkan ke bawah kepada permulaan hari ialah
tidak mungkin dianggap sah 1 minit kemudian melainkan anda mencetaknya pada tengah malam UTC
masa.)

"cashcash -cd -e 1m -b 10 -r foo < setem"
Setem tamat tempoh dalam 1 minit. Tunggu 1 minit dan kemudian secara eksplisit meminta yang tamat tempoh
setem dibersihkan:

"cashcash -p sekarang"
Kemudian cuba serahkan semula setem yang sama:

"cashcash -cd -e 1m -b 10 -r foo < setem"
dan setem akan ditolak juga kerana ia telah tamat tempoh, menggambarkan mengapa ia tidak
perlu untuk menyimpan setem ini dalam pangkalan data.

Dengan pangkalan data lalai (format sdb) kandungan pangkalan data boleh dibaca manusia,
supaya anda boleh melihat kandungannya dengan menghantarnya ke terminal:

"cat hashcash.sdb"
untuk melihat bahawa setem benar-benar ditambah dan kemudian selepas pemurnian seterusnya dibersihkan kerana
luput.

Pembersihan lama setem on Permintaan

Sebagai kemudahan anda boleh membersihkan pada masa yang sama seperti menyemak setem dengan menggunakan -p pilihan
dengan -c pilihan.

"cashcash -m -b 10 foo > setem"
"cashcash -cd -p sekarang -e 1 -b 10 -r foo < cop"
Ia mungkin tidak cekap untuk membersihkan setem pada setiap penggunaan kerana keseluruhan pangkalan data perlu dilakukan
diimbas untuk setem yang telah tamat tempoh. Dengan memberi tempoh masa kepada -p pilihan, anda boleh tahu
"cashcash" untuk membersihkan tidak lebih kerap daripada tempoh masa itu sejak pembersihan sebelumnya.

Sebagai contoh:

"cashcash -cd -p 1d -e 1 -b 10 -r foo < setem"
memberitahu "cashcash" untuk membersihkan sebarang setem yang telah tamat tempoh tidak lebih daripada sekali sehari.

"cashcash -p 1M -j foo"
memberitahu "cashcash" untuk membersihkan hanya setem yang telah tamat tempoh yang sepadan dengan sumber foo sekali sebulan.

"cashcash -p sekarang -k"
memberitahu "cashcash" untuk membersihkan semua setem (tamat dan belum tamat tempoh) sekarang.

setem format (versi 1)

Format setem semasa ialah versi 1. Alat ini boleh mengesahkan setem hashcash versi 0
juga, tetapi setem versi 0 tidak lagi dibuat kerana ia akan dihapuskan secara berperingkat demi
format setem v1 yang lebih meluas.

ver:bit:tarikh:sumber:[ext]:rand:menentang

di mana

ver = 1
bit = berapa banyak bit perlanggaran separa setem yang didakwa ada
tarikh = YYMMDD[hhmm[ss]]
sumber = rentetan sumber (cth alamat IP, alamat e-mel)
ext = sambungan -- diabaikan dalam versi semasa
Format sambungan:

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Perhatikan nilai juga boleh mengandungi =. Contoh sambungan (bukan sambungan sebenar):

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

Manakah nama sambungan1 mempunyai nilai 2 dan 3; nama sambungan2 tidak mempunyai nilai;
nama sambungan3 mempunyai 3 nilai "var1=2", "var2=3", "2" dan "val". Hashcash itu
sambungan boleh mentafsir nilai seperti yang dilihatnya sesuai contohnya "var1=2" boleh menjadi nilai
daripada pilihan kepada nama sambungan3.

rand = rentetan aksara rawak daripada abjad a-zA-Z0-9+/= untuk mengelakkan perlanggaran
setem penghantar lain
menentang = untuk mencari setem dengan bilangan bit perlanggaran yang dikehendaki perlu mencuba banyak
rentetan berbeza kaunter ini ditambah pada setiap percubaan. Kaunter juga terdiri daripada
aksara daripada abjad a-zA-Z0-9+/=. (Perhatikan pelaksanaan tidak diperlukan untuk
mengira secara berurutan).

Gunakan hashcash dalam talian menggunakan perkhidmatan onworks.net