Base class for implementing DICOM TLS-enabled Service Class User functionality.
More...
|
| DcmTLSSCU () |
| Constructor, just initializes internal class members.
|
|
| DcmTLSSCU (const OFString &peerHost, const OFString &peerAETitle, const Uint16 &portNum) |
| Initialize SCU with connection peer information.
|
|
virtual | ~DcmTLSSCU () |
| Virtual destructor.
|
|
virtual OFCondition | initNetwork () |
| Initialize network, i.e.
|
|
virtual OFCondition | negotiateAssociation () |
| Negotiate association by using presentation contexts and parameters as defined by earlier function calls.
|
|
virtual void | closeAssociation (const DcmCloseAssociationType closeType) |
| Closes the association of this SCU.
|
|
virtual void | addTrustedCertFile (const OFString &str) |
| TODO: Not documented yet.
|
|
virtual void | addTrustedCertDir (const OFString &certDir) |
| TODO: Not documented yet.
|
|
virtual void | enableAuthentication (const OFString &privateKey, const OFString &certFile, const char *passphrase=NULL, const int &privKeyFormat=SSL_FILETYPE_PEM, const int &certFormat=SSL_FILETYPE_PEM) |
| TODO: Not documented yet.
|
|
virtual void | disableAuthentication () |
| Disables authentication.
|
|
virtual void | addCiphersuite (const OFString &cs) |
| TODO: Not documented yet.
|
|
virtual void | setReadSeedFile (const OFString &seedFile) |
| TODO: Not documented yet.
|
|
virtual void | setWriteSeedFile (const OFString &seedFile) |
| TODO: Not documented yet.
|
|
virtual void | setPeerCertVerification (const DcmCertificateVerification &cert) |
| Set whether peer's certificate must be there, only is checked if there or is ignored.
|
|
virtual void | setDHParam (const OFString &dhParam) |
| Not documented yet.
|
|
virtual OFBool | getAuthenticationParams (OFString &privKeyFile, OFString &certFile, const char *&passphrase, int &privKeyFormat, int &certFormat) const |
| Returns OFTrue if authentication is enabled.
|
|
virtual void | getTrustedCertFiles (OFList< OFString > &files) const |
| TODO: Not documented yet.
|
|
virtual void | getTrustedCertDirs (OFList< OFString > &trustedDirs) const |
| TODO: Not documented yet.
|
|
virtual OFString | getCiphersuites () const |
| TODO: Not documented yet.
|
|
virtual OFString | getReadSeedFile () const |
| TODO: Not documented yet.
|
|
virtual OFString | getWriteSeedFile () const |
| TODO: Not documented yet.
|
|
virtual OFString | getDHParam () const |
| TODO: Not documented yet.
|
|
| DcmSCU () |
| Constructor, just initializes internal class members.
|
|
virtual | ~DcmSCU () |
| Virtual destructor.
|
|
OFCondition | addPresentationContext (const OFString &abstractSyntax, const OFList< OFString > &xferSyntaxes) |
| Add presentation context to be used for association negotiation.
|
|
T_ASC_PresentationContextID | findPresentationContextID (const OFString &abstractSyntax, const OFString &transferSyntax) |
| After negotiation association, this call returns the first usable presentation context given the desired abstract syntax and transfer syntax.
|
|
virtual OFCondition | sendECHORequest (const T_ASC_PresentationContextID presID) |
| This function sends a C-ECHO command via network to another DICOM application.
|
|
virtual OFCondition | sendSTORERequest (const T_ASC_PresentationContextID presID, const OFString &dicomFile, DcmDataset *dset, DcmDataset *&rspCommandSet, DcmDataset *&rspStatusDetail, Uint16 &rspStatusCode) |
| This function sends a C-STORE request on the currently opened association and receives the corresponding response then.
|
|
virtual OFCondition | sendFINDRequest (T_ASC_PresentationContextID presID, DcmDataset *queryKeys, FINDResponses *responses) |
| Sends a C-FIND Request on given presentation context and receives list of responses.
|
|
virtual OFCondition | handleFINDResponse (Uint16 presContextID, FINDResponse *response, OFBool &waitForNextResponse) |
| This is the standard handler for C-FIND message responses: It just adds up all responses it receives and prints a DEBUG message.
|
|
virtual OFCondition | sendCANCELRequest (Uint16 presContextID) |
| Send C-FIND-CANCEL and, therefore, ends the C-FIND session, i.e. no further responses will be handled.
|
|
virtual OFCondition | sendACTIONRequest (const T_ASC_PresentationContextID presID, const OFString &sopInstanceUID, const Uint16 actionTypeID, DcmDataset *reqDataset, Uint16 &rspStatusCode) |
| This function sends a N-ACTION request on the currently opened association and receives the corresponding response then.
|
|
virtual OFCondition | handleEVENTREPORTRequest (DcmDataset *&reqDataset, Uint16 &eventTypeID, const int timeout=0) |
| Receives N-EVENT-REPORT request on the currently opened association and sends a corresponding response.
|
|
void | setMaxReceivePDULength (const unsigned long maxRecPDU) |
| Set maximum PDU length (to be received by SCU)
|
|
void | setDIMSEBlockingMode (const T_DIMSE_BlockingMode blockingMode) |
| Set whether to send in DIMSE blocking or non-blocking mode.
|
|
void | setAETitle (const OFString &myAETtitle) |
| Set SCU's AETitle to be used in association negotiation.
|
|
void | setPeerHostName (const OFString &peerHostName) |
| Set SCP's host (hostname or IP address) to talk to in association negotiation.
|
|
void | setPeerAETitle (const OFString &peerAETitle) |
| Set SCP's AETitle to talk to in association negotiation.
|
|
void | setPeerPort (const Uint16 peerPort) |
| Set SCP's port number to connect to for association negotiation.
|
|
void | setDIMSETimeout (const Uint32 dimseTimeout) |
| Set timeout for receiving DIMSE messages.
|
|
void | setACSETimeout (const Uint32 acseTimeout) |
| Set timeout for receiving ACSE messages.
|
|
void | setAssocConfigFileAndProfile (const OFString &filename, const OFString &profile) |
| Set an association configuration file and profile to be used.
|
|
void | setVerbosePCMode (const OFBool mode) |
| Set whether to show presentation contexts in verbose or debug mode.
|
|
OFBool | isConnected () const |
| Get current connection status.
|
|
Uint32 | getMaxReceivePDULength () const |
| Returns maximum PDU length configured to be received by SCU.
|
|
T_DIMSE_BlockingMode | getDIMSEBlockingMode () const |
| Returns whether DIMSE messaging is configured to be blocking or unblocking.
|
|
const OFString & | getAETitle () const |
| Returns the SCU's own configured AETitle.
|
|
const OFString & | getPeerHostName () const |
| Returns the SCP's (peer's) host name configured.
|
|
const OFString & | getPeerAETitle () const |
| Returns the SCP's (peer's) AETitle configured.
|
|
Uint16 | getPeerPort () const |
| Returns the SCP's (peer's) TCP/IP port configured.
|
|
Uint32 | getDIMSETimeout () const |
| Returns the DIMSE timeout configured defining how long SCU will wait for DIMSE responses.
|
|
Uint32 | getACSETimeout () const |
| Returns the timeout configured defining how long SCU will wait for messages during ACSE messaging (association negotiation)
|
|
OFBool | getVerbosePCMode () const |
| Returns the verbose presentation context mode configured specifying whether details on the presentation contexts (negotiated during association setup) should be shown in verbose or debug mode.
|
|
OFBool | getTLSEnabled () const |
| Returns whether SCU is configured to create a TLS connection with the SCP.
|
|
|
OFCondition | sendDIMSEMessage (const T_ASC_PresentationContextID presID, T_DIMSE_Message *msg, DcmDataset *dataObject, DIMSE_ProgressCallback callback, void *callbackContext, DcmDataset **commandSet=NULL) |
| Sends a DIMSE command and possibly also a dataset from a data object via network to another DICOM application.
|
|
OFCondition | getDatasetInfo (DcmDataset *dataset, OFString &sopClassUID, OFString &sopInstanceUID, E_TransferSyntax &transferSyntax) |
| Returns SOP Class UID, SOP Instance UID and original transfer syntax for a given dataset.
|
|
OFCondition | useSecureConnection (DcmTransportLayer *tlayer) |
| Tells DcmSCU to use a secure TLS connection described by the given TLS layer.
|
|
OFCondition | receiveDIMSECommand (T_ASC_PresentationContextID *presID, T_DIMSE_Message *msg, DcmDataset **statusDetail, DcmDataset **commandSet=NULL, const Uint32 timeout=0) |
| Receive DIMSE command (excluding dataset!) over the currently open association.
|
|
OFCondition | receiveDIMSEDataset (T_ASC_PresentationContextID *presID, DcmDataset **dataObject, DIMSE_ProgressCallback callback, void *callbackContext) |
| Receives one dataset (of instance data) via network from another DICOM application.
|
|
void | findPresentationContext (const T_ASC_PresentationContextID presID, OFString &abstractSyntax, OFString &transferSyntax) |
| After negotiation association, this call returns the presentation context belonging to the given presentation context ID.
|
|
virtual Uint16 | checkEVENTREPORTRequest (T_DIMSE_N_EventReportRQ &request, DcmDataset *reqDataset) |
| Check given N-EVENT-REPORT request and dataset for validity.
|
|
Base class for implementing DICOM TLS-enabled Service Class User functionality.
This class is derived from the general DcmSCU class and just adds the corresponding TLS capabilities.
- Warning
- This class is EXPERIMENTAL. Be careful to use it in production environment.
Definition at line 45 of file tlsscu.h.