.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "DBMMANAGE" 1 "2026-04-30" "Apache HTTP Server" "dbmmanage"

.SH "نام (NAME)"
dbmmanage \- مدیریت فایل‌های احراز هویت کاربری در فرمت DBM

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

.PP
\fB\fBdbmmanage\fR [ \fIencoding\fR ] \fIfilename\fR add|adduser|check|delete|update \fIusername\fR [ \fIencpasswd\fR [ \fIgroup\fR[,\fIgroup\fR\&.\&.\&.] [ \fIcomment\fR ] ] ]\fR

.PP
\fB\fBdbmmanage\fR \fIfilename\fR view [ \fIusername\fR ]\fR

.PP
\fB\fBdbmmanage\fR \fIfilename\fR import\fR


.SH "توضیحات (DESCRIPTION)"

.PP
دستور \fBdbmmanage\fR برای ایجاد و به‌روزرسانی فایل‌های با فرمت DBM استفاده می‌شود که جهت ذخیره‌سازی نام‌های کاربری و گذرواژه‌ها برای احراز هویت پایه‌ای کاربران HTTP از طریق mod_authn_dbm به کار می‌روند\&. منابع موجود در سرور HTTP آپاچی را می‌توان تنها به کاربرانی محدود کرد که نام آن‌ها در فایل‌های ایجادشده توسط \fBdbmmanage\fR فهرست شده است\&. این برنامه فقط زمانی قابل استفاده است که نام‌های کاربری در یک فایل DBM ذخیره شده باشند\&. برای استفاده از پایگاه داده با فایل متنی ساده (flat-file) دستور \fBhtpasswd\fR را ببینید\&.

.PP
ابزار دیگر برای نگهداری پایگاه داده گذرواژه DBM دستور \fBhtdbm\fR است\&.

.PP
این صفحه راهنما فقط آرگومان‌های خط فرمان را فهرست می‌کند\&. برای جزئیات دستورالعمل‌های لازم جهت پیکربندی احراز هویت کاربر در \fBhttpd\fR به راهنمای httpd مراجعه کنید که بخشی از توزیع آپاچی است یا در نشانی <http://httpd.apache.org> یافت می‌شود\&.


.SH "گزینه‌ها (OPTIONS)"


.TP
\fB\fIfilename\fR\fR
نام فایل با فرمت DBM\&. معمولاً بدون پسوند \fB\&.db\fR، \fB\&.pag\fR یا \fB\&.dir\fR\&.
.TP
\fB\fIusername\fR\fR
کاربری که عملیات برای او انجام می‌شود\&. نام کاربری (\fIusername\fR) نباید حاوی دو‌نقطه (\fB:\fR) باشد\&.
.TP
\fB\fIencpasswd\fR\fR
این گذرواژه از پیش هش‌شده است که برای دستورات \fBupdate\fR و \fBadd\fR استفاده می‌شود\&. اگر می‌خواهید گذرواژه از شما پرسیده شود اما فیلدهای بعدی را پر کنید، می‌توانید از خط تیره (\fB-\fR) استفاده کنید\&. علاوه بر این، هنگام استفاده از دستور \fBupdate\fR، یک نقطه (\fB\&.\fR) گذرواژه اصلی را دست‌نخورده نگه می‌دارد\&.
.TP
\fB\fIgroup\fR\fR
گروهی که کاربر عضو آن است\&. نام گروه نباید حاوی دو‌نقطه (\fB:\fR) باشد\&. اگر نمی‌خواهید کاربر را به گروهی اختصاص دهید اما می‌خواهید فیلد توضیح را پر کنید، می‌توانید از خط تیره (\fB-\fR) استفاده کنید\&. علاوه بر این، هنگام استفاده از دستور \fBupdate\fR، یک نقطه (\fB\&.\fR) گروه‌های اصلی را دست‌نخورده نگه می‌دارد\&.
.TP
\fB\fIcomment\fR\fR
اینجا مکانی برای توضیحات دلخواه شما درباره کاربر است، مانند نام واقعی، نشانی ایمیل یا مواردی از این دست\&. سرور این فیلد را نادیده خواهد گرفت\&.

.SS "رمزگذاری‌ها (Encodings)"


.TP
\fB-d\fR
هشینگ crypt (پیش‌فرض، به جز در Win32 و Netware)
.TP
\fB-m\fR
هشینگ MD5 (پیش‌فرض در Win32 و Netware)
.TP
\fB-s\fR
هشینگ SHA1
.TP
\fB-p\fR
متن آشکار (\fIتوصیه نمی‌شود\fR)

.SS "دستورات (Commands)"


