NAME

    echoscu


SYNOPSIS

    echoscu [options] peer port


SUMMARY

The echoscu application implements a Service Class User (SCU) for the
Verification SOP Class.  It sends a DICOM C-ECHO message to a Service
Class Provider (SCP) and waits for a response.  The application can be
used to verify basic DICOM connectivity.


USAGE

echoscu: DICOM verification (C-ECHO) SCU
usage: echoscu [options] peer port

parameters:
  peer                         hostname of DICOM peer
  port                         tcp/ip port number of peer

general options:
  -h      --help               print this help text and exit
          --version            print version information and exit
  -v      --verbose            verbose mode, print processing details
  -d      --debug              debug mode, print debug information
network options:
  application entity titles:
    -aet  --aetitle            aetitle: string
                               set my calling AE title (default: ECHOSCU)
    -aec  --call               aetitle: string
                               set called AE title of peer (default: ANY-SCP)
  association negotiation debugging:
    -pts  --propose-ts         [n]umber: integer (1..22)
                               propose n transfer syntaxes
    -ppc  --propose-pc         [n]umber: integer (1..128)
                               propose n presentation contexts
  other network options:
    -to   --timeout            [s]econds: integer (default: unlimited)
                               timeout for connection requests
    -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 options:
    -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 options (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 options:
    -pem  --pem-keys           read keys and certificates as PEM file (default)
    -der  --der-keys           read keys and certificates as DER file
  certification authority options:
    +cf   --add-cert-file      [c]ertificate filename: string
                               add certificate file to list of certificates
    +cd   --add-cert-dir       [c]ertificate directory: string
                               add certificates in d to list of certificates
  ciphersuite options:
    +cs   --cipher             [c]iphersuite name: string
                               add ciphersuite to list of negotiated suites
    +dp   --dhparam            [f]ilename: string
                               read DH parameters for DH/DSS ciphersuites
  pseudo random generator options:
    +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 options:
    -rc   --require-peer-cert  verify peer certificate, fail if absent (default)
    -vc   --verify-peer-cert   verify peer certificate if present
    -ic   --ignore-peer-cert   don't verify peer certificate


DICOM CONFORMANCE

The echoscu application supports the SOP Classes as an SCU:

    VerificationSOPClass	"1.2.840.10008.1.1"

Unless the --propose-ts option is used, the echoscu application will only
propose the transfer syntax

    LittleEndianImplicitTransferSyntax	"1.2.840.10008.1.2"


ENVIRONMENT

The echoscu application will attempt to load DICOM data dictionaries specified
in the DCMDICTPATH environment variable.  By default, if the DCMDICTPATH
environment variable is not set, the file /usr/local/dicom/lib/dicom.dic will
be loaded.  The default behaviour should be preferred and the DCMDICTPATH
environment variable only used when alternative data dictionaries are required.
The DCMDICTPATH environment variable has the same format as the shell PATH
variable in that a colon (":") separates entries.  The data dictionary code
will attempt to load each file specified in the DCMDICTPATH environment
variable.  It is an error if no data dictionary can be loaded.