نام (NAME)

age-inspect - بازرسی و استخراج متادیتای هدر فایل‌های رمزنگاری شده با age

خلاصه دستور (SYNOPSIS)

age-inspect [--json] [INPUT]

توضیحات (DESCRIPTION)

دستور age-inspect یک فایل رمزگذاری‌شده با age(1) را از INPUT (یا ورودی استاندارد) می‌خواند و متادیتای مربوط به آن را بدون رمزگشایی نمایش می‌دهد.

این اطلاعات شامل انواع دریافت‌کنندگان، استفاده یا عدم استفاده از رمزنگاری پساکوانتومی، و تفکیک اندازه اجزای فایل است.

گزینه‌ها (OPTIONS)

--json

تولید خروجی در قالب JSON و قابل خواندن توسط ماشین به جای متن قابل خواندن توسط انسان.

--version

چاپ نسخه و خروج.

قالب JSON (JSON FORMAT)

هنگامی که --json مشخص شده باشد، خروجی یک شیء JSON با فیلدهای زیر خواهد بود:

○

version: نسخه قالب age (برای مثال، "age-encryption.org/v1").

○

postquantum: مشخص می‌کند که آیا فایل از رمزنگاری پساکوانتومی استفاده می‌کند یا خیر: "yes"، "no" یا "unknown".

○

armor: مقدار بولی (Boolean) که نشان می‌دهد آیا فایل دارای پوشش متنی ASCII (ASCII-armored) است یا خیر.

○

stanza_types: آرایه‌ای از رشته‌های نوع بند (stanza) دریافت‌کننده (برای مثال، ["X25519"] یا ["mlkem768x25519"]).

○

sizes: شیئی حاوی اطلاعات اندازه به بایت:

○

header: اندازه سرآیند (header) فایل age.

○

armor: سربار کدگذاری پوشش متنی (armor) (در صورت عدم استفاده از پوشش متنی 0 است).

○

overhead: سربار رمزنگاری جریان داده (stream).

○

min_payload, max_payload: محدوده‌های اندازه بار داده (payload) (در حال حاضر همیشه یکسان هستند).

○

min_padding, max_padding: محدوده‌های اندازه فاصله‌گذاری/پدینگ (padding) (در حال حاضر همیشه 0 هستند).

مجموع این فیلدها برابر با اندازه کل فایل است.

مثال‌ها (EXAMPLES)

بازرسی یک فایل رمزگذاری‌شده:

$ 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.

دریافت خروجی JSON برای اسکریپت‌نویسی:

$ 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
    }
}

همچنین ببینید (SEE ALSO)

age(1), age-keygen(1)

نویسندگان (AUTHORS)

Filippo Valsorda age@filippo.io