LXR qemu/include/crypto/tlscreds.h

   1/*
   2 * QEMU crypto TLS credential support
   3 *
   4 * Copyright (c) 2015 Red Hat, Inc.
   5 *
   6 * This library is free software; you can redistribute it and/or
   7 * modify it under the terms of the GNU Lesser General Public
   8 * License as published by the Free Software Foundation; either
   9 * version 2.1 of the License, or (at your option) any later version.
  10 *
  11 * This library is distributed in the hope that it will be useful,
  12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 * Lesser General Public License for more details.
  15 *
  16 * You should have received a copy of the GNU Lesser General Public
  17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
  18 *
  19 */
  20
  21#ifndef QCRYPTO_TLSCREDS_H
  22#define QCRYPTO_TLSCREDS_H
  23
  24#include "qapi/qapi-types-crypto.h"
  25#include "qom/object.h"
  26
  27#define TYPE_QCRYPTO_TLS_CREDS "tls-creds"
  28typedef struct QCryptoTLSCreds QCryptoTLSCreds;
  29typedef struct QCryptoTLSCredsClass QCryptoTLSCredsClass;
  30DECLARE_OBJ_CHECKERS(QCryptoTLSCreds, QCryptoTLSCredsClass, QCRYPTO_TLS_CREDS,
  31                     TYPE_QCRYPTO_TLS_CREDS)
  32
  33
  34#define QCRYPTO_TLS_CREDS_DH_PARAMS "dh-params.pem"
  35
  36
  37typedef bool (*CryptoTLSCredsReload)(QCryptoTLSCreds *, Error **);
  38/**
  39 * QCryptoTLSCreds:
  40 *
  41 * The QCryptoTLSCreds object is an abstract base for different
  42 * types of TLS handshake credentials. Most commonly the
  43 * QCryptoTLSCredsX509 subclass will be used to provide x509
  44 * certificate credentials.
  45 */
  46
  47struct QCryptoTLSCredsClass {
  48    ObjectClass parent_class;
  49    CryptoTLSCredsReload reload;
  50};
  51
  52/**
  53 * qcrypto_tls_creds_check_endpoint:
  54 * @creds: pointer to a TLS credentials object
  55 * @endpoint: type of network endpoint that will be using the credentials
  56 * @errp: pointer to a NULL-initialized error object
  57 *
  58 * Check whether the credentials is setup according to
  59 * the type of @endpoint argument.
  60 *
  61 * Returns true if the credentials is setup for the endpoint, false otherwise
  62 */
  63bool qcrypto_tls_creds_check_endpoint(QCryptoTLSCreds *creds,
  64                                      QCryptoTLSCredsEndpoint endpoint,
  65                                      Error **errp);
  66
  67#endif /* QCRYPTO_TLSCREDS_H */
  68