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

.SH "نام (NAME)"
remunge \- ارزیابی کارایی و بنچ‌مارک اعتبارسنجی MUNGE

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

.SH "توضیحات (DESCRIPTION)"
برنامه \fBremunge\fR کارایی سامانه MUNGE را ارزیابی و محک می‌زند (بنچ‌مارک می‌کند). آزمون به مدت‌زمان تعیین‌شده یا تا زمان پردازش تعداد اعتبارنامه‌های مشخص‌شده ادامه می‌یابد، هرکدام که زودتر به پایان برسد. در پایان، تعداد اعتبارنامه‌های پردازش‌شده در ثانیه در خروجی استاندارد (stdout) نوشته می‌شود.
.PP
به‌طور پیش‌فرض، اعتبارنامه‌ها به مدت یک ثانیه با استفاده از یک ریسه (thread) منفرد کدگذاری می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-h, \-\-help"
نمایش خلاصه‌ای از گزینه‌های خط فرمان.
.TP
.BI "\-L, \-\-license"
نمایش اطلاعات مجوز.
.TP
.BI "\-V, \-\-version"
نمایش اطلاعات نسخه.
.TP
.BI "\-q, \-\-quiet"
تنها نمایش نتیجه عددی تعداد اعتبارنامه در ثانیه (creds/sec). این گزینه برای تولید فایل‌های ورودی \fBministat\fR مفید است.
.TP
.BI "\-c, \-\-cipher " string
مشخص کردن نوع رمزنگاری، بر اساس نام یا شماره.
.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 "\-e, \-\-encode"
کدگذاری (بدون رمزگشایی) هر اعتبارنامه. با دور زدن عملیات رمزگشایی، اعتبارنامه در حافظه پنهان بازپخش (replay cache) ذخیره نمی‌شود.
.TP
.BI "\-d, \-\-decode"
کدگذاری و رمزگشایی هر اعتبارنامه.
.TP
.BI "\-l, \-\-length " bytes
مشخص کردن طول دلخواه بار داده (payload) به بایت. عدد صحیح می‌تواند با یک پسوند تک‌نویسه‌ای همراه باشد: k=کیلوبایت، m=مگابایت، g=گیگابایت؛ K=کیبی‌بایت، M=مبی‌بایت، G=گیبی‌بایت.
.TP
.BI "\-u, \-\-restrict\-uid " uid
مشخص کردن نام کاربری یا UID مجاز برای رمزگشایی اعتبارنامه. این مقدار با شناسه کاربری مؤثر (effective user ID) فرایندی که درخواست رمزگشایی اعتبارنامه را دارد، تطبیق داده می‌شود.
.TP
.BI "\-g, \-\-restrict\-gid " gid
مشخص کردن نام گروه یا GID مجاز برای رمزگشایی اعتبارنامه. این مقدار با شناسه گروهی مؤثر (effective group ID) فرایندی که درخواست رمزگشایی اعتبارنامه را دارد، و همچنین تک‌تک گروه‌های تکمیلی که شناسه کاربری مؤثر آن فرایند عضو آن‌هاست تطبیق داده می‌شود.
.TP
.BI "\-t, \-\-ttl " seconds
مشخص کردن طول عمر (time-to-live) به ثانیه. این گزینه مدت‌زمان معتبر بودن اعتبارنامه را پس از کدگذاری کنترل می‌کند. مقدار 0 مقدار پیش‌فرض TTL را تعیین می‌کند. مقدار \-1 حداکثر TTL مجاز را تعیین می‌کند.
.TP
.BI "\-S, \-\-socket " path
مشخص کردن سوکت محلی برای اتصال به \fBmunged\fR.
.TP
.BI "\-D, \-\-duration " seconds
مشخص کردن مدت‌زمان آزمون (به ثانیه). مدت‌زمان پیش‌فرض یک ثانیه است. مقدار \-1 حداکثر مدت‌زمان را تعیین می‌کند. عدد صحیح می‌تواند با یک پسوند تک‌نویسه‌ای همراه باشد: s=ثانیه، m=دقیقه، h=ساعت، d=روز.
.TP
.BI "\-N, \-\-num\-creds " integer
مشخص کردن تعداد اعتبارنامه‌ها برای تولید. عدد صحیح می‌تواند با یک پسوند تک‌نویسه‌ای همراه باشد: k=کیلوبایت، m=مگابایت، g=گیگابایت؛ K=کیبی‌بایت، M=مبی‌بایت، G=گیبی‌بایت.
.TP
.BI "\-T, \-\-num\-threads " integer
مشخص کردن تعداد ریسه‌ها برای پردازش اعتبارنامه‌ها.
.TP
.BI "\-W, \-\-warn\-time " seconds
مشخص کردن حداکثر زمان مجاز به ثانیه برای یک عملیات مشخص \fBmunge_encode\fR() یا \fBmunge_decode\fR() پیش از صدور هشدار.

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

.SH "نویسنده (AUTHOR)"
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 GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، ویرایش ۳ یا (به انتخاب خودتان) هر نسخه بعدی بازتوزیع کرده یا تغییر دهید.
.PP
همچنین برای کتابخانه MUNGE (libmunge)، می‌توانید آن را تحت شرایط پروانه عمومی همگانی کمتر گنو (GNU LGPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، ویرایش ۳ یا (به انتخاب خودتان) هر نسخه بعدی بازتوزیع کرده یا تغییر دهید.

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