$dcmtk: dcmqrscp v3.7.1 2026-10-15 $
dcmqrscp: DICOM image archive (central test node)
usage: dcmqrscp [options] [port]
parameters:
port tcp/ip port number to listen on
(default: in config file)
general options:
-h --help print this help text and exit
--version print version information and exit
--arguments print expanded command line arguments
-q --quiet quiet mode, print no warnings and errors
-v --verbose verbose mode, print processing details
-d --debug debug mode, print debug information
-ll --log-level [l]evel: string constant
(fatal, error, warn, info, debug, trace)
use level l for the logger
-lc --log-config [f]ilename: string
use config file f for the logger
-c --config [f]ilename: string
use specific configuration file
(default: /etc/dcmtk-3.7.1/dcmqrscp.cfg)
multi-process options:
-s --single-process single process mode
--fork fork child process for each assoc. (default)
database options:
association negotiation:
--require-find reject all MOVE/GET presentation contexts for
which no correspond. FIND context is proposed
--no-parallel-store reject multiple simultaneous STORE presentat.
contexts for one application entity title
--disable-get disable C-GET support
--allow-shutdown allow external shutdown via private SOP class
checking identifier validity:
-XF --check-find check C-FIND identifier validity
--no-check-find do not check C-FIND identifier validity (def.)
-XM --check-move check C-MOVE identifier validity
--no-check-move do not check C-MOVE identifier validity (def.)
restriction of move targets:
--move-unrestricted do not restrict move destination (default)
-ZA --move-aetitle restrict move dest. to requesting AE title
-ZH --move-host restrict move destination to requesting host
-ZV --move-vendor restrict move destination to requesting vendor
restriction of query/retrieve models:
-QP --no-patient-root do not support Patient Root Q/R models
-QS --no-study-root do not support Study Root Q/R models
-QO --no-patient-study do not support Patient/Study Only Q/R models
network options:
IP protocol version:
-i4 --ipv4 use IPv4 only (default)
-i6 --ipv6 use IPv6 only
-i0 --ip-auto use IPv6/IPv4 dual stack
association negotiation profiles from configuration file:
-xf --assoc-config-file [f]ilename, [i]n-prof, [o]ut-prof: string
use profile i from f for incoming,
and profile o from f for outgoing associations
preferred network transfer syntaxes (incoming associations):
+x= --prefer-uncompr prefer explicit VR local byte order (default)
+xe --prefer-little prefer explicit VR little endian TS
+xb --prefer-big prefer explicit VR big endian TS
+xs --prefer-lossless prefer default JPEG lossless TS
+xy --prefer-jpeg8 prefer default JPEG lossy TS for 8 bit data
+xx --prefer-jpeg12 prefer default JPEG lossy TS for 12 bit data
+xv --prefer-j2k-lossless prefer JPEG 2000 lossless TS
+xw --prefer-j2k-lossy prefer JPEG 2000 lossy TS
+xt --prefer-jls-lossless prefer JPEG-LS lossless TS
+xu --prefer-jls-lossy prefer JPEG-LS lossy TS
+xm --prefer-mpeg2 prefer MPEG2 Main Profile @ Main Level TS
+xh --prefer-mpeg2-high prefer MPEG2 Main Profile @ High Level TS
+xn --prefer-mpeg4 prefer MPEG4 AVC/H.264 HP / Level 4.1 TS
+xl --prefer-mpeg4-bd prefer MPEG4 AVC/H.264 BD-compatible TS
+x2 --prefer-mpeg4-2-2d prefer MPEG4 AVC/H.264 HP / Level 4.2 TS (2D)
+x3 --prefer-mpeg4-2-3d prefer MPEG4 AVC/H.264 HP / Level 4.2 TS (3D)
+xo --prefer-mpeg4-2-st prefer MPEG4 AVC/H.264 Stereo / Level 4.2 TS
+x4 --prefer-hevc prefer HEVC/H.265 Main Profile / Level 5.1 TS
+x5 --prefer-hevc10 prefer HEVC/H.265 Main 10 Profile / L5.1 TS
+xr --prefer-rle prefer RLE lossless TS
+xd --prefer-deflated prefer deflated expl. VR little endian TS
+xi --implicit accept implicit VR little endian TS only
proposed transmission transfer syntaxes (outgoing associations):
-x= --propose-uncompr propose all uncompressed TS, explicit VR
with local byte ordering first (default)
-xe --propose-little propose all uncompressed TS, explicit VR
little endian first
-xb --propose-big propose all uncompressed TS, explicit VR
big endian first
-xi --propose-implicit propose implicit VR little endian TS only
-xs --propose-lossless propose default JPEG lossless TS
and all uncompressed transfer syntaxes
-xy --propose-jpeg8 propose default JPEG lossy TS for 8 bit data
and all uncompressed transfer syntaxes
-xx --propose-jpeg12 propose default JPEG lossy TS for 12 bit data
and all uncompressed transfer syntaxes
-xv --propose-j2k-lossless propose JPEG 2000 lossless TS
and all uncompressed transfer syntaxes
-xw --propose-j2k-lossy propose JPEG 2000 lossy TS
and all uncompressed transfer syntaxes
-xt --propose-jls-lossless propose JPEG-LS lossless TS
and all uncompressed transfer syntaxes
-xu --propose-jls-lossy propose JPEG-LS lossy TS
and all uncompressed transfer syntaxes
-xm --propose-mpeg2 propose MPEG2 Main Profile @ Main Level TS
-xh --propose-mpeg2-high propose MPEG2 Main Profile @ High Level TS
-xn --propose-mpeg4 propose MPEG4 AVC/H.264 HP / Level 4.1 TS
-xl --propose-mpeg4-bd propose MPEG4 AVC/H.264 BD-compatible TS
-x2 --propose-mpeg4-2-2d propose MPEG4 AVC/H.264 HP / Level 4.2 TS (2D)
-x3 --propose-mpeg4-2-3d propose MPEG4 AVC/H.264 HP / Level 4.2 TS (3D)
-xo --propose-mpeg4-2-st propose MPEG4 AVC/H.264 Stereo / Level 4.2 TS
-x4 --propose-hevc propose HEVC/H.265 Main Profile / Level 5.1 TS
-x5 --propose-hevc10 propose HEVC/H.265 Main 10 Profile / L5.1 TS
-xr --propose-rle propose RLE lossless TS
and all uncompressed transfer syntaxes
-xd --propose-deflated propose deflated expl. VR little endian TS
and all uncompressed transfer syntaxes
other network options:
-to --timeout [s]econds: integer (default: unlimited)
timeout for connection requests
-ta --acse-timeout [s]econds: integer (default: 30)
timeout for ACSE messages
-td --dimse-timeout [s]econds: integer (default: unlimited)
timeout for DIMSE messages
-pdu --max-pdu [n]umber of bytes: integer (4096..131072)
set max receive pdu to n bytes
(default: use value from configuration file)
-dhl --disable-host-lookup disable hostname lookup
--refuse refuse association
--reject reject association if no implement. class UID
--ignore ignore store data, receive but do not store
-up --uid-padding silently correct space-padded UIDs
processing options:
specific character set:
+Cr --use-request-charset try to convert all element values that are
affected by Specific Character Set (0008,0005)
to the one specified in the request data set,
fall back to the one specified via
--convert-to-xxx if that is not possible
(default, unless overridden by config file)
-Cr --override-charset convert affected element values to the
character set specified via --convert-to-xxx,
ignoring the one specified in the request
+A7 --convert-to-ascii convert affected element values to 7-bit ASCII
(default, unless overridden by config file)
+U8 --convert-to-utf8 convert affected element values to UTF-8
+L1 --convert-to-latin1 convert affected element values to ISO 8859-1
+C --convert-to-charset [c]harset: string
convert affected element values to the char.
set specified by the DICOM defined term c
-Ct --transliterate try to approximate characters that cannot be
represented through similar looking characters
-Cd --discard-illegal discard characters that cannot be represented
in destination character set
transport layer security (TLS) options:
transport protocol stack:
-tls --disable-tls use normal TCP/IP connection (default)
+tls --enable-tls [p]rivate key file, [c]ertificate file: string
use authenticated secure TLS connection
private key password (only with --enable-tls):
+ps --std-passwd prompt user to type password on stdin (default)
+pw --use-passwd [p]assword: string
use specified password
-pw --null-passwd use empty string as password
key and certificate file format:
-pem --pem-keys read keys and certs as PEM file (default)
-der --der-keys read keys and certificates as DER file
certification authority:
+cf --add-cert-file [f]ilename: string
add certificate file to list of certificates
+cd --add-cert-dir [d]irectory: string
add certificates in d to list of certificates
+crl --add-crl-file [f]ilename: string
add certificate revocation list file
(implies --enable-crl-vfy)
+crv --enable-crl-vfy enable leaf CRL verification
+cra --enable-crl-all enable full chain CRL verification
security profile:
+ph --list-profiles list supported TLS profiles and exit
+pg --profile-8996 BCP 195 RFC 8996 TLS Profile (default)
+pm --profile-8996-mod Modified BCP 195 RFC 8996 TLS Profile
+py --profile-bcp195-nd Non-downgrading BCP 195 TLS Profile (retired)
+px --profile-bcp195 BCP 195 TLS Profile (retired)
+pz --profile-bcp195-ex Extended BCP 195 TLS Profile (retired)
+pa --profile-aes AES TLS Secure Transport Connection Profile
(retired)
ciphersuite:
+cc --list-ciphers list supported TLS ciphersuites and exit
+cs --cipher [c]iphersuite name: string
add ciphersuite to list of negotiated suites
(not with --profile-bcp195-ex)
+dp --dhparam [f]ilename: string
read DH parameters for DH/DSS ciphersuites
server name indication:
--no-sni do not use SNI (default)
--request-sni [s]erver name: string
request server name s
--expect-sni [s]erver name: string
expect requests for server name s
pseudo random generator:
+rs --seed [f]ilename: string
seed random generator with contents of f
+ws --write-seed write back modified seed (only with --seed)
+wf --write-seed-file [f]ilename: string (only with --seed)
write modified seed to file f
peer authentication:
-rc --require-peer-cert verify peer cert, fail if absent (default)
-vc --verify-peer-cert verify peer certificate if present
-ic --ignore-peer-cert don't verify peer certificate
output options:
bit preserving mode:
-B --normal allow implicit format conversions (default)
+B --bit-preserving write data exactly as read
output file format:
+F --write-file write file format (default)
-F --write-dataset write data set without file meta information
output transfer syntax (not with --bit-preserving or compressed transmission):
+t= --write-xfer-same write with same TS as input (default)
+te --write-xfer-little write with explicit VR little endian TS
+tb --write-xfer-big write with explicit VR big endian TS
+ti --write-xfer-implicit write with implicit VR little endian TS
+td --write-xfer-deflated write with deflated expl. VR little endian TS
post-1993 value representations:
+u --enable-new-vr enable support for new VRs (UN/UT) (default)
-u --disable-new-vr disable support for new VRs, convert to OB
group length encoding (not with --bit-preserving):
+g= --group-length-recalc recalculate group lengths if present (default)
+g --group-length-create always write with group length elements
-g --group-length-remove always write without group length elements
length encoding in sequences and items (not with --bit-preserving):
+e --length-explicit write with explicit lengths (default)
-e --length-undefined write with undefined lengths
data set trailing padding (not with --write-dataset or --bit-preserving):
-p --padding-off no padding (default)
+p --padding-create [f]ile-pad [i]tem-pad: integer
align file on multiple of f bytes
and items on multiple of i bytes
deflate compression level (only with -xd or --write-xfer-deflated/same):
+cl --compression-level [l]evel: integer (default: 6)
0=uncompressed, 1=fastest, 9=best compression
Options (80)
| Option | Description | Source |
|---|---|---|
-h | --help print this help text and exit | help |
--version | print version information and exit | help |
--arguments | print expanded command line arguments | help |
-q | --quiet quiet mode, print no warnings and errors | help |
-v | --verbose verbose mode, print processing details | help |
-d | --debug debug mode, print debug information | help |
-ll | --log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) use level l for the logger | help |
-lc | --log-config [f]ilename: string use config file f for the logger | help |
-c | --config [f]ilename: string use specific configuration file (default: /etc/dcmtk-3.7.1/dcmqrscp.cfg) | help |
-s | --single-process single process mode | help |
--fork | fork child process for each assoc. | help |
--require-find | reject all MOVE/GET presentation contexts for which no correspond. | help |
--no-parallel-store | reject multiple simultaneous STORE presentat. | help |
--disable-get | disable C-GET support | help |
--allow-shutdown | allow external shutdown via private SOP class | help |
-XF | --check-find check C-FIND identifier validity | help |
--no-check-find | do not check C-FIND identifier validity (def.) | help |
-XM | --check-move check C-MOVE identifier validity | help |
--no-check-move | do not check C-MOVE identifier validity (def.) | help |
--move-unrestricted | do not restrict move destination (default) | help |
-ZA | --move-aetitle restrict move dest. | help |
-ZH | --move-host restrict move destination to requesting host | help |
-ZV | --move-vendor restrict move destination to requesting vendor | help |
-QP | --no-patient-root do not support Patient Root Q/R models | help |
-QS | --no-study-root do not support Study Root Q/R models | help |
-QO | --no-patient-study do not support Patient/Study Only Q/R models | help |
-i4 | --ipv4 use IPv4 only (default) | help |
-i6 | --ipv6 use IPv6 only | help |
-i0 | --ip-auto use IPv6/IPv4 dual stack | help |
-xf | --assoc-config-file [f]ilename, [i]n-prof, [o]ut-prof: string use profile i from f for incoming, and profile o from f for outgoing associations | help |
-x | --propose-uncompr propose all uncompressed TS, explicit VR with local byte ordering first (default) | help |
-xe | --propose-little propose all uncompressed TS, explicit VR little endian first | help |
-xb | --propose-big propose all uncompressed TS, explicit VR big endian first | help |
-xi | --propose-implicit propose implicit VR little endian TS only | help |
-xs | --propose-lossless propose default JPEG lossless TS and all uncompressed transfer syntaxes | help |
-xy | --propose-jpeg8 propose default JPEG lossy TS for 8 bit data and all uncompressed transfer syntaxes | help |
-xx | --propose-jpeg12 propose default JPEG lossy TS for 12 bit data and all uncompressed transfer syntaxes | help |
-xv | --propose-j2k-lossless propose JPEG 2000 lossless TS and all uncompressed transfer syntaxes | help |
-xw | --propose-j2k-lossy propose JPEG 2000 lossy TS and all uncompressed transfer syntaxes | help |
-xt | --propose-jls-lossless propose JPEG-LS lossless TS and all uncompressed transfer syntaxes | help |
-xu | --propose-jls-lossy propose JPEG-LS lossy TS and all uncompressed transfer syntaxes | help |
-xm | --propose-mpeg2 propose MPEG2 Main Profile @ Main Level TS | help |
-xh | --propose-mpeg2-high propose MPEG2 Main Profile @ High Level TS | help |
-xn | --propose-mpeg4 propose MPEG4 AVC/H.264 HP / Level 4.1 TS | help |
-xl | --propose-mpeg4-bd propose MPEG4 AVC/H.264 BD-compatible TS | help |
-x2 | --propose-mpeg4-2-2d propose MPEG4 AVC/H.264 HP / Level 4.2 TS (2D) | help |
-x3 | --propose-mpeg4-2-3d propose MPEG4 AVC/H.264 HP / Level 4.2 TS (3D) | help |
-xo | --propose-mpeg4-2-st propose MPEG4 AVC/H.264 Stereo / Level 4.2 TS | help |
-x4 | --propose-hevc propose HEVC/H.265 Main Profile / Level 5.1 TS | help |
-x5 | --propose-hevc10 propose HEVC/H.265 Main 10 Profile / L5.1 TS | help |
-xr | --propose-rle propose RLE lossless TS and all uncompressed transfer syntaxes | help |
-xd | --propose-deflated propose deflated expl. | help |
-to | --timeout [s]econds: integer (default: unlimited) timeout for connection requests | help |
-ta | --acse-timeout [s]econds: integer (default: 30) timeout for ACSE messages | help |
-td | --dimse-timeout [s]econds: integer (default: unlimited) timeout for DIMSE messages | help |
-pdu | --max-pdu [n]umber of bytes: integer (4096..131072) set max receive pdu to n bytes (default: use value from configuration file) | help |
-dhl | --disable-host-lookup disable hostname lookup | help |
--refuse | refuse association | help |
--reject | reject association if no implement. | help |
--ignore | ignore store data, receive but do not store | help |
-up | --uid-padding silently correct space-padded UIDs | help |
-Cr | --override-charset convert affected element values to the character set specified via --convert-to-xxx, ignoring the one specified in the request | help |
-Ct | --transliterate try to approximate characters that cannot be represented through similar looking characters | help |
-Cd | --discard-illegal discard characters that cannot be represented in destination character set | help |
-tls | --disable-tls use normal TCP/IP connection (default) | help |
-pw | --null-passwd use empty string as password | help |
-pem | --pem-keys read keys and certs as PEM file (default) | help |
-der | --der-keys read keys and certificates as DER file | help |
--no-sni | do not use SNI (default) | help |
--request-sni | [s]erver name: string request server name s | help |
--expect-sni | [s]erver name: string expect requests for server name s | help |
-rc | --require-peer-cert verify peer cert, fail if absent (default) | help |
-vc | --verify-peer-cert verify peer certificate if present | help |
-ic | --ignore-peer-cert don't verify peer certificate | help |
-B | --normal allow implicit format conversions (default) | help |
-F | --write-dataset write data set without file meta information | help |
-u | --disable-new-vr disable support for new VRs, convert to OB | help |
-g | --group-length-remove always write without group length elements | help |
-e | --length-undefined write with undefined lengths | help |
-p | --padding-off no padding (default) | help |