.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "AGE\-INSPECT" "1" "August 2026" ""
.SH "نام (NAME)"
age\-inspect \- بازرسی و استخراج متادیتای هدر فایل‌های رمزنگاری شده با age
.SH "خلاصه دستور (SYNOPSIS)"
\fBage\-inspect\fR [\fB\-\-json\fR] [\fIINPUT\fR]
.SH "توضیحات (DESCRIPTION)"
دستور \fBage\-inspect\fR یک فایل رمزگذاری‌شده با age(1) را از \fIINPUT\fR (یا ورودی استاندارد) می‌خواند و متادیتای مربوط به آن را بدون رمزگشایی نمایش می‌دهد.\&
.P
این اطلاعات شامل انواع دریافت‌کنندگان، استفاده یا عدم استفاده از رمزنگاری پساکوانتومی، و تفکیک اندازه اجزای فایل است.\&
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-json\fR
تولید خروجی در قالب JSON و قابل خواندن توسط ماشین به جای متن قابل خواندن توسط انسان.\&
.TP
\fB\-\-version\fR
چاپ نسخه و خروج.\&
.SH "قالب JSON (JSON FORMAT)"
هنگامی که \fB\-\-json\fR مشخص شده باشد، خروجی یک شیء JSON با فیلدهای زیر خواهد بود:
.IP "\[ci]" 4
\fBversion\fR: نسخه قالب age (برای مثال، \fB"age\-encryption\.org/v1"\fR).\&
.IP "\[ci]" 4
\fBpostquantum\fR: مشخص می‌کند که آیا فایل از رمزنگاری پساکوانتومی استفاده می‌کند یا خیر: \fB"yes"\fR، \fB"no"\fR یا \fB"unknown"\fR.\&
.IP "\[ci]" 4
\fBarmor\fR: مقدار بولی (Boolean) که نشان می‌دهد آیا فایل دارای پوشش متنی ASCII (ASCII\-armored) است یا خیر.\&
.IP "\[ci]" 4
\fBstanza_types\fR: آرایه‌ای از رشته‌های نوع بند (stanza) دریافت‌کننده (برای مثال، \fB["X25519"]\fR یا \fB["mlkem768x25519"]\fR).\&
.IP "\[ci]" 4
\fBsizes\fR: شیئی حاوی اطلاعات اندازه به بایت:
.IP "\[ci]" 4
\fBheader\fR: اندازه سرآیند (header) فایل age.\&
.IP "\[ci]" 4
\fBarmor\fR: سربار کدگذاری پوشش متنی (armor) (در صورت عدم استفاده از پوشش متنی 0 است).\&
.IP "\[ci]" 4
\fBoverhead\fR: سربار رمزنگاری جریان داده (stream).\&
.IP "\[ci]" 4
\fBmin_payload\fR, \fBmax_payload\fR: محدوده‌های اندازه بار داده (payload) (در حال حاضر همیشه یکسان هستند).\&
.IP "\[ci]" 4
\fBmin_padding\fR, \fBmax_padding\fR: محدوده‌های اندازه فاصله‌گذاری/پدینگ (padding) (در حال حاضر همیشه 0 هستند).\&
.IP "" 0
.IP
مجموع این فیلدها برابر با اندازه کل فایل است.\&
.IP "" 0
.SH "مثال‌ها (EXAMPLES)"
بازرسی یک فایل رمزگذاری‌شده:
.IP "" 4
.nf
$ age\-inspect secrets\.age
secrets\.age is an age file, version "age\-encryption\.org/v1"\.

This file is encrypted to the following recipient types:
\- "mlkem768x25519"

This file uses post\-quantum encryption\.

Size breakdown (assuming it decrypts successfully):

    Header                      1627 bytes
    Encryption overhead           32 bytes
    Payload                       42 bytes
                        \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
    Total                       1701 bytes

Tip: for machine\-readable output, use \-\-json\.
.fi
.IP "" 0
.P
دریافت خروجی JSON برای اسکریپت‌نویسی:
.IP "" 4
.nf
$ age\-inspect \-\-json secrets\.age
{
    "version": "age\-encryption\.org/v1",
    "postquantum": "yes",
    "armor": false,
    "stanza_types": [
        "mlkem768x25519"
    ],
    "sizes": {
        "header": 1627,
        "armor": 0,
        "overhead": 32,
        "min_payload": 42,
        "max_payload": 42,
        "min_padding": 0,
        "max_padding": 0
    }
}
.fi
.IP "" 0
.SH "همچنین ببینید (SEE ALSO)"
age(1), age\-keygen(1)
.SH "نویسندگان (AUTHORS)"
Filippo Valsorda \fIage@filippo\.io\fR