.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "AGE\-KEYGEN" "1" "August 2026" ""
.SH "نام (NAME)"
\fBage\-keygen\fR \- تولید جفت‌کلیدهای age(1)
.SH "خلاصه دستور (SYNOPSIS)"
\fBage\-keygen\fR [\fB\-pq\fR] [\fB\-o\fR \fIOUTPUT\fR]
.br
\fBage\-keygen\fR \fB\-y\fR [\fB\-o\fR \fIOUTPUT\fR] [\fIINPUT\fR]
.br
.SH "توضیحات (DESCRIPTION)"
دستور
\fBage\-keygen\fR
یک جفت‌کلید بومی جدید برای age(1) تولید می‌کند و شناسه هویتی (identity) را در خروجی استاندارد یا در فایل
\fIOUTPUT\fR
می‌نویسد. خروجی شامل کلید عمومی و زمان جاری به عنوان کامنت است\.
.P
اگر خروجی به ترمینال هدایت نشده باشد،
\fBage\-keygen\fR
کلید عمومی را در خطای استاندارد چاپ می‌کند\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-pq\fR
تولید یک جفت‌کلید پسا-کوانتومی ترکیبی ML\-KEM\-768 + X25519\.
.IP
در آینده، ممکن است این حالت به گزینه پیش‌فرض تبدیل شود\.
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIOUTPUT\fR
نوشتن شناسه در
\fIOUTPUT\fR
به جای خروجی استاندارد\.
.IP
اگر
\fIOUTPUT\fR
از قبل وجود داشته باشد، بازنویسی نمی‌شود\.
.TP
\fB\-y\fR
خواندن یک فایل شناسه هویتی از
\fIINPUT\fR
یا از ورودی استاندارد و چاپ گیرنده(های) متناظر، یک مورد در هر خط، بدون کامنت\.
.TP
\fB\-\-version\fR
چاپ نسخه و خروج\.
.SH "مثال‌ها (EXAMPLES)"
تولید یک شناسه هویتی پسا-کوانتومی جدید:
.IP "" 4
.nf
$ age\-keygen \-pq
# created: 2025\-11\-17T13:39:06+01:00
# public key: age1pq167[\|\.\|\.\|\. 1950 more characters \|\.\|\.\|\.]
AGE\-SECRET\-KEY\-PQ\-1K30MYPZAHAXHR22YHH27EGDVLU0QNSUH3DSV7J7NR3X6D9LHXNWSDLTV4T
.fi
.IP "" 0
.P
تولید یک شناسه هویتی سنتی جدید:
.IP "" 4
.nf
$ age\-keygen
# created: 2021\-01\-02T15:30:45+01:00
# public key: age1lvyvwawkr0mcnnnncaghunadrqkmuf9e6507x9y920xxpp866cnql7dp2z
AGE\-SECRET\-KEY\-1N9JEPW6DWJ0ZQUDX63F5A03GX8QUW7PXDE39N8UYF82VZ9PC8UFS3M7XA9
.fi
.IP "" 0
.P
نوشتن یک شناسه پسا-کوانتومی جدید در
\fBkey\.txt\fR:
.IP "" 4
.nf
$ age\-keygen \-pq \-o key\.txt
Public key: age1pq1cd[\|\.\|\.\|\. 1950 more characters \|\.\|\.\|\.]
.fi
.IP "" 0
.P
تبدیل یک شناسه به گیرنده:
.IP "" 4
.nf
$ age\-keygen \-y key\.txt
age1pq1cd[\|\.\|\.\|\. 1950 more characters \|\.\|\.\|\.]
.fi
.IP "" 0
.SH "همچنین ببینید (SEE ALSO)"
age(1), age\-inspect(1)
.SH "نویسندگان (AUTHORS)"
Filippo Valsorda \fIage@filippo\.io\fR