/usr/include/dcmtk/dcmsign/sialgo.h is in libdcmtk-dev 3.6.1~20160216-4.
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 | /*
*
* Copyright (C) 1998-2011, 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: dcmsign
*
* Author: Norbert Loxen, Marco Eichelberg
*
* Purpose:
* classes: SiAlgorithm
*
*/
#ifndef SIALGO_H
#define SIALGO_H
#include "dcmtk/config/osconfig.h"
#include "dcmtk/dcmsign/sitypes.h"
#ifdef WITH_OPENSSL
#include "dcmtk/ofstd/oftypes.h"
/**
* pure virtual base class of the public key crypto systems used for
* signature creation and verification.
* All public key algorithm classes should inherit from this class.
* Instances of derived classes contain a single private or public key.
*/
class DCMTK_DCMSIGN_EXPORT SiAlgorithm
{
public:
/// default constructor
SiAlgorithm() { }
/// destructor
virtual ~SiAlgorithm() { }
/** creates a signature.
* @param inputHash array of hash key bytes that are to be signed
* @param inputHashSize length of hash key array in bytes
* @param inputHashAlgorithm MAC algorithm used for creation of hash key.
* Required for creation of PKCS#1 RSA signature padding.
* @param outputSignature pointer to array of at least getSize() which must be allocated by caller.
* @param outputSignatureSize returns the number of bytes written to outputSignature.
* @return SI_EC_Normal if successful, errorcode otherwise.
*/
virtual OFCondition sign(
const unsigned char *inputHash,
unsigned long inputHashSize,
E_MACType inputHashAlgorithm,
unsigned char *outputSignature,
unsigned long &outputSignatureSize) = 0;
/** verifies a signature.
* @param inputHash array of bytes containing hash key to be verified against signature
* @param inputHashSize length of hash key array in bytes
* @param inputHashAlgorithm MAC algorithm used for creation of hash key.
* Required for creation of PKCS#1 RSA signature padding.
* @param inputSignature array of bytes containing signature to be verified
* @param inputSignatureSize length of signature array in bytes
* @param verified returns whether the signature was successfully verified
* @return SI_EC_Normal if successful, errorcode otherwise.
*/
virtual OFCondition verify(
const unsigned char *inputHash,
unsigned long inputHashSize,
E_MACType inputHashAlgorithm,
const unsigned char *inputSignature,
unsigned long inputSignatureSize,
OFBool &verified) = 0;
/** returns the size of a block of encrypted/decrypted ciphertext in bytes.
* The result depends on the public key algorithm, key size and padding scheme.
* In general the input to decrypt() or encrypt() must be less than or equal
* to this block size. The output of decrypt() or encrypt() is always equal
* to this block size.
* @return block size for this public key cryptosystem and key
*/
virtual unsigned long getSize() const = 0;
/** returns the type of public key algorithm computed by this object
* @return type of public key algorithm
*/
virtual E_KeyType keyType() const = 0;
};
#endif
#endif
|