| storescu(1) | OFFIS DCMTK | storescu(1) |
نام (NAME)
storescu - سرویسگیرنده ذخیرهسازی دایکام (C-STORE SCU)
خلاصه دستور (SYNOPSIS)
storescu [options] peer port dcmfile-in...
توضیحات (DESCRIPTION)
برنامه storescu یک کاربر رده سرویس (SCU) برای رده سرویس ذخیرهسازی (Storage Service Class) پیادهسازی میکند. برای هر فایل DICOM در خط فرمان، این برنامه یک پیام C-STORE به ارائهدهنده رده سرویس ذخیرهسازی (SCP) ارسال میکند و منتظر پاسخ میماند. از این برنامه میتوان برای انتقال تصاویر DICOM و سایر اشیاء ترکیبی DICOM استفاده کرد.
پارامترها (PARAMETERS)
peer hostname of DICOM peer port tcp/ip port number of peer dcmfile-in DICOM file or directory to be transmitted
- peer
- نام میزبان (hostname) سامانه DICOM مقصد
- port
- شماره پورت TCP/IP سامانه مقصد
- dcmfile-in
- فایل یا دایرکتوری DICOM برای ارسال
گزینهها (OPTIONS)
گزینههای عمومی (general options)
-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 برای ثبت وقایع
+v --verbose-pc
نمایش زمینههای ارائه (presentation contexts) در حالت پرگو
گزینههای ورودی (input options)
قالب فایل ورودی:
+f --read-file
خواندن قالب فایل یا مجموعه داده (پیشفرض)
+fo --read-file-only
فقط خواندن قالب فایل
-f --read-dataset
خواندن مجموعه داده بدون اطلاعات متای فایل
فایلهای ورودی:
+sd --scan-directories
پویش دایرکتوریها برای فایلهای ورودی (dcmfile-in)
+sp --scan-pattern [p]attern: string (فقط با --scan-directories)
الگو برای تطبیق نام فایل (حروف عام / wildcards)
# احتمالاً در همه سیستمها در دسترس نیست
-r --no-recurse
عدم پیمایش بازگشتی در دایرکتوریها (پیشفرض)
+r --recurse
پیمایش بازگشتی در دایرکتوریهای مشخصشده
-rn --no-rename
عدم تغییر نام فایلهای پردازششده (پیشفرض)
+rn --rename
افزودن .done/.bad به انتهای نام فایلهای پردازششده
گزینههای شبکه (network options)
نسخه پروتکل IP:
-i4 --ipv4
فقط استفاده از IPv4 (پیشفرض)
-i6 --ipv6
فقط استفاده از IPv6
-i0 --ip-auto
استفاده از جستجوی DNS برای تعیین پروتکل IP
عناوین موجودیت کاربردی (AE Titles):
-aet --aetitle [a]etitle: string
تنظیم عنوان AE فراخواننده من (پیشفرض: STORESCU)
-aec --call [a]etitle: string
تنظیم عنوان AE فراخواندهشده مقصد (پیشفرض: ANY-SCP)
پروفایل مذاکره ارتباط از فایل پیکربندی:
-xf --config-file [f]ilename, [p]rofile: string
استفاده از پروفایل p از فایل پیکربندی f
سینتکسهای انتقال پیشنهادی (همراه با --config-file استفاده نشود):
-x= --propose-uncompr
پیشنهاد تمام TSهای فشردهنشده، ابتدا VR صریح
با ترتیب بایت محلی (پیشفرض)
-xe --propose-little
پیشنهاد تمام TSهای فشردهنشده، ابتدا VR صریح با ترتیب little endian
-xb --propose-big
پیشنهاد تمام TSهای فشردهنشده، ابتدا VR صریح با ترتیب big endian
-xi --propose-implicit
فقط پیشنهاد TS با VR ضمنی و little endian
-xs --propose-lossless
پیشنهاد TS پیشفرض بدون اتلاف JPEG
و تمام سینتکسهای انتقال فشردهنشده
-xy --propose-jpeg8
پیشنهاد TS پیشفرض با اتلاف JPEG برای دادههای ۸ بیتی
و تمام سینتکسهای انتقال فشردهنشده
-xx --propose-jpeg12
پیشنهاد TS پیشفرض با اتلاف JPEG برای دادههای ۱۲ بیتی
و تمام سینتکسهای انتقال فشردهنشده
-xv --propose-j2k-lossless
پیشنهاد TS بدون اتلاف JPEG 2000
و تمام سینتکسهای انتقال فشردهنشده
-xw --propose-j2k-lossy
پیشنهاد TS با اتلاف JPEG 2000
و تمام سینتکسهای انتقال فشردهنشده
-xt --propose-jls-lossless
پیشنهاد TS بدون اتلاف JPEG-LS
و تمام سینتکسهای انتقال فشردهنشده
-xu --propose-jls-lossy
پیشنهاد TS با اتلاف JPEG-LS
و تمام سینتکسهای انتقال فشردهنشده
-xm --propose-mpeg2
فقط پیشنهاد TS مربوط به MPEG2 Main Profile @ Main Level
-xh --propose-mpeg2-high
فقط پیشنهاد TS مربوط به MPEG2 Main Profile @ High Level
-xn --propose-mpeg4
فقط پیشنهاد TS مربوط به MPEG4 AVC/H.264 High Profile / Level 4.1
-xl --propose-mpeg4-bd
فقط پیشنهاد TS مربوط به MPEG4 AVC/H.264 BD-compatible HP / Level 4.1
-x2 --propose-mpeg4-2-2d
فقط پیشنهاد TS مربوط به MPEG4 AVC/H.264 HP / Level 4.2 برای ویدیوهای دو بعدی (2D)
-x3 --propose-mpeg4-2-3d
فقط پیشنهاد TS مربوط به MPEG4 AVC/H.264 HP / Level 4.2 برای ویدیوهای سه بعدی (3D)
-xo --propose-mpeg4-2-st
فقط پیشنهاد TS مربوط به MPEG4 AVC/H.264 Stereo HP / Level 4.2
-x4 --propose-hevc
فقط پیشنهاد TS مربوط به HEVC/H.265 Main Profile / Level 5.1
-x5 --propose-hevc10
فقط پیشنهاد TS مربوط به HEVC/H.265 Main Profile / Level 5.1
-xr --propose-rle
پیشنهاد TS بدون اتلاف RLE
و تمام سینتکسهای انتقال فشردهنشده
-xd --propose-deflated
پیشنهاد TS با VR صریح و little endian فشردهشده با الگوریتم deflated
و تمام سینتکسهای انتقال فشردهنشده
-R --required
فقط پیشنهاد زمینههای ارائه الزامی
(پیشفرض: پیشنهاد تمام موارد پشتیبانیشده)
# این گزینه همچنین با ردههای SOP ذخیرهسازی که توسط DCMTK
# پشتیبانی میشوند اما در فهرست ردههای SOP پیشفرض نیستند کار میکند.
+C --combine
ترکیب سینتکسهای انتقال پیشنهادی
(پیشفرض: زمینه ارائه جداگانه برای هر TS)
نمایش مقادیر بعد از ۱۹۹۳ (VR):
+u --enable-new-vr
فعالسازی پشتیبانی از VRهای جدید (UN/UT) (پیشفرض)
-u --disable-new-vr
غیرفعالسازی پشتیبانی از VRهای جدید، تبدیل به OB
سطح فشردهسازی deflate (فقط همراه با --propose-deflated یا --config-file):
+cl --compression-level [l]evel: integer (پیشفرض: 6)
0=فشردهنشده، 1=سریعترین، 9=بهترین فشردهسازی
مذاکره هویت کاربر:
-usr --user [u]ser name: string
احراز هویت با استفاده از نام کاربری u
-pwd --password [p]assword: string (فقط با --user)
احراز هویت با استفاده از گذرواژه p
-epw --empty-password
ارسال گذرواژه خالی (فقط با --user)
-kt --kerberos [f]ilename: string
خواندن بلیت کربروس (Kerberos) از فایل f
--saml [f]ilename: string
خواندن درخواست SAML از فایل f
--jwt [f]ilename: string
خواندن دادههای JWT از فایل f
-rsp --pos-response
انتظار پاسخ مثبت
سایر گزینههای شبکه:
-to --timeout [s]econds: integer (پیشفرض: نامحدود)
مهلت زمانی برای درخواستهای اتصال
-ts --socket-timeout [s]econds: integer (پیشفرض: 60)
مهلت زمانی برای سوکت شبکه (0 برای نامحدود)
-ta --acse-timeout [s]econds: integer (پیشفرض: 30)
مهلت زمانی برای پیامهای ACSE
-td --dimse-timeout [s]econds: integer (پیشفرض: نامحدود)
مهلت زمانی برای پیامهای DIMSE
-pdu --max-pdu [n]umber of bytes: integer (4096..131072)
تنظیم حداکثر pdu دریافتی به n بایت (پیشفرض: 16384)
--max-send-pdu [n]umber of bytes: integer (4096..131072)
محدود کردن حداکثر pdu ارسالی به n بایت
--repeat [n]umber: integer
تکرار به تعداد n بار
--abort
قطع اجباری ارتباط (abort) به جای رهاسازی عادی آن
-nh --no-halt
عدم توقف در صورت مواجهه با ذخیرهسازی ناموفق
(پیشفرض: متوقف شود)
-up --uid-padding
اصلاح بیسرصدای UIDهای پرشده با فاصله
+II --invent-instance
تولید یک SOP instance UID جدید برای هر تصویر ارسالی
+IR --invent-series [n]umber: integer (شامل --invent-instance میشود)
تولید یک شناسه سری (series UID) جدید پس از ارسال n تصویر
(پیشفرض: 100)
+IS --invent-study [n]umber: integer (شامل --invent-instance میشود)
تولید یک شناسه مطالعه (study UID) جدید پس از ارسال n سری
(پیشفرض: 50)
+IP --invent-patient [n]umber: integer (شامل --invent-instance میشود)
تولید یک شناسه و نام بیمار جدید پس از ارسال n مطالعه
(پیشفرض: 25)
گزینههای امنیت لایه انتقال (TLS)
پشته پروتکل انتقال:
-tls --disable-tls
استفاده از اتصال عادی TCP/IP (پیشفرض)
+tls --enable-tls [p]rivate key file, [c]ertificate file: string
استفاده از اتصال امن و احرازهویتشده TLS
+tla --anonymous-tls
استفاده از اتصال امن TLS بدون گواهی
گذرواژه کلید خصوصی (فقط با --enable-tls):
+ps --std-passwd
درخواست از کاربر برای وارد کردن گذرواژه در ورودی استاندارد (پیشفرض)
+pw --use-passwd [p]assword: string
استفاده از گذرواژه مشخصشده
-pw --null-passwd
استفاده از رشته خالی به عنوان گذرواژه
قالب فایل کلید و گواهی:
-pem --pem-keys
خواندن کلیدها و گواهیها در قالب فایل PEM (پیشفرض)
-der --der-keys
خواندن کلیدها و گواهیها در قالب فایل DER
مرجع صدور گواهی (CA):
+cf --add-cert-file [f]ilename: string
افزودن فایل گواهی به فهرست گواهیها
+cd --add-cert-dir [d]irectory: string
افزودن گواهیهای موجود در پوشه d به فهرست گواهیها
+crl --add-crl-file [f]ilename: string
افزودن فایل فهرست ابطال گواهی (CRL)
(شامل --enable-crl-vfy میشود)
+crv --enable-crl-vfy
فعالسازی اعتبارسنجی CRL برای گواهی نهایی (leaf)
+cra --enable-crl-all
فعالسازی اعتبارسنجی CRL برای کل زنجیره گواهی
پروفایل امنیتی:
+ph --list-profiles
فهرست کردن پروفایلهای TLS پشتیبانیشده و خروج
+pg --profile-8996
پروفایل BCP 195 RFC 8996 TLS (پیشفرض)
+pm --profile-8996-mod
پروفایل اصلاحشده BCP 195 RFC 8996 TLS
# فقط در صورتی در دسترس است که کتابخانه زیربنایی TLS از
# تمام ویژگیهای TLS مورد نیاز این پروفایل پشتیبانی کند
+py --profile-bcp195-nd
پروفایل بدون تنزل BCP 195 TLS (منسوخشده)
+px --profile-bcp195
پروفایل BCP 195 TLS (منسوخشده)
+pz --profile-bcp195-ex
پروفایل توسعهیافته BCP 195 TLS (منسوخشده)
+pb --profile-basic
پروفایل اتصال امن انتقال پایهای TLS (منسوخشده)
# فقط در صورتی در دسترس است که کتابخانه زیربنایی TLS از 3DES پشتیبانی کند
+pa --profile-aes
پروفایل اتصال امن انتقال AES TLS (منسوخشده)
+pn --profile-null
ارتباط بدون رمزنگاری با احراز هویت
(منسوخشده، قبلاً در IHE ATNA استفاده میشد)
مجموعه الگوریتمهای رمزنگاری (ciphersuite):
+cc --list-ciphers
فهرست کردن مجموعههای رمزنگاری TLS پشتیبانیشده و خروج
+cs --cipher [c]iphersuite name: string
افزودن مجموعه رمزنگاری c به فهرست مجموعههای مذاکرهشده
مشخصکننده نام سرور (SNI):
--no-sni
عدم استفاده از SNI (پیشفرض)
--request-sni [s]erver name: string
درخواست نام سرور s
تولیدکننده اعداد شبهتصادفی:
+rs --seed [f]ilename: string
مقداردهی اولیه تولیدکننده تصادفی با محتوای f
+ws --write-seed
بازنویسی بذر مقداردهی اولیه تغییریافته (فقط با --seed)
+wf --write-seed-file [f]ilename: string (فقط با --seed)
نوشتن بذر مقداردهی اولیه تغییریافته در فایل f
احراز هویت طرف مقابل (peer):
-rc --require-peer-cert
بررسی گواهی طرف مقابل، در صورت عدم وجود با شکست مواجه شود (پیشفرض)
-ic --ignore-peer-cert
عدم بررسی گواهی طرف مقابل
نکات (NOTES)
پویش دایرکتوریها (Scanning Directories)
افزودن دایرکتوریها به عنوان پارامتر در خط فرمان فقط زمانی معنادار است که گزینه --scan-directories نیز داده شده باشد. اگر فایلهای موجود در دایرکتوریهای ارائهشده باید طبق یک الگوی نام خاص (مثلاً با استفاده از تطبیق حروف عام یا wildcard) انتخاب شوند، گزینه --scan-pattern باید به کار رود. لطفاً توجه داشته باشید که این الگوی فایل فقط برای فایلهای درون دایرکتوریهای پویششده اعمال میشود و چنانچه الگوهای دیگری در خط فرمان خارج از گزینه --scan-pattern مشخص شوند (مثلاً برای انتخاب فایلهای بیشتر)، این الگوها بر روی دایرکتوریهای مشخصشده اعمال نخواهند شد.
انطباق با دایکام (DICOM Conformance)
برنامه storescu از ردههای SOP ذخیرهسازی زیر در نقش SCU پشتیبانی میکند:
ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1 CTImageStorage 1.2.840.10008.5.1.4.1.1.2 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1 MRImageStorage 1.2.840.10008.5.1.4.1.1.4 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20 RawDataStorage 1.2.840.10008.5.1.4.1.1.66 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
رفتار پیشفرض storescu این است که برای هر رده SOP پشتیبانیشده (abstract syntax) دو زمینه ارائه پیشنهاد دهد - یکی با سینتکس انتقال ترجیحی و دیگری با تمام سینتکسهای انتقال فشردهنشده دیگر. سینتکس انتقال ترجیحی پیشفرض، VR صریح با ترتیب بایت متناظر با ترتیب بایت محلی سیستمی است که storescu روی آن اجرا میشود. این رفتار را میتوان با گزینههای --propose، --combine و --required تغییر داد (به بالا مراجعه کنید). بسته به این گزینهها، سینتکسهای انتقال زیر پشتیبانی میشوند:
LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*) BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
(*) در صورت کامپایل شدن با پشتیبانی فعال از zlib (خروجی --version را ببینید)
ردههای SOP ذخیرهسازی و سینتکسهای انتقال بیشتر را میتوان از طریق «پروفایلهای مذاکره ارتباط» (به پایین مراجعه کنید) استفاده کرد.
برنامه storescu به صورت پیشفرض از مذاکره گسترده (extended negotiation) پشتیبانی نمیکند. با این حال، با استفاده از یک پروفایل مذاکره ارتباط مناسب (به پایین مراجعه کنید) میتوان پشتیبانی اختیاری از مذاکره گسترده را برای ردههای SOP خاص اضافه کرد.
پروفایلهای مذاکره ارتباط و فایلهای پیکربندی (Association Negotiation Profiles and Configuration Files)
برنامه storescu از سازوکاری انعطافپذیر برای تعیین رفتار مذاکره ارتباط شبکه DICOM، مبتنی بر «پروفایلهای مذاکره ارتباط» که میتوانند از یک فایل پیکربندی خوانده شوند، پشتیبانی میکند. قالب و مفاهیم این فایل پیکربندی در asconfig.txt مستند شده است.
مذاکره هویت کاربر (User Identity Negotiation)
هنگام مشخص کردن نام کاربری و/یا گذرواژه با استفاده از گزینههای --user و --password، مقدار باید در قالب کدگذاری UTF-8 ارائه شود.
اگر از گزینه --pos-response استفاده شود، از SCP خواسته میشود به طور صریح به اطلاعات احراز هویت کاربری ارائهشده در درخواست storescu پاسخ داده و آن را تأیید کند. در غیر این صورت، چنانچه چنین پاسخی ارسال نشود، storescu ادامه نداده و در عوض اتصال را قطع میکند. از آنجا که مذاکره هویت کاربر یک ویژگی اختیاری است که بعداً به استاندارد اضافه شده، بسیاری از SCPها هویت کاربری ارائهشده را بررسی نکرده و در نتیجه هیچ پاسخی برای هویت کاربر ارائه نخواهند داد.
ثبت وقایع (LOGGING)
سطح خروجی ثبت وقایع در ابزارهای مختلف خط فرمان و کتابخانههای زیربنایی میتواند توسط کاربر تعیین شود. به طور پیشفرض، فقط خطاها و هشدارها در جریان خطای استاندارد (standard error) نوشته میشوند. با استفاده از گزینه --verbose پیامهای اطلاعرسانی مانند جزئیات پردازش نیز گزارش میشوند. گزینه --debug میتواند برای دریافت جزئیات بیشتر درباره فعالیتهای داخلی، مثلاً جهت اهداف اشکالزدایی، استفاده شود. سایر سطوح ثبت وقایع را میتوان با استفاده از گزینه --log-level انتخاب کرد. در حالت --quiet فقط خطاهای مهلک گزارش میشوند. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً متوقف میشود. برای جزئیات بیشتر در مورد سطوح مختلف لاگ، به مستندات ماژول «oflog» مراجعه کنید.
در صورتی که خروجی لاگ باید در یک فایل نوشته شود (اختیاراً با چرخش فایل لاگ)، به syslog (در یونیکس) یا event log (در ویندوز)، میتوان از گزینه --log-config استفاده کرد. این فایل پیکربندی همچنین اجازه میدهد پیامهای خاصی را به یک جریان خروجی مشخص هدایت کرده و پیامها را بر اساس ماژول یا برنامهای که در آن تولید شدهاند فیلتر کنید. یک نمونه فایل پیکربندی در مسیر <etcdir>/logger.cfg ارائه شده است.
خط فرمان (COMMAND LINE)
تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده میکنند: کروشهها مقادیر اختیاری را در بر میگیرند (۰-۱)، سه نقطه انتهایی نشان میدهد که مقادیر متعدد مجاز است (۱-n)، و ترکیبی از هر دو به معنی ۰ تا n مقدار است.
گزینههای خط فرمان با علامت پیشوند '+' یا '-' از پارامترها متمایز میشوند. معمولاً ترتیب و موقعیت گزینههای خط فرمان اختیاری است (یعنی میتوانند در هر جایی ظاهر شوند). با این حال، اگر گزینهها ناسازگار با یکدیگر باشند، راستترین گزینه درجشده اعمال میشود. این رفتار مطابق با قوانین ارزیابی استاندارد در پوستههای رایج یونیکس است.
علاوه بر این، یک یا چند فایل حاوی دستور را میتوان با استفاده از علامت '@' به عنوان پیشوند نام فایل مشخص کرد (مثلاً @command.txt). چنین آرگومان دستوری پیش از هرگونه پردازش بیشتر با محتوای فایل متنی متناظر جایگزین میشود (فاصلههای متوالی به عنوان یک جداکننده منفرد در نظر گرفته میشوند مگر اینکه بین دو علامت نقلقول قرار گرفته باشند). لطفاً توجه داشته باشید که یک فایل دستور نمیتواند شامل فایل دستور دیگری باشد. این رویکرد ساده اما مؤثر امکان خلاصهسازی ترکیبهای پرکاربرد از گزینهها/پارامترها را فراهم کرده و از طولانی و گیجکننده شدن خطوط فرمان جلوگیری میکند (یک مثال در فایل <datadir>/dumppat.txt ارائه شده است).
محیط (ENVIRONMENT)
ابزار storescu تلاش خواهد کرد فرهنگهای داده DICOM مشخصشده در متغیر محیطی DCMDICTPATH را بارگذاری کند. به طور پیشفرض، یعنی در صورتی که متغیر محیطی DCMDICTPATH تنظیم نشده باشد، فایل <datadir>/dicom.dic بارگذاری خواهد شد مگر اینکه دیکشنری درون خود برنامه تعبیه شده باشد (حالت پیشفرض برای ویندوز).
رفتار پیشفرض ارجح است و متغیر محیطی DCMDICTPATH تنها زمانی باید استفاده شود که فرهنگهای داده جایگزین مورد نیاز باشند. ساختار متغیر محیطی DCMDICTPATH همانند متغیر PATH در پوسته یونیکس است که در آن دو نقطه (":") ورودیها را از هم جدا میکند. در سیستمهای ویندوز، نقطه ویرگول (";") به عنوان جداکننده به کار میرود. کد بارگذاری فرهنگ داده تلاش خواهد کرد هر فایل مشخصشده در متغیر محیطی DCMDICTPATH را بارگذاری کند. چنانچه هیچ فرهنگ دادهای بارگذاری نشود، یک خطا در نظر گرفته خواهد شد.
فایلها (FILES)
<docdir>/asconfig.txt -
مستندات
فایل
پیکربندی
<etcdir>/storescu.cfg - نمونه
پروفایل
مذاکره
ارتباط
همچنین ببینید (SEE ALSO)
حق نشر (COPYRIGHT)
حق نشر (C) 1996-2025 متعلق به OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.
| Thu Jul 9 2026 18:43:40 | Version 3.7.0 |