/usr/bin/getscu

$dcmtk: getscu v3.7.1 2026-10-15 $

getscu: DICOM retrieve (C-GET) SCU
usage: getscu [options] peer port [dcmfile-in...]

parameters:
  peer                           hostname of DICOM peer
  port                           tcp/ip port number of peer
  dcmfile-in                     DICOM query file(s)

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
  +v      --verbose-pc           show presentation contexts in verbose mode
network options:
  override matching keys:
    -k    --key                  [k]ey: gggg,eeee="str", path or dic. name="str"
                                 override matching key
  retrieve information model:
    -P    --patient              use patient root information model (default)
    -S    --study                use study root information model
    -O    --psonly               use patient/study only information model
  IP protocol version:
    -i4   --ipv4                 use IPv4 only (default)
    -i6   --ipv6                 use IPv6 only
    -i0   --ip-auto              use DNS lookup to determine IP protocol
  application entity titles:
    -aet  --aetitle              [a]etitle: string
                                 set my calling AE title (default: GETSCU)
    -aec  --call                 [a]etitle: string
                                 set called AE title of peer (default: ANY-SCP)
  preferred storage 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 HP / 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 explicit VR little endian TS
    +xi   --implicit             accept implicit VR little endian TS only
  proposed retrieve 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
    -xd   --propose-deflated     propose deflated explicit VR little endian TS
                                 and all uncompressed transfer syntaxes
    -xi   --propose-implicit     propose implicit VR little endian TS only
  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: 16384)
          --repeat               [n]umber: integer
                                 repeat n times
          --abort                abort association instead of releasing it
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
    +tla  --anonymous-tls        use secure TLS connection without certificate
  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)
  server name indication:
          --no-sni               do not use SNI (default)
          --request-sni          [s]erver name: string
                                 request 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)
    -ic   --ignore-peer-cert     don't verify peer certificate
output options:
  general:
    -od   --output-directory     [d]irectory: string (default: ".")
                                 write received objects to existing directory d
  storage mode:
    -B    --normal               receive in memory, then write to disk (default)
    +B    --bit-preserving       receive directly to disk
          --ignore               ignore store data, receive but do not store