File indexing completed on 2023-09-24 05:08:00

 /* This file is part of the KDE project
  *
  * Copyright (C) 2000-2003 George Staikos <staikos@kde.org>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public License
  * along with this library; see the file COPYING.LIB.  If not, write to
  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
 
 #ifndef _KSSLSETTINGS_H
 #define _KSSLSETTINGS_H
 
 #include <kio/kio_export.h>
 
 #include <QtCore/QString>
 
 #include <kconfig.h>
 
 class KSSLSettingsPrivate;
 
 /**
  * KDE SSL Settings
  *
  * This class contains some of the SSL settings for easy use.
  *
  * @author George Staikos <staikos@kde.org>
  * @see KSSL
  * @short KDE SSL Settings
  */
 class KIO_EXPORT KSSLSettings {
 public:
     /**
      *  Construct a KSSL Settings object
      *
      *  @param readConfig read in the configuration immediately if true
      */
     KSSLSettings(bool readConfig = true);
 
     /**
      *  Destroy this KSSL Settings object
      */
     ~KSSLSettings();
 
     /**
      *  Does the user want to be warned on entering SSL mode
      *  @return true if the user wants to be warned
      */
     bool warnOnEnter() const;
 
     /**
      *  Change the user's warnOnEnter() setting
      *  @param x true if the user is to be warned
      *  @see warnOnEnter
      */
     void setWarnOnEnter(bool x);
     
     /**
      *  Does the user want to be warned on sending unencrypted data
      *  @return true if the user wants to be warned
      *  @see setWarnOnUnencrypted
      */
     bool warnOnUnencrypted() const;
 
     /**
      *  Change the user's warnOnUnencrypted() setting
      *  @param x true if the user is to be warned
      *  @see warnOnUnencrypted
      */
     void setWarnOnUnencrypted(bool x);
 
     /**
      *  Does the user want to be warned on leaving SSL mode
      *  @return true if the user wants to be warned
      */
     bool warnOnLeave() const;
 
     /**
      *  Change the user's warnOnLeave() setting
      *  @param x true if the user is to be warned
      *  @see warnOnLeave
      */
     void setWarnOnLeave(bool x);
     
     /**
      *  Does the user want to be warned during mixed SSL/non-SSL mode
      *  @return true if the user wants to be warned
      */
     bool warnOnMixed() const;
 
     /**
      *  Does the user want to use the Entropy Gathering Daemon?
      *  @return true if the user wants to use EGD
      */
     bool useEGD() const;
 
     /**
      *  Does the user want to use an entropy file?
      *  @return true if the user wants to use an entropy file
      */
     bool useEFile() const;
   
     /**
      *  Does the user want X.509 client certificates to always be sent when
      *  possible?
      *  @return true if the user always wants a certificate sent
      */
     bool autoSendX509() const;
 
     /**
      *  Does the user want to be prompted to send X.509 client certificates
      *  when possible?
      *  @return true if the user wants to be prompted
      */
     bool promptSendX509() const;
 
     /**
      *  Get the OpenSSL cipher list for selecting the list of ciphers to
      *  use in a connection.
      *  @return the cipher list
      */
     QString getCipherList();
 
     /**
      *  Get the configured path to the entropy gathering daemon or entropy
      *  file.
      *  @return the path
      */
     QString& getEGDPath();
 
     /**
      *  Load the user's settings.
      */
     void load();
 
     /**
      *  Revert to default settings.
      */
     void defaults();
 
     /**
      *  Save the current settings.
      */
     void save();
 
 private:
     KConfig *m_cfg;
     bool m_bWarnOnEnter, m_bWarnOnUnencrypted, m_bWarnOnLeave, m_bWarnOnMixed;
     bool m_bWarnSelfSigned, m_bWarnRevoked, m_bWarnExpired;
 
     QList<QString> v3ciphers, v3selectedciphers;
     QList<int> v3bits;
 
     KSSLSettingsPrivate* const d;
 };
 
 
 #endif