/usr/bin/findscu

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

findscu: DICOM query (C-FIND) SCU
usage: findscu [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
network options:
  override matching keys:
    -k    --key                 [k]ey: gggg,eeee="str", path or dict. name="str"
                                override matching key
  query information model:
    -W    --worklist            use modality worklist information model (def.)
    -P    --patient             use patient root information model
    -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: FINDSCU)
    -aec  --call                [a]etitle: string
                                set called AE title of peer (default: ANY-SCP)
  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
  proposed transmission transfer syntaxes:
    -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
  deflate compression level (only with --propose-deflated):
    +cl   --compression-level   [l]evel: integer (default: 6)
                                0=uncompressed, 1=fastest, 9=best compression
  other network options:
    -to   --timeout             [s]econds: integer (default: unlimited)
                                timeout for connection requests
    -ts   --socket-timeout      [s]econds: integer (default: 60)
                                timeout for network socket (0 for none)
    -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
          --cancel              [n]umber: integer
                                cancel after n responses (default: never)
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 output files to existing directory d
  automatic data correction:
    +dc   --enable-correction   enable automatic data correction
    -dc   --disable-correction  disable automatic data correction (default)
  C-FIND responses:
    +sr   --show-responses      always output responses to the logger
    -sr   --hide-responses      do not output responses to the logger
    -X    --extract             extract responses to DICOM file (rsp0001.dcm...)
    -Xx   --extract-xml         extract responses to XML file (rsp0001.xml...)
    -Xs   --extract-xml-single  [f]ilename: string
                                extract all responses to given XML file f
    -Xlo  --limit-output        [n]umber: integer
                                limit number of responses extracted to file to n
                                (default: unlimited)