.TP
\fBadd\fR
یک مدخل برای \fIusername\fR با استفاده از گذرواژه هش‌شده \fIencpasswd\fR به \fIfilename\fR اضافه می‌کند\&. dbmmanage passwords\&.dat add rbowen foKntnEF3KSXA
.TP
\fBadduser\fR
گذرواژه را درخواست می‌کند و سپس یک مدخل برای \fIusername\fR به \fIfilename\fR اضافه می‌کند\&. dbmmanage passwords\&.dat adduser krietz
.TP
\fBcheck\fR
گذرواژه را درخواست می‌کند و سپس بررسی می‌کند که آیا \fIusername\fR در \fIfilename\fR وجود دارد و آیا گذرواژه آن با گذرواژه مشخص‌شده مطابقت دارد یا خیر\&. dbmmanage passwords\&.dat check rbowen
.TP
\fBdelete\fR
مدخل \fIusername\fR را از \fIfilename\fR حذف می‌کند\&. dbmmanage passwords\&.dat delete rbowen
.TP
\fBimport\fR
مدخل‌های \fB\fIusername\fR:\fIpassword\fR\fR را (یک مورد در هر خط) از \fBSTDIN\fR می‌خواند و آن‌ها را به \fIfilename\fR اضافه می‌کند\&. گذرواژه‌ها از قبل باید هش‌شده (crypted) باشند\&.
.TP
\fBupdate\fR
مشابه دستور \fBadduser\fR است، با این تفاوت که اطمینان حاصل می‌کند \fIusername\fR از قبل در \fIfilename\fR وجود دارد\&. dbmmanage passwords\&.dat update rbowen
.TP
\fBview\fR
فقط محتویات فایل DBM را نمایش می‌دهد\&. اگر یک \fIusername\fR مشخص کنید، فقط همان رکورد خاص را نمایش می‌دهد\&. dbmmanage passwords\&.dat view

.SH "اشکالات (BUGS)"

.PP
باید آگاه باشید که چندین فرمت فایل DBM مختلف وجود دارد و به احتمال زیاد، کتابخانه‌های مربوط به بیش از یک فرمت در سیستم شما موجود است\&. سه نمونه اصلی عبارتند از SDBM، NDBM، پروژه GDBM گنو و Berkeley DB 2\&. متأسفانه، همه این کتابخانه‌ها از فرمت‌های فایل متفاوتی استفاده می‌کنند و شما باید مطمئن شوید که فرمت فایل مورد استفاده توسط \fIfilename\fR همان فرمتی است که \fBdbmmanage\fR انتظار دارد\&. در حال حاضر \fBdbmmanage\fR راهی برای تشخیص نوع فایل DBM که در حال بررسی آن است ندارد\&. در صورت استفاده برای یک فرمت نادرست، برنامه به سادگی هیچ چیزی برنمی‌گرداند، یا ممکن است یک فایل DBM متفاوت با نامی دیگر ایجاد کند، یا در بدترین حالت، در صورت تلاش برای نوشتن روی آن، ممکن است فایل DBM را خراب کند\&.

.PP
دستور \fBdbmmanage\fR فهرستی از اولویت‌های فرمت DBM دارد که توسط آرایه \fB@AnyDBM::ISA\fR در نزدیکی ابتدای برنامه تعریف شده است\&. از آنجا که فرمت فایل Berkeley DB 2 ترجیح داده می‌شود، ترتیبی که \fBdbmmanage\fR به دنبال کتابخانه‌های سیستمی می‌گردد عبارت است از Berkeley DB 2، سپس NDBM، سپس GDBM و سپس SDBM\&. نخستین کتابخانه یافت‌شده کتابخانه‌ای خواهد بود که \fBdbmmanage\fR تلاش می‌کند از آن برای تمام تراکنش‌های فایل DBM استفاده کند\&. این ترتیب کمی با ترتیب استاندارد \fB@AnyDBM::ISA\fR در Perl و همچنین ترتیبی که توسط فراخوانی ساده \fBdbmopen()\fR در Perl استفاده می‌شود متفاوت است؛ بنابراین اگر از هر ابزار دیگری برای مدیریت فایل‌های DBM خود استفاده می‌کنید، آن‌ها نیز باید از این ترتیب اولویت پیروی کنند\&. در صورت استفاده از برنامه‌هایی به زبان‌های دیگر مانند C برای دسترسی به این فایل‌ها نیز باید دقت مشابهی به کار گرفته شود\&.

.PP
معمولاً می‌توان از برنامه \fBfile\fR که همراه با اکثر سیستم‌های یونیکس ارائه می‌شود برای مشاهده اینکه یک فایل DBM در چه فرمتی قرار دارد استفاده کرد\&.