.TH "dcmqridx" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*-
.nh
.SH "نام (NAME)"
dcmqridx \- ثبت فایل تصویر DICOM در فایل نمایه پایگاه داده تصاویر
.PP

.SH "خلاصه دستور (SYNOPSIS)"
.PP
.PP
.nf
dcmqridx [options] index-out [dcmfile-in\&.\&.\&.]
.fi
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBdcmqridx\fP فایل‌های تصویر DICOM را در فایل نمایه پایگاه داده که توسط برنامه‌های \fBdcmqrscp\fP و \fBdcmqrti\fP استفاده می‌شود، ثبت می‌کند\&. هیچ فایل تصویری کپی نمی‌شود\&. همچنین \fBdcmqridx\fP می‌تواند محتویات فایل نمایه پایگاه داده را فهرست کند\&.
.SH "پارامترها (PARAMETERS)"
.PP
.PP
.nf
index-out   ناحیه ذخیره‌سازی برای فایل نمایه (دایرکتوری)

dcmfile-in  فایل تصویر DICOM جهت ثبت در فایل نمایه
.fi
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
.nf
  -h   --help
         چاپ این متن راهنما و خروج

       --version
         چاپ اطلاعات نسخه و خروج

       --arguments
         چاپ آرگومان‌های بسط‌یافته خط فرمان

  -q   --quiet
         حالت بی‌صدا، عدم چاپ هشدارها و خطاها

  -v   --verbose
         حالت پرگو، چاپ جزئیات پردازش

  -d   --debug
         حالت اشکال‌زدایی، چاپ اطلاعات اشکال‌زدایی

  -ll  --log-level  [l]evel: string constant
         (fatal, error, warn, info, debug, trace)
         استفاده از سطح l برای ثبت‌کننده وقایع

  -lc  --log-config  [f]ilename: string
         استفاده از فایل پیکربندی f برای ثبت‌کننده وقایع

  -p   --print
         فهرست کردن محتویات فایل نمایه پایگاه داده

  -n   --not-new
         تنظیم وضعیت بازبینی‌شده نمونه به \(aqnot new\(aq
.fi
.PP
.SH "نکات (NOTES)"
.PP
\fBdcmqridx\fP تلاش می‌کند برای هر فایل تصویری ارائه‌شده در خط فرمان، یک ارجاع به فایل نمایه پایگاه داده اضافه کند\&.

.PP
\fBdcmqridx\fP سامانه سهمیه‌بندی بخش پسین (back-end) پایگاه داده را غیرفعال می‌کند تا هیچ فایل تصویری حذف نشود\&.
.SH "گزارش‌گیری (LOGGING)"
.PP
سطح خروجی گزارش‌گیری (logging) ابزارهای خط فرمان مختلف و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود\&. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند\&. با استفاده از گزینهٔ \fI--verbose\fP پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند\&. گزینهٔ \fI--debug\fP می‌تواند برای دریافت جزئیات بیشتر درباره فعالیت‌های داخلی، برای نمونه جهت اهداف اشکال‌زدایی، استفاده شود\&. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینهٔ \fI--log-level\fP انتخاب کرد\&. در حالت \fI--quiet\fP تنها خطاهای مهلک گزارش می‌شوند\&. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد\&. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، مستندات ماژول \(lqoflog\(rq را ببینید\&.

.PP
در صورتی که خروجی گزارش‌گیری باید در یک فایل (اختیاراً همراه با چرخش فایل گزارش)، در syslog (یونیکس) یا در event log (ویندوز) نوشته شود، گزینهٔ \fI--log-config\fP می‌تواند استفاده شود\&. این فایل پیکربندی همچنین امکان هدایت تنها پیام‌های خاصی به یک جریان خروجی مشخص، و فیلتر کردن پیام‌های خاص بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند را فراهم می‌کند\&. یک فایل پیکربندی نمونه در \fI<etcdir>/logger\&.cfg\fP ارائه شده است\&.
.SH "خط فرمان (COMMAND LINE)"
.PP
تمام ابزارهای خط فرمان از نشانه‌گذاری زیر برای پارامترها استفاده می‌کنند: کروشه‌ها مقادیر اختیاری (۰-۱) را در بر می‌گیرند، سه نقطه پایانی نشان‌دهنده مجاز بودن چندین مقدار (۱-n) است، و ترکیبی از هر دو به معنای ۰ تا n مقدار است\&.

.PP
گزینه‌های خط فرمان به ترتیب با علامت پیشوند \(lq+\(rq یا \(lq-\(rq از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان دلخواه است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها مانعة‌الجمع باشند، گزینه‌ای که در راست‌ترین موقعیت قرار دارد اعمال می‌شود\&. این رفتار با قوانین ارزیابی استاندارد در پوسته‌های رایج یونیکس مطابقت دارد\&.

.PP
علاوه بر این، یک یا چند فایل فرمان را می‌توان با استفاده از علامت \(lq@\(rq به عنوان پیشوند نام فایل مشخص کرد (مانند \fI@command\&.txt\fP)\&. چنین آرگومان فرمانی قبل از هرگونه ارزیابی بیشتر، با محتوای فایل متنی متناظر جایگزین می‌شود (فاصله‌های خالی متوالی به عنوان یک جداکننده واحد در نظر گرفته می‌شوند مگر اینکه بین دو علامت نقل‌قول قرار گیرند)\&. لطفاً توجه داشته باشید که یک فایل فرمان نمی‌تواند شامل فایل فرمان دیگری باشد\&. این رویکرد ساده اما کارآمد به فرد امکان می‌دهد تا ترکیب‌های معمول گزینه‌ها/پارامترها را خلاصه کند و از خط فرمان‌های طولانی و گیج‌کننده جلوگیری نماید (یک نمونه در فایل \fI<datadir>/dumppat\&.txt\fP ارائه شده است)\&.
.SH "محیط (ENVIRONMENT)"
.PP
ابزار \fBdcmqridx\fP تلاش خواهد کرد فرهنگ‌های دادهٔ DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI<datadir>/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه فرهنگ داده درون برنامه تعبیه شده باشد (حالت پیش‌فرض برای ویندوز)\&.

.PP
رفتار پیش‌فرض باید ترجیح داده شود و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی باید استفاده شود که فرهنگ‌های دادهٔ جایگزین مورد نیاز باشند\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه متغیر \fIPATH\fP در پوسته یونیکس دارد که در آن دو‌نقطه (":") ورودی‌ها را از یکدیگر جدا می‌کند\&. در سیستم‌های ویندوز، نقطه ویرگول (";") به عنوان جداکننده به کار می‌رود\&. کد فرهنگ داده تلاش خواهد کرد هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. در صورتی که هیچ فرهنگ داده‌ای بارگذاری نشود، یک خطا رخ خواهد داد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdcmqrscp\fP(1), \fBdcmqrti\fP(1)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP
Copyright (C) 1993-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.