1storescp(1) OFFIS DCMTK storescp(1)
2
3
4
6 storescp - DICOM storage (C-STORE) SCP
7
8
10 storescp [options] [port]
11
13 The storescp application implements a Service Class Provider (SCP) for
14 the Storage Service Class. It listens on a specific TCP/IP port for
15 incoming association requests from a Storage Service Class User (SCU)
16 and can receive both DICOM images and other DICOM composite objects.
17 The storescp application also supports the Verification Service Class
18 as an SCP.
19
21 port tcp/ip port number to listen on
22 (this parameter is required unless the --inetd option is specified)
23
25 general options
26 -h --help
27 print this help text and exit
28
29 --version
30 print version information and exit
31
32 --arguments
33 print expanded command line arguments
34
35 -q --quiet
36 quiet mode, print no warnings and errors
37
38 -v --verbose
39 verbose mode, print processing details
40
41 -d --debug
42 debug mode, print debug information
43
44 -ll --log-level [l]evel: string constant
45 (fatal, error, warn, info, debug, trace)
46 use level l for the logger
47
48 -lc --log-config [f]ilename: string
49 use config file f for the logger
50
51 +v --verbose-pc
52 show presentation contexts in verbose mode
53
54 multi-process options
55 --single-process
56 single process mode (default)
57
58 --fork
59 fork child process for each association
60
61 network options
62 association negotiation profile from configuration file:
63
64 -xf --config-file [f]ilename [p]rofile: string
65 use profile p from config file f
66
67 preferred network transfer syntaxes (not with --config-file):
68
69 +x= --prefer-uncompr
70 prefer explicit VR local byte order (default)
71
72 +xe --prefer-little
73 prefer explicit VR little endian TS
74
75 +xb --prefer-big
76 prefer explicit VR big endian TS
77
78 +xs --prefer-lossless
79 prefer default JPEG lossless TS
80
81 +xy --prefer-jpeg8
82 prefer default JPEG lossy TS for 8 bit data
83
84 +xx --prefer-jpeg12
85 prefer default JPEG lossy TS for 12 bit data
86
87 +xv --prefer-j2k-lossless
88 prefer JPEG 2000 lossless TS
89
90 +xw --prefer-j2k-lossy
91 prefer JPEG 2000 lossy TS
92
93 +xt --prefer-jls-lossless
94 prefer JPEG-LS lossless TS
95
96 +xu --prefer-jls-lossy
97 prefer JPEG-LS lossy TS
98
99 +xm --prefer-mpeg2
100 prefer MPEG2 Main Profile @ Main Level TS
101
102 +xh --prefer-mpeg2-high
103 prefer MPEG2 Main Profile @ High Level TS
104
105 +xn --prefer-mpeg4
106 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
107
108 +xl --prefer-mpeg4-bd
109 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
110
111 +x2 --prefer-mpeg4-2-2d
112 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
113
114 +x3 --prefer-mpeg4-2-3d
115 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
116
117 +xo --prefer-mpeg4-2-st
118 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
119
120 +x4 --prefer-hevc
121 prefer HEVC H.265 Main Profile / Level 5.1 TS
122
123 +x5 --prefer-hevc10
124 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
125
126 +xr --prefer-rle
127 prefer RLE lossless TS
128
129 +xd --prefer-deflated
130 prefer deflated explicit VR little endian TS
131
132 +xi --implicit
133 accept implicit VR little endian TS only
134
135 +xa --accept-all
136 accept all supported transfer syntaxes
137
138 network host access control (tcp wrapper):
139
140 -ac --access-full
141 accept connections from any host (default)
142
143 +ac --access-control
144 enforce host access control rules
145
146 other network options:
147
148 -id --inetd
149 run from inetd super server (not with --fork)
150
151 # not available on all systems (e.g. not on Windows)
152
153 -ts --socket-timeout [s]econds: integer (default: 60)
154 timeout for network socket (0 for none)
155
156 -ta --acse-timeout [s]econds: integer (default: 30)
157 timeout for ACSE messages
158
159 -td --dimse-timeout [s]econds: integer (default: unlimited)
160 timeout for DIMSE messages
161
162 -aet --aetitle [a]etitle: string
163 set my AE title (default: STORESCP)
164
165 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
166 set max receive pdu to n bytes (default: 16384)
167
168 -dhl --disable-host-lookup
169 disable hostname lookup
170
171 --refuse
172 refuse association
173
174 --reject
175 reject association if no implementation class UID
176
177 --ignore
178 ignore store data, receive but do not store
179
180 --sleep-after [s]econds: integer
181 sleep s seconds after store (default: 0)
182
183 --sleep-during [s]econds: integer
184 sleep s seconds during store (default: 0)
185
186 --abort-after
187 abort association after receipt of C-STORE-RQ
188 (but before sending response)
189
190 --abort-during
191 abort association during receipt of C-STORE-RQ
192
193 -pm --promiscuous
194 promiscuous mode, accept unknown SOP classes
195 (not with --config-file)
196
197 -up --uid-padding
198 silently correct space-padded UIDs
199
200 transport layer security (TLS) options
201 transport protocol stack:
202
203 -tls --disable-tls
204 use normal TCP/IP connection (default)
205
206 +tls --enable-tls [p]rivate key file, [c]ertificate file: string
207 use authenticated secure TLS connection
208
209 private key password (only with --enable-tls):
210
211 +ps --std-passwd
212 prompt user to type password on stdin (default)
213
214 +pw --use-passwd [p]assword: string
215 use specified password
216
217 -pw --null-passwd
218 use empty string as password
219
220 key and certificate file format:
221
222 -pem --pem-keys
223 read keys and certificates as PEM file (default)
224
225 -der --der-keys
226 read keys and certificates as DER file
227
228 certification authority:
229
230 +cf --add-cert-file [c]ertificate filename: string
231 add certificate file to list of certificates
232
233 +cd --add-cert-dir [c]ertificate directory: string
234 add certificates in d to list of certificates
235
236 security profile:
237
238 +px --profile-bcp195
239 BCP 195 TLS Profile (default)
240
241 +py --profile-bcp195-nd
242 Non-downgrading BCP 195 TLS Profile
243
244 +pb --profile-basic
245 Basic TLS Secure Transport Connection Profile (retired)
246
247 +pa --profile-aes
248 AES TLS Secure Transport Connection Profile (retired)
249
250 +pn --profile-null
251 Authenticated unencrypted communication
252 (retired, was used in IHE ATNA)
253
254 ciphersuite:
255
256 +cc --list-ciphers
257 show list of supported TLS ciphersuites and exit
258
259 +cs --cipher [c]iphersuite name: string
260 add ciphersuite to list of negotiated suites
261
262 +dp --dhparam [f]ilename: string
263 read DH parameters for DH/DSS ciphersuites
264
265 pseudo random generator:
266
267 +rs --seed [f]ilename: string
268 seed random generator with contents of f
269
270 +ws --write-seed
271 write back modified seed (only with --seed)
272
273 +wf --write-seed-file [f]ilename: string (only with --seed)
274 write modified seed to file f
275
276 peer authentication:
277
278 -rc --require-peer-cert
279 verify peer certificate, fail if absent (default)
280
281 -vc --verify-peer-cert
282 verify peer certificate if present
283
284 -ic --ignore-peer-cert
285 don't verify peer certificate
286
287 output options
288 general:
289
290 -od --output-directory [d]irectory: string (default: ".")
291 write received objects to existing directory d
292
293 bit preserving mode:
294
295 -B --normal
296 allow implicit format conversions (default)
297
298 +B --bit-preserving
299 write data exactly as read
300
301 output file format:
302
303 +F --write-file
304 write file format (default)
305
306 -F --write-dataset
307 write data set without file meta information
308
309 output transfer syntax
310 (not with --bit-preserving or compressed transmission):
311
312 +t= --write-xfer-same
313 write with same TS as input (default)
314
315 +te --write-xfer-little
316 write with explicit VR little endian TS
317
318 +tb --write-xfer-big
319 write with explicit VR big endian TS
320
321 +ti --write-xfer-implicit
322 write with implicit VR little endian TS
323
324 +td --write-xfer-deflated
325 write with deflated explicit VR little endian TS
326
327 post-1993 value representations (not with --bit-preserving):
328
329 +u --enable-new-vr
330 enable support for new VRs (UN/UT) (default)
331
332 -u --disable-new-vr
333 disable support for new VRs, convert to OB
334
335 group length encoding (not with --bit-preserving):
336
337 +g= --group-length-recalc
338 recalculate group lengths if present (default)
339
340 +g --group-length-create
341 always write with group length elements
342
343 -g --group-length-remove
344 always write without group length elements
345
346 length encoding in sequences and items (not with --bit-preserving):
347
348 +e --length-explicit
349 write with explicit lengths (default)
350
351 -e --length-undefined
352 write with undefined lengths
353
354 data set trailing padding
355 (not with --write-dataset or --bit-preserving):
356
357 -p --padding-off
358 no padding (default)
359
360 +p --padding-create [f]ile-pad [i]tem-pad: integer
361 align file on multiple of f bytes and items on
362 multiple of i bytes
363
364 deflate compression level (only with --write-xfer-deflated/same):
365
366 +cl --compression-level [l]evel: integer (default: 6)
367 0=uncompressed, 1=fastest, 9=best compression
368
369 sorting into subdirectories (not with --bit-preserving):
370
371 -ss --sort-conc-studies [p]refix: string
372 sort studies using prefix p and a timestamp
373
374 -su --sort-on-study-uid [p]refix: string
375 sort studies using prefix p and the Study Instance UID
376
377 -sp --sort-on-patientname
378 sort studies using the Patient's Name and a timestamp
379
380 filename generation:
381
382 -uf --default-filenames
383 generate filename from instance UID (default)
384
385 +uf --unique-filenames
386 generate unique filenames
387
388 -tn --timenames
389 generate filename from creation time
390
391 -fe --filename-extension [e]xtension: string
392 append e to all filenames
393
394 event options
395 -xcr --exec-on-reception [c]ommand: string
396 execute command c after having received and processed
397 one C-STORE-RQ message
398
399 -xcs --exec-on-eostudy [c]ommand: string
400 execute command c after having received and processed
401 all C-STORE-RQ messages that belong to one study
402
403 -rns --rename-on-eostudy
404 having received and processed all C-STORE-RQ messages
405 that belong to one study, rename output files according
406 to a certain pattern
407
408 -tos --eostudy-timeout [t]imeout: integer
409 specifies a timeout of t seconds for end-of-study
410 determination
411
412 -xs --exec-sync
413 execute command synchronously in foreground
414
416 The semantic impacts of the above mentioned options is clear for the
417 majority of options. Some particular options, however, are so specific
418 that they need detailed descriptions which will be given in this
419 passage.
420
421 Option --sort-conc-studies enables a user to sort all received DICOM
422 objects into different subdirectories. The sorting will be done with
423 regard to the studies the individual objects belong to, i.e. objects
424 that belong to the same study will be stored in the same subdirectory.
425 In general, a DICOM object d_n+1 is considered to belong to the same
426 study as a DICOM object d_n if and only if d_n and d_n+1 show the exact
427 same values in attribute Study Instance UID. The names of the resulting
428 subdirectories always start with a prefix p which was passed to this
429 option as a parameter. In addition to this prefix, the subdirectory
430 names contain time stamp information with regard to the date and time
431 of reception of this particular study's first DICOM object. In detail,
432 the determination of the subdirectory names pertains to the pattern
433
434 [prefix]_[YYYYMMDD]_[HHMMSSPPP]
435
436 where YYYY refers to year (4 digits), MM to month (01-12), DD to day
437 (01-31), HH to hour (00-23), MM to minute (00-59), SS to second (00-59)
438 and PPP to milliseconds (000-999). If the prefix is an empty string,
439 the first '_' is omitted.
440
441 The other --sort-xxx options work in a similar manner, only the
442 subdirectory names are created differently. For option --sort-on-study-
443 uid the pattern is
444
445 [prefix]_[StudyInstanceUID]
446
447 and for option --sort-on-patientname
448
449 [PatientName]_[YYYYMMDD]_[HHMMSSPPP]
450
451 where 'PatientName' is replaced by 'ANONYMOUS' if the data element is
452 empty or absent in the data set. Any existing patient name is
453 transformed in order to use only ASCII characters. Please note that in
454 this context only the DICOM default character set (ASCII, i.e. no entry
455 in attribute Specific Character Set) and Latin-1 (Specific Character
456 Set valued 'ISO_IR 100') are supported. If another character set is
457 found and the patient name contains non-ASCII characters, a warning is
458 printed and the transformation is performed as if Latin-1 character set
459 would be set in the file. This may lead to unreadable or unexpected
460 patient name directories and behaviour. Thus, it is advisable to use
461 --sort-on-patientname only if Latin-1 or ASCII patient names are
462 expected to be received.
463
464 For option --sort-on-study-uid the same subdirectory will be used for
465 all DICOM objects that belong to the same study, i.e. in contrast to
466 the other --sort-xxx options there is no guarantee that a study
467 directory is ever completed.
468
469 Option --timenames creates filenames from timestamps corresponding to
470 the time, storescp writes a file to disk. The format is
471
472 [YYYYMMDDHHMMSSPPP]_[SERIALNO].[MD]
473
474 where YYYY, MM, DD, HH, MM, SS, PPP are interpreted as described above.
475 If more files are created at the same time, SERIALNO is inserted. It
476 consists of a 4-digit, consecutive number (0000 to 9999). For the first
477 file, that exists for a specific time, no number (and no '_') is
478 inserted at all. MD represents an identification code (2 letters) for
479 the kind of object stored in the file (see notes on --rename-on-
480 eostudy).
481
482 Option --filename-extension appends a specified suffix to each filename
483 (a dot '.' is not added automatically). This suffix is not appended to
484 the filenames created by --rename-on-eostudy to maintain the length of
485 8 characters.
486
487 Option --exec-on-reception allows one to execute a certain command line
488 after having received and processed one DICOM object (through a C-
489 STORE-RQ message). The command line to be executed is passed to this
490 option as a parameter. The specified command line may contain a number
491 of placeholders which will be replaced at run time:
492
493 • #p: complete path to the output directory into which the last DICOM
494 object was stored (not available with option --ignore though)
495 • #f: filename of the current output file (not available with option
496 --ignore though)
497 • #a: calling application entity title of the peer Storage SCU
498 • #c: called application entity title used by the peer Storage SCU to
499 address storescp
500 • #r: calling presentation address, i.e. hostname or IP address of the
501 peer Storage SCU
502 The specified command line is executed as a separate process, so that
503 the execution of storescp will not be held back. This behavior can be
504 influenced with the --exec-sync option.
505 Option --exec-on-eostudy allows one to execute a certain command line
506 when all DICOM objects that belong to one study have been received by
507 storescp. The same placeholders as with --exec-on-reception may be
508 used, except for '#f', which is not supported. A study is considered
509 complete by storescp when an object belonging to a different study is
510 received or the timeout specified with --eostudy-timeout takes place.
511 If option --rename-on-eostudy is in force, the renaming takes place
512 before the external command is executed.
513 Option --rename-on-eostudy refers to the above mentioned --sort-xxx
514 options and can only be used in combination with one of these options.
515 If a user specifies option --rename-on-eostudy and storescp determines
516 that all DICOM objects that belong to a certain study have been
517 received, all DICOM files that belong to the last study will be renamed
518 in the corresponding output directory. The filenames into which the
519 files are being renamed will be calculated using the pattern
520 [prefix][consecutive numbering]
521 where [prefix] is a 2 character prefix that reveals the kind of DICOM
522 object stored in the file and [consecutive numbering] is a
523 consecutively numbered, 6-digit number, starting at '000001'. In
524 general, the question if all DICOM objects that belong to one study
525 have been received by storescp will be answered positively if and only
526 if two consecutively received DICOM objects d_n and d_n+1 do not show
527 the same values in attribute Study Instance UID; in such a case, d_n+1
528 is considered to belong to a new study.
529 Using option --eostudy-timeout a user can modify the determination
530 process to figure out if all DICOM objects that belong to one study
531 have already been received by storescp. With regard to this fact, it is
532 clear that this option can only be used in combination with at least
533 one of the following options: --sort-xxx, --exec-on-eostudy and
534 --rename-on-eostudy. If option --eostudy-timeout is specified, the end
535 of a study is considered to have occurred not only if two consecutively
536 received DICOM objects d_n and d_n+1 do not show the same values in
537 attribute Study Instance UID, but also if within a time span of x
538 seconds after the reception of a DICOM object d_n, no other DICOM
539 object was received over the network. Note that the amount x of seconds
540 (which determines the length of this time span) has to be passed to
541 this option as a parameter.
542 Please note that two consecutive network connections can transfer
543 objects for the same study. The study will only be considered complete
544 when an object of a different study is received or the --eostudy-
545 timeout is reached. For this reason, the options --fork and --inet are
546 incompatible with --exec-on-eostudy, --rename-on-eostudy and --sort-
547 conc-studies.
548 DICOM Conformance
549 The storescp application supports the following SOP Classes as an SCP:
550 VerificationSOPClass 1.2.840.10008.1.1
551
552 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
553 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
554 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
555 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
556 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
557 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
558 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
559 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
560 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
561 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
562 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
563 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
564 LegacyConvertedEnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.2
565 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
566 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
567 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
568 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
569 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
570 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
571 LegacyConvertedEnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.4
572 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
573 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
574 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
575 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
576 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
577 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
578 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
579 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
580 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
581 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
582 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
583 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
584 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
585 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
586 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
587 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
588 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
589 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
590 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
591 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
592 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
593 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
594 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
595 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
596 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
597 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
598 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
599 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
600 GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
601 CompositingPlanarMPRVolumetricPresent.StateStorage 1.2.840.10008.5.1.4.1.1.11.7
602 AdvancedBlendingPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.8
603 VolumeRenderingVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.9
604 SegmentedVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.10
605 MultipleVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.11
606 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
607 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
608 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
609 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
610 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
611 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
612 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
613 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
614 BreastProjectionXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.13.1.4
615 BreastProjectionXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.13.1.5
616 IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
617 IntravascularOpt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
618 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
619 ParametricMapStorage 1.2.840.10008.5.1.4.1.1.30
620 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
621 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
622 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
623 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
624 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
625 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
626 TractographyResultsStorage 1.2.840.10008.5.1.4.1.1.66.6
627 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
628 SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
629 SurfaceScanPointCloudStorage 1.2.840.10008.5.1.4.1.1.68.2
630 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
631 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
632 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
633 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
634 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
635 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
636 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
637 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
638 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
639 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
640 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
641 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
642 WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.5
643 WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
644 OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.7
645 OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
646 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
647 RETIRED_VLMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.77.2
648 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
649 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
650 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
651 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
652 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
653 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
654 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
655 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
656 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
657 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
658 OphthalmicThicknessMapStorage 1.2.840.10008.5.1.4.1.1.81.1
659 CornealTopographyMapStorage 1.2.840.10008.5.1.4.1.1.82.1
660 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
661 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
662 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
663 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
664 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
665 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
666 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
667 Comprehensive3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
668 ExtensibleSRStorage 1.2.840.10008.5.1.4.1.1.88.35
669 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
670 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
671 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
672 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
673 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
674 RadiopharmaceuticalRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.68
675 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
676 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
677 AcquisitionContextSRStorage 1.2.840.10008.5.1.4.1.1.88.71
678 SimplifiedAdultEchoSRStorage 1.2.840.10008.5.1.4.1.1.88.72
679 PatientRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.73
680 ContentAssessmentResultsStorage 1.2.840.10008.5.1.4.1.1.90.1
681 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
682 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
683 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
684 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
685 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
686 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
687 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
688 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
689 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
690 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
691 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
692 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
693 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
694 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
695 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
696 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
697 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
698 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
699 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
700 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
701 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
702 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
703 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
704 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
705 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
706 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
707 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
708 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
709 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
710 The storescp application will accept presentation contexts for all of
711 the abovementioned supported SOP Classes using any of the following
712 transfer syntaxes:
713 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
714 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
715 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
716 The default behavior of the storescp application is to prefer transfer
717 syntaxes having an explicit encoding over the default implicit transfer
718 syntax. If storescp is running on big-endian hardware it will prefer
719 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
720 versa). This behavior can be changed with the --prefer options (see
721 above). Using option --accept-all any of the following transfer
722 syntaxes is supported:
723 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
724 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
725 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
726 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
727 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
728 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
729 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
730 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
731 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
732 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
733 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
734 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
735 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
736 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
737 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
738 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
739 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
740 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
741 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
742 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
743 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
744 Additional Storage SOP Classes and Transfer Syntaxes can be used with
745 the so-called 'association negotiation profiles' (see below).
746 The storescp application does not support extended negotiation by
747 default. However, using an appropriate association negotiation profile
748 (see below) the optional support for extended negotiation can be added
749 to particular SOP classes.
750 Access Control
751 When compiled on Unix platforms with TCP wrapper support, host-based
752 access control can be enabled with the --access-control command line
753 option. In this case the access control rules defined in the system's
754 host access control tables for storescp are enforced. The default
755 locations of the host access control tables are /etc/hosts.allow and
756 /etc/hosts.deny. Further details are described in hosts_access(5).
757 Running storescp from inetd
758 On Posix platforms, storescp can be initiated through the inetd(8)
759 super server. This requires that storescp be configured in the
760 /etc/inetd.conf configuration file. A typical configuration line could
761 look like this:
762 acr-nema stream tcp nowait root /usr/sbin/storescp -id +ac -od /tmp/storescp
763 where -id (--inetd) activates the inetd mode in which the DICOM
764 association is actually accepted by inetd and passed to storescp, +ac
765 (--access-control) activates the TCP wrapper based access control
766 described above and -od (--output-directory) defines the directory in
767 which storescp stores incoming DICOM objects. Note that the service
768 name ('acr-nema' in this example) determines the port number on which
769 DICOM associations are accepted and must be defined in /etc/services.
770 When running from inetd, the stdout and stderr streams are discarded.
771 However, you can still configure logging via the --log-config option
772 (see below).
773 Please note that when run through inetd, storescp is executed with root
774 privileges, which may be a security risk.
775 Association Negotiation Profiles and Configuration Files
776 storescp supports a flexible mechanism for specifying the DICOM network
777 association negotiation behavior, based on so-called 'association
778 negotiation profiles' which may be read from a configuration file. The
779 format and semantics of this configuration file are documented in
780 asconfig.txt.
782 The level of logging output of the various command line tools and
783 underlying libraries can be specified by the user. By default, only
784 errors and warnings are written to the standard error stream. Using
785 option --verbose also informational messages like processing details
786 are reported. Option --debug can be used to get more details on the
787 internal activity, e.g. for debugging purposes. Other logging levels
788 can be selected using option --log-level. In --quiet mode only fatal
789 errors are reported. In such very severe error events, the application
790 will usually terminate. For more details on the different logging
791 levels, see documentation of module 'oflog'.
792 In case the logging output should be written to file (optionally with
793 logfile rotation), to syslog (Unix) or the event log (Windows) option
794 --log-config can be used. This configuration file also allows for
795 directing only certain messages to a particular output stream and for
796 filtering certain messages based on the module or application where
797 they are generated. An example configuration file is provided in
798 <etcdir>/logger.cfg.
800 All command line tools use the following notation for parameters:
801 square brackets enclose optional values (0-1), three trailing dots
802 indicate that multiple values are allowed (1-n), a combination of both
803 means 0 to n values.
804 Command line options are distinguished from parameters by a leading '+'
805 or '-' sign, respectively. Usually, order and position of command line
806 options are arbitrary (i.e. they can appear anywhere). However, if
807 options are mutually exclusive the rightmost appearance is used. This
808 behavior conforms to the standard evaluation rules of common Unix
809 shells.
810 In addition, one or more command files can be specified using an '@'
811 sign as a prefix to the filename (e.g. @command.txt). Such a command
812 argument is replaced by the content of the corresponding text file
813 (multiple whitespaces are treated as a single separator unless they
814 appear between two quotation marks) prior to any further evaluation.
815 Please note that a command file cannot contain another command file.
816 This simple but effective approach allows one to summarize common
817 combinations of options/parameters and avoids longish and confusing
818 command lines (an example is provided in file <datadir>/dumppat.txt).
820 The storescp utility will attempt to load DICOM data dictionaries
821 specified in the DCMDICTPATH environment variable. By default, i.e. if
822 the DCMDICTPATH environment variable is not set, the file
823 <datadir>/dicom.dic will be loaded unless the dictionary is built into
824 the application (default for Windows).
825 The default behavior should be preferred and the DCMDICTPATH
826 environment variable only used when alternative data dictionaries are
827 required. The DCMDICTPATH environment variable has the same format as
828 the Unix shell PATH variable in that a colon (':') separates entries.
829 On Windows systems, a semicolon (';') is used as a separator. The data
830 dictionary code will attempt to load each file specified in the
831 DCMDICTPATH environment variable. It is an error if no data dictionary
832 can be loaded.
834 <docdir>/asconfig.txt - configuration file documentation
835 <etcdir>/storescp.cfg - example association negotiation profile
837 storescu(1)
839 Copyright (C) 1996-2018 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
840 Germany.
841
842
843
844Version 3.6.4 Thu Nov 29 2018 storescp(1)