.\"****************************************************************************
.\" 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 MUNGE 1 "2026-02-10" "munge-0.5.18" "MUNGE Uid 'N' Gid Emporium"

.SH "نام (NAME)"
munge \- کدگذار اعتبارنامهٔ MUNGE

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

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

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-h, \-\-help"
خلاصه‌ای از گزینه‌های خط فرمان را نمایش می‌دهد.
.TP
.BI "\-L, \-\-license"
اطلاعات مجوز را نمایش می‌دهد.
.TP
.BI "\-V, \-\-version"
اطلاعات نسخه را نمایش می‌دهد.
.TP
.BI "\-n, \-\-no\-input"
تمام ورودی‌ها برای بار مفید (payload) را نادیده می‌گیرد.
.TP
.BI "\-s, \-\-string " string
ورودی بار مفید را از رشته مشخص‌شده دریافت می‌کند.
.TP
.BI "\-i, \-\-input " path
ورودی بار مفید را از فایل مشخص‌شده دریافت می‌کند.
.TP
.BI "\-o, \-\-output " path
اعتبارنامه را در فایل مشخص‌شده ذخیره می‌کند.
.TP
.BI "\-c, \-\-cipher " string
نوع رمزنگاری (cipher) را با نام یا شماره مشخص می‌کند.
.TP
.BI "\-C, \-\-list\-ciphers"
فهرستی از انواع الگوریتم‌های رمزنگاری پشتیبانی‌شده را نمایش می‌دهد.
.TP
.BI "\-m, \-\-mac " string
نوع MAC را با نام یا شماره مشخص می‌کند.
.TP
.BI "\-M, \-\-list\-macs"
فهرستی از انواع MAC پشتیبانی‌شده را نمایش می‌دهد.
.TP
.BI "\-z, \-\-zip " string
نوع فشرده‌سازی را با نام یا شماره مشخص می‌کند.
.TP
.BI "\-Z, \-\-list\-zips"
فهرستی از انواع فشرده‌سازی پشتیبانی‌شده را نمایش می‌دهد.
.TP
.BI "\-u, \-\-restrict\-uid " uid
نام کاربری یا UID مجاز برای رمزگشایی اعتبارنامه را مشخص می‌کند. این مقدار با شناسه کاربری مؤثر فرایندی که درخواست رمزگشایی اعتبارنامه را دارد، تطبیق داده خواهد شد.
.TP
.BI "\-U, \-\-uid " uid
نام کاربری یا UID که اعتبارنامه تحت آن درخواست می‌شود را مشخص می‌کند. این گزینه نیازمند دسترسی‌های ریشه (root) یا قابلیت CAP_SETUID است.
.TP
.BI "\-g, \-\-restrict\-gid " gid
نام گروه یا GID مجاز برای رمزگشایی اعتبارنامه را مشخص می‌کند. این مقدار با شناسه گروه مؤثر فرایندی که درخواست رمزگشایی اعتبارنامه را دارد و همچنین تمام گروه‌های تکمیلی که شناسه کاربری مؤثر آن فرایند عضوی از آن‌ها است، تطبیق داده خواهد شد.
.TP
.BI "\-G, \-\-gid " gid
نام گروه یا GID که اعتبارنامه تحت آن درخواست می‌شود را مشخص می‌کند. این گزینه نیازمند دسترسی‌های ریشه (root) یا قابلیت CAP_SETGID است.
.TP
.BI "\-t, \-\-ttl " seconds
طول عمر (TTL بر حسب ثانیه) را مشخص می‌کند. این گزینه مدت زمان اعتبار داشتن اعتبارنامه پس از کدگذاری را کنترل می‌کند. مقدار 0، مقدار پیش‌فرض TTL را انتخاب می‌کند. مقدار \-1، بیشینهٔ مجاز TTL را برمی‌گزیند. توجه داشته باشید که \fBmunged\fR می‌تواند یک بیشینهٔ مجاز TTL را برای تمام اعتبارنامه‌ها اعمال کند که ممکن است از این مقدار کوچک‌تر باشد.
.TP
.BI "\-S, \-\-socket " path
سوکت محلی را برای اتصال به \fBmunged\fR مشخص می‌کند.

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

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

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

.SH "همچنین ببینید (SEE ALSO)"
.BR remunge (1),
.BR unmunge (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