.\"****************************************************************************
.\" Copyright (C) 2007-2025 Lawrence Livermore National Security, LLC.
.\" Copyright (C) 2002-2007 The Regents of the University of California.
.\" UCRL-CODE-155910.
.\"
.\" This file is part of the MUNGE Uid 'N' Gid Emporium (MUNGE).
.\" For details, see <https://github.com/dun/munge>.
.\"
.\" MUNGE is free software: you can redistribute it and/or modify it under
.\" the terms of the GNU General Public License as published by the Free
.\" Software Foundation, either version 3 of the License, or (at your option)
.\" any later version.  Additionally for the MUNGE library (libmunge), you
.\" can redistribute it and/or modify it under the terms of the GNU Lesser
.\" General Public License as published by the Free Software Foundation,
.\" either version 3 of the License, or (at your option) any later version.
.\"
.\" MUNGE is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" and GNU Lesser General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" and GNU Lesser General Public License along with MUNGE.  If not, see
.\" <http://www.gnu.org/licenses>.
.\"****************************************************************************

.TH UNMUNGE 1 "2026-02-10" "munge-0.5.18" "MUNGE Uid 'N' Gid Emporium"

.SH "نام (NAME)"
unmunge \- رمزگشای اعتبارنامه MUNGE

.SH "خلاصه دستور (SYNOPSIS)"
.B unmunge
[\fIOPTION\fR]...

.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBunmunge\fR یک اعتبارنامهٔ MUNGE (برای نمونه، اعتبارنامه‌ای که توسط برنامهٔ \fBmunge\fR ایجاد شده است) را اعتبارسنجی می‌کند.
.PP
به‌طور پیش‌فرض، اعتبارنامه از stdin خوانده شده و فراداده و بار داده (payload) در stdout نوشته می‌شوند. هنگامی که فراداده و بار داده در یک جریان مشترک نوشته شوند، با یک خط خالی از هم جدا می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-h, \-\-help"
نمایش خلاصه‌ای از گزینه‌های خط فرمان.
.TP
.BI "\-L, \-\-license"
نمایش اطلاعات پروانه (مجوز).
.TP
.BI "\-V, \-\-version"
نمایش اطلاعات نسخه.
.TP
.BI "\-i, \-\-input " path
خواندن اعتبارنامه از فایل مشخص‌شده.
.TP
.BI "\-n, \-\-no\-output"
دور ریختن تمامی خروجی‌ها، هم فراداده و هم بار داده.
.TP
.BI "\-m, \-\-metadata " path
نوشتن فراداده در فایل مشخص‌شده.
.TP
.BI "\-o, \-\-output " path
نوشتن بار داده در فایل مشخص‌شده.
.TP
.BI "\-k, \-\-keys " string
مشخص کردن زیرمجموعه‌ای از کلیدهای فراداده برای خروجی. کلیدها به بزرگی یا کوچکی حروف حساس نیستند و با فاصله، کاما، نقطه‌ویرگول یا نقطه جدا می‌شوند \-\- تا زمانی که رشته توسط پوسته (shell) به‌عنوان یک آرگومان واحد در نظر گرفته شود (برای نمونه، محصور در علامت‌های نقل‌قول). کلیدهای نامعتبر نادیده گرفته می‌شوند. اگر زیرمجموعه‌ای مشخص نشود، به‌طور پیش‌فرض همهٔ کلیدهای موجود انتخاب می‌شوند.
.TP
.BI "\-K, \-\-list\-keys"
نمایش فهرستی از کلیدهای فراداده.
.TP
.BI "\-N, \-\-numeric"
نمایش مقادیر فراداده به‌صورت عددی. این کار از تبدیل آدرس‌های IP به نام‌های میزبان، ثانیه‌ها به رشته‌های تاریخ و زمان، UIDها به نام‌های کاربری، GIDها به نام‌های گروه، و بازبینی نوع cipher/mac/zip صرف‌نظر می‌کند.
.TP
.BI "\-S, \-\-socket " path
مشخص کردن سوکت محلی برای اتصال به \fBmunged\fR.
.TP
.BI "\-\-ignore\-ttl"
نادیده گرفتن خطاهای منقضی‌شده (expired)، زمان به عقب برگشته (rewound) و بازپخش‌شده (replayed).
.TP
.BI "\-\-ignore\-replay"
نادیده گرفتن خطاهای بازپخش‌شده (replayed).

