'\" t
.\"     Title: mosquitto_passwd
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/03/2026
.\"    Manual: Commands
.\"    Source: Mosquitto Project
.\"  Language: Persian
.\"
.TH "MOSQUITTO_PASSWD" "1" "04/03/2026" "Mosquitto Project" "Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
mosquitto_passwd \- مدیریت فایل‌های گذرواژه برای mosquitto
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmosquitto_passwd\fR\ 'u
\fBmosquitto_passwd\fR [\fB\-H\fR\ \fIhash\fR] [\fB\-c\fR | \fB\-D\fR] \fIpasswordfile\fR \fIusername\fR
.HP \w'\fBmosquitto_passwd\fR\ 'u
\fBmosquitto_passwd\fR [\fB\-H\fR\ \fIhash\fR] \fB\-b\fR \fIpasswordfile\fR \fIusername\fR \fIpassword\fR
.HP \w'\fBmosquitto_passwd\fR\ 'u
\fBmosquitto_passwd\fR \fB\-U\fR \fIpasswordfile\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBmosquitto_passwd\fR
ابزاری برای مدیریت فایل‌های گذرواژه برای کارگزار MQTT mosquitto است\&.
.PP
نام‌های کاربری نباید شامل «:» باشند\&. گذرواژه‌ها در قالبی شبیه به
\fBcrypt\fR(3)
ذخیره می‌شوند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-b\fR
.RS 4
اجرا در حالت دسته‌ای (batch mode)\&. این گزینه امکان مشخص کردن گذرواژه را در خط فرمان فراهم می‌کند که می‌تواند راحت باشد، اما باید با احتیاط استفاده شود چرا که گذرواژه در خط فرمان و در تاریخچه دستورات قابل مشاهده خواهد بود\&.
.RE
.PP
\fB\-c\fR
.RS 4
ایجاد یک فایل گذرواژه جدید\&. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد\&. اگر نام فایل با یک خط تیره
\fB\-\fR
مشخص شود، خروجی به stdout ارسال می‌شود\&. این کار در اصل تنها با گزینه
\fB\-b\fR
معنا دارد\&.
.RE
.PP
\fB\-D\fR
.RS 4
حذف کاربر مشخص‌شده از فایل گذرواژه\&.
.RE
.PP
\fB\-H\fR
.RS 4
انتخاب هش مورد استفاده\&. می‌تواند یکی از
\fIargon2id\fR،
\fIsha512\-pbkdf2\fR، یا
\fIsha512\fR
باشد\&. مقدار پیش‌فرض
\fIargon2id\fR
است\&. گزینه
\fIsha512\fR
جهت ایجاد فایل‌های گذرواژه برای سازگاری با Mosquitto نسخه 1\&.6 و قدیمی‌تر ارائه شده است\&.
.RE
.PP
\fB\-U\fR
.RS 4
از این گزینه می‌توان برای ارتقا/تبدیل یک فایل گذرواژه حاوی گذرواژه‌های متن ساده به فایلی با گذرواژه‌های هش‌شده استفاده کرد\&. این گزینه فایل مشخص‌شده را تغییر می‌دهد\&. برنامه بررسی نمی‌کند که آیا گذرواژه‌ها از قبل هش شده‌اند یا خیر، بنابراین اجرای آن روی فایلی که حاوی گذرواژه‌های هش‌شده است، بر اساس هش‌های قبلی هش‌های جدیدی تولید می‌کند و فایل گذرواژه را غیرقابل استفاده خواهد کرد\&.
.RE
.PP
\fBpasswordfile\fR
.RS 4
فایل گذرواژه‌ای که باید تغییر داده شود\&.
.RE
.PP
\fBusername\fR
.RS 4
نام کاربری برای افزودن/به‌روزرسانی/حذف\&.
.RE
.PP
\fBpassword\fR
.RS 4
گذرواژه‌ای که در حالت دسته‌ای استفاده می‌شود\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور mosquitto_passwd در صورت موفقیت مقدار صفر و در صورت بروز خطا مقدار غیرصفر بازمی‌گرداند\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
افزودن کاربر به یک فایل گذرواژه جدید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd
\-c
/etc/mosquitto/passwd
ral
.RE
.PP
افزودن کاربر به یک فایل گذرواژه موجود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd /etc/mosquitto/passwd
ral
.RE
.PP
افزودن کاربر به یک فایل گذرواژه موجود با ارسال گذرواژه در خط فرمان:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd \-b /etc/mosquitto/passwd
ral
z2Dr0BsvtZ
.RE
.PP
به‌روزرسانی گذرواژه یک کاربر در یک فایل گذرواژه موجود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd /etc/mosquitto/passwd
ral
.RE
.PP
افزودن کاربر به یک فایل گذرواژه موجود با استفاده از هش sha512 برای سازگاری با Mosquitto 1\&.6:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd \-H sha512 /etc/mosquitto/passwd
ral
.RE
.PP
حذف یک کاربر از فایل گذرواژه:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mosquitto_passwd
\-D
/etc/mosquitto/passwd
ral
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBMOSQUITTO_UNSAFE_ALLOW_SYMLINKS\fR
.RS 4
به‌طور پیش‌فرض، بارگذاری فایل‌های حساس که مسیر آن‌ها شامل یک پیوند نمادین (symbolic link) باشد رد خواهد شد\&. این متغیر محیطی را به هر مقداری تنظیم کنید تا بارگذاری فایل‌ها از طریق پیوندهای نمادین مجاز شود\&. توجه داشته باشید که استفاده از این متغیر می‌تواند شما را در معرض حملات پیوند نمادین قرار دهد و بنابراین فقط باید در مواردی استفاده شود که کاملاً مطمئن هستید این موضوع خطری ندارد\&.
.RE
.SH "اشکالات (BUGS)"
.PP
اطلاعات مربوط به اشکالات
\fBmosquitto\fR
در نشانی زیر قابل مشاهده است:
\m[blue]\fB\%https://github.com/eclipse-mosquitto/mosquitto/issues\fR\m[]
.SH "همچنین ببینید (SEE ALSO)"
\fBmosquitto\fR(7), \fBmosquitto\fR(8), \fBmosquitto.conf\fR(5), \fBmqtt\fR(7)
.SH "نویسنده (AUTHOR)"
.PP
Roger Light
<roger@atchoo\&.org>