OS Manuals

/usr/bin/dcmqrscp

DCMTK is a collection of libraries and applications implementing large parts the DICOM standard.

From dcmtk 3.7.1-r0 (os), captured 2026-11-05 by running dcmqrscp --help (exit 0). permalink

$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)
OptionDescriptionSource
-h--help print this help text and exithelp
--versionprint version information and exithelp
--argumentsprint expanded command line argumentshelp
-q--quiet quiet mode, print no warnings and errorshelp
-v--verbose verbose mode, print processing detailshelp
-d--debug debug mode, print debug informationhelp
-ll--log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) use level l for the loggerhelp
-lc--log-config [f]ilename: string use config file f for the loggerhelp
-c--config [f]ilename: string use specific configuration file (default: /etc/dcmtk-3.7.1/dcmqrscp.cfg)help
-s--single-process single process modehelp
--forkfork child process for each assoc.help
--require-findreject all MOVE/GET presentation contexts for which no correspond.help
--no-parallel-storereject multiple simultaneous STORE presentat.help
--disable-getdisable C-GET supporthelp
--allow-shutdownallow external shutdown via private SOP classhelp
-XF--check-find check C-FIND identifier validityhelp
--no-check-finddo not check C-FIND identifier validity (def.)help
-XM--check-move check C-MOVE identifier validityhelp
--no-check-movedo not check C-MOVE identifier validity (def.)help
--move-unrestricteddo not restrict move destination (default)help
-ZA--move-aetitle restrict move dest.help
-ZH--move-host restrict move destination to requesting hosthelp
-ZV--move-vendor restrict move destination to requesting vendorhelp
-QP--no-patient-root do not support Patient Root Q/R modelshelp
-QS--no-study-root do not support Study Root Q/R modelshelp
-QO--no-patient-study do not support Patient/Study Only Q/R modelshelp
-i4--ipv4 use IPv4 only (default)help
-i6--ipv6 use IPv6 onlyhelp
-i0--ip-auto use IPv6/IPv4 dual stackhelp
-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 associationshelp
-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 firsthelp
-xb--propose-big propose all uncompressed TS, explicit VR big endian firsthelp
-xi--propose-implicit propose implicit VR little endian TS onlyhelp
-xs--propose-lossless propose default JPEG lossless TS and all uncompressed transfer syntaxeshelp
-xy--propose-jpeg8 propose default JPEG lossy TS for 8 bit data and all uncompressed transfer syntaxeshelp
-xx--propose-jpeg12 propose default JPEG lossy TS for 12 bit data and all uncompressed transfer syntaxeshelp
-xv--propose-j2k-lossless propose JPEG 2000 lossless TS and all uncompressed transfer syntaxeshelp
-xw--propose-j2k-lossy propose JPEG 2000 lossy TS and all uncompressed transfer syntaxeshelp
-xt--propose-jls-lossless propose JPEG-LS lossless TS and all uncompressed transfer syntaxeshelp
-xu--propose-jls-lossy propose JPEG-LS lossy TS and all uncompressed transfer syntaxeshelp
-xm--propose-mpeg2 propose MPEG2 Main Profile @ Main Level TShelp
-xh--propose-mpeg2-high propose MPEG2 Main Profile @ High Level TShelp
-xn--propose-mpeg4 propose MPEG4 AVC/H.264 HP / Level 4.1 TShelp
-xl--propose-mpeg4-bd propose MPEG4 AVC/H.264 BD-compatible TShelp
-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 TShelp
-x4--propose-hevc propose HEVC/H.265 Main Profile / Level 5.1 TShelp
-x5--propose-hevc10 propose HEVC/H.265 Main 10 Profile / L5.1 TShelp
-xr--propose-rle propose RLE lossless TS and all uncompressed transfer syntaxeshelp
-xd--propose-deflated propose deflated expl.help
-to--timeout [s]econds: integer (default: unlimited) timeout for connection requestshelp
-ta--acse-timeout [s]econds: integer (default: 30) timeout for ACSE messageshelp
-td--dimse-timeout [s]econds: integer (default: unlimited) timeout for DIMSE messageshelp
-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 lookuphelp
--refuserefuse associationhelp
--rejectreject association if no implement.help
--ignoreignore store data, receive but do not storehelp
-up--uid-padding silently correct space-padded UIDshelp
-Cr--override-charset convert affected element values to the character set specified via --convert-to-xxx, ignoring the one specified in the requesthelp
-Ct--transliterate try to approximate characters that cannot be represented through similar looking charactershelp
-Cd--discard-illegal discard characters that cannot be represented in destination character sethelp
-tls--disable-tls use normal TCP/IP connection (default)help
-pw--null-passwd use empty string as passwordhelp
-pem--pem-keys read keys and certs as PEM file (default)help
-der--der-keys read keys and certificates as DER filehelp
--no-snido not use SNI (default)help
--request-sni[s]erver name: string request server name shelp
--expect-sni[s]erver name: string expect requests for server name shelp
-rc--require-peer-cert verify peer cert, fail if absent (default)help
-vc--verify-peer-cert verify peer certificate if presenthelp
-ic--ignore-peer-cert don't verify peer certificatehelp
-B--normal allow implicit format conversions (default)help
-F--write-dataset write data set without file meta informationhelp
-u--disable-new-vr disable support for new VRs, convert to OBhelp
-g--group-length-remove always write without group length elementshelp
-e--length-undefined write with undefined lengthshelp
-p--padding-off no padding (default)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.