/usr/include/dcmtk/dcmnet/dcmlayer.h is in libdcmtk-dev 3.6.2-3build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | /*
*
* Copyright (C) 1998-2017, OFFIS e.V.
* All rights reserved. See COPYRIGHT file for details.
*
* This software and supporting documentation were developed by
*
* OFFIS e.V.
* R&D Division Health
* Escherweg 2
* D-26121 Oldenburg, Germany
*
*
* Module: dcmnet
*
* Author: Marco Eichelberg
*
* Purpose:
* classes: DcmTransportLayer
*
*/
#ifndef DCMLAYER_H
#define DCMLAYER_H
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/ofstd/oftypes.h"
#include "dcmtk/ofstd/ofstring.h"
#define INCLUDE_UNISTD
#include "dcmtk/ofstd/ofstdinc.h"
#include "dcmtk/dcmnet/dndefine.h"
#include "dcmtk/dcmnet/dntypes.h"
/** this enum represents the result of a transport layer operation
* which may be a transparent TCP/IP or a secure TLS operation.
*/
enum DcmTransportLayerStatus
{
/** successful operation
*/
TCS_ok,
/** operation cannot be performed because transport connection
* object was not allocated.
*/
TCS_noConnection,
/** operation failed due to an error within the TLS protocol layer
*/
TCS_tlsError,
/** operation failed because an illegal parameter was passed
*/
TCS_illegalCall,
/** unspecified error
*/
TCS_unspecifiedError
};
class DcmTransportConnection;
/** factory class which creates transport layer connections.
* Base class only supports transparent TCP connections, subclasses
* may also support secure transport layer connections.
*/
class DCMTK_DCMNET_EXPORT DcmTransportLayer
{
public:
/** constructor.
* #param networkRole network role to be used by the application, influences
* the choice of the secure transport layer code.
*/
DcmTransportLayer(int /* networkRole */ ) { /* empty */ }
/// destructor
virtual ~DcmTransportLayer();
/** factory method that returns a new transport connection for the
* given socket. Depending on the second parameter, either a transparent
* or a secure connection is established. If the object cannot be created
* (e. g. because no secure layer is available), returns NULL.
* @param openSocket TCP/IP socket to be used for the transport connection.
* the connection must already be establised on socket level. If a non-null
* pointer is returned, the new connection object takes over control of the socket.
* @param useSecureLayer if true, a secure layer is used. If false, a
* transparent layer is used.
* @return pointer to new connection object if successful, NULL otherwise.
*/
virtual DcmTransportConnection *createConnection(DcmNativeSocketType openSocket, OFBool useSecureLayer);
private:
/// private undefined copy constructor
DcmTransportLayer(const DcmTransportLayer&);
/// private undefined assignment operator
DcmTransportLayer& operator=(const DcmTransportLayer&);
};
#endif
|