.\" Created from Texinfo source by yat2m 1.0
.TH HMAC256 1 2026-08-27 "Libgcrypt 1.12.3" "Libgcrypt"
.SH "نام (NAME)"
hmac256 \- محاسبه کد اصالت‌سنجی پیام HMAC\-SHA\-256
.SH "خلاصه دستور (SYNOPSIS)"
.B  hmac256
.RB [ \-\-binary ]
.I key
.I [FILENAME]

.SH "توضیحات (DESCRIPTION)"
این یک پیاده‌سازی مستقل از HMAC\-SHA\-256 است که برای محاسبه یک کد اصالت‌سنجی پیام (MAC) از نوع HMAC\-SHA\-256 استفاده می‌شود.
این ابزار در ابتدا به عنوان یک پیاده‌سازی دوم برای
.B Libgcrypt
توسعه یافت تا امکان مقایسه با پیاده‌سازی اصلی را فراهم کرده و برای بررسی‌های سازگاری داخلی به کار رود.
از این ابزار نباید برای داده‌های حساس استفاده شود زیرا هیچ سازوکاری برای پاک‌سازی پشته (stack) و موارد مشابه در آن به کار نرفته است.

این کد به شیوه‌ای با قابلیت حمل بسیار بالا نوشته شده است و تنها به چند تعریف استاندارد نیاز دارد که در یک فایل
.I config.h
ارائه شوند.


دستور
.B hmac256
معمولاً به این صورت فراخوانی می‌شود:

.RS 2
.nf
hmac256 "This is my key" foo.txt
.fi
.RE


این دستور، مقدار MAC را بر روی فایل
\(oq\fIfoo.txt\fR\(cq
با استفاده از کلید ارائه‌شده در خط فرمان محاسبه می‌کند.

.SH "گزینه‌ها (OPTIONS)"

دستور
.B hmac256
این گزینه‌ها را می‌شناسد:


.TP
.B  \-\-binary
چاپ MAC به عنوان یک رشته دودویی (باینری). حالت پیش‌فرض، چاپ MAC کدگذاری‌شده به صورت ارقام هگزادسیمال با حروف کوچک است.

.TP
.B  \-\-version
نمایش نسخه برنامه و خروج.

.P

.SH "همچنین ببینید (SEE ALSO)"
\fBsha256sum\fR(1)