.SH "کلیدهای فراداده (METADATA KEYS)"
کلیدهای فرادادهٔ زیر پشتیبانی می‌شوند:
.TP
.B STATUS
وضعیت عملیات رمزگشایی اعتبارنامه.
.TP
.B ENCODE_HOST
نشانی میزبانی که اعتبارنامه روی آن کدگذاری شده است.
.TP
.B ENCODE_TIME
زمانی که اعتبارنامه در آن کدگذاری شده است (بر اساس ساعت محلیِ میزبانی که آن را کدگذاری کرده).
.TP
.B DECODE_TIME
زمانی که اعتبارنامه در آن رمزگشایی شده است (بر اساس ساعت محلیِ میزبانی که آن را رمزگشایی کرده).
.TP
.B TTL
مقدار طول عمر (time-to-live به ثانیه) قرار داده شده درون اعتبارنامه.
.TP
.B CIPHER
نوع الگوریتم رمزنگاری (cipher) استفاده‌شده برای کدگذاری اعتبارنامه.
.TP
.B MAC
نوع MAC استفاده‌شده برای کدگذاری اعتبارنامه.
.TP
.B ZIP
نوع فشرده‌سازی استفاده‌شده برای کدگذاری اعتبارنامه.
.TP
.B UID
شناسهٔ کاربری (UID) فرایندی که اعتبارنامه را کدگذاری کرده است.
.TP
.B GID
شناسهٔ گروهی (GID) فرایندی که اعتبارنامه را کدگذاری کرده است.
.TP
.B UID_RESTRICTION
محدودیت شناسهٔ کاربری (UID) اعمال‌شده درون اعتبارنامه.
.TP
.B GID_RESTRICTION
محدودیت شناسهٔ گروهی (GID) اعمال‌شده درون اعتبارنامه.
.TP
.B LENGTH
طول بار داده (payload) به بایت.

.SH "وضعیت خروج (EXIT STATUS)"
برنامهٔ \fBunmunge\fR یک کد خروج متناظر با کد بازگشتی \fBmunge_decode\fR() بازمی‌گرداند. در صورت موفقیت، کد خروج صفر را بازمی‌گرداند که نشان‌دهندهٔ معتبر بودن اعتبارنامه است. در صورت بروز خطا، یک پیام خطا در stderr چاپ کرده و کد خروج غیرصفر بازمی‌گرداند.

.SH "نویسندگان (AUTHORS)"
Chris Dunlap <cdunlap@llnl.gov>

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright (C) 2007-2025 Lawrence Livermore National Security, LLC.
.br
Copyright (C) 2002-2007 The Regents of the University of California.
.PP
نرم‌افزار MUNGE یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط پروانهٔ عمومی همگانی گنو (GNU General Public License) همان‌گونه که توسط بنیاد نرم‌افزار آزاد (Free Software Foundation) منتشر شده است، چه نسخهٔ ۳ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.
.PP
علاوه بر این، برای کتابخانهٔ MUNGE (\fBlibmunge\fR)، می‌توانید آن را تحت شرایط پروانهٔ عمومی همگانی کمتر گنو (GNU Lesser General Public License) منتشرشده توسط بنیاد نرم‌افزار آزاد، چه نسخهٔ ۳ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.

.SH "همچنین ببینید (SEE ALSO)"
.BR munge (1),
.BR remunge (1),
.BR munge (3),
.BR munge_ctx (3),
.BR munge_enum (3),
.BR munge (7),
.BR munged (8),
.BR mungekey (8).
.PP
\fBhttps://github.com/dun/munge\fR