src/common/dccconfig.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-2018 by the Quassel Project                        *
   3  *   devel@quassel-irc.org                                                 *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) version 3.                                           *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.         *
  19  ***************************************************************************/
  20
  21 #pragma once
  22
  23 #include <QHostAddress>
  24
  25 #include "syncableobject.h"
  26
  27 /**
  28  * Class holding the core-side DCC configuration.
  29  *
  30  * @warning Equality and assignment operators are optimized for use in a settings page
  31  *          and do not cover all attributes!
  32  */
  33 class DccConfig : public SyncableObject
  34 {
  35     Q_OBJECT
  36     SYNCABLE_OBJECT
  37
  38     /// Whether DCC is enabled
  39     Q_PROPERTY(bool dccEnabled READ isDccEnabled WRITE setDccEnabled)
  40     /// The IP to use for outgoing traffic
  41     Q_PROPERTY(QHostAddress outgoingIp READ outgoingIp WRITE setOutgoingIp)
  42     /// The IP detection mode
  43     Q_PROPERTY(DccConfig::IpDetectionMode ipDetectionMode READ ipDetectionMode WRITE setIpDetectionMode)
  44     /// The port range selection mode
  45     Q_PROPERTY(DccConfig::PortSelectionMode portSelectionMode READ portSelectionMode WRITE setPortSelectionMode)
  46     /// Minimum port to use for incoming connections
  47     Q_PROPERTY(quint16 minPort READ minPort WRITE setMinPort)
  48     /// Maximum port to use for incoming connections
  49     Q_PROPERTY(quint16 maxPort READ maxPort WRITE setMaxPort)
  50     /// The chunk size to be used
  51     Q_PROPERTY(int chunkSize READ chunkSize WRITE setChunkSize)
  52     /// The timeout for DCC transfers
  53     Q_PROPERTY(int sendTimeout READ sendTimeout WRITE setSendTimeout)
  54     /// Whether passive (reverse) DCC should be used
  55     Q_PROPERTY(bool usePassiveDcc READ usePassiveDcc WRITE setUsePassiveDcc)
  56     /// Whether fast sending should be used
  57     Q_PROPERTY(bool useFastSend READ useFastSend WRITE setUseFastSend)
  58
  59 public:
  60     /**
  61      * Mode for detecting the outgoing IP
  62      */
  63     enum class IpDetectionMode : quint8 {
  64         Automatic,  ///< Automatic detection (network socket or USERHOST)
  65         Manual,     ///< Manually specified IP
  66     };
  67     Q_ENUMS(IpDetectionMode)
  68
  69     /**
  70      * Mode for selecting the port range for DCC
  71      */
  72     enum class PortSelectionMode : quint8 {
  73         Automatic,   ///< Automatic port selection
  74         Manual,      ///< Manually specified port range
  75     };
  76     Q_ENUMS(PortSelectionMode)
  77
  78     /**
  79      * Constructor.
  80      *
  81      * Initializes the object with useful default values.
  82      *
  83      * @param[in] parent QObject parent
  84      */
  85     DccConfig(QObject *parent = nullptr);
  86
  87     /**
  88      * Assignment operator.
  89      *
  90      * @note Only assigns properties relevant for config management!
  91      *
  92      * @param[in] other Right-hand side instance
  93      * @returns The updated instance
  94      */
  95     DccConfig &operator=(const DccConfig &other);
  96
  97     /**
  98      * Equality operator.
  99      *
 100      * @note Only compares properties relevant for config management!
 101      *
 102      * @param[in] other Right-hand side instance
 103      * @returns Whether the two instances have equal properties
 104      */
 105     bool operator==(const DccConfig &other);
 106
 107     /// @name Getters
 108     /// @{
 109     bool isDccEnabled() const;
 110     QHostAddress outgoingIp() const;
 111     IpDetectionMode ipDetectionMode() const;
 112     PortSelectionMode portSelectionMode() const;
 113     quint16 minPort() const;
 114     quint16 maxPort() const;
 115     int chunkSize() const;
 116     int sendTimeout() const;
 117     bool usePassiveDcc() const;
 118     bool useFastSend() const;
 119     /// @}
 120
 121 public slots:
 122     /// @name Setters
 123     /// @{
 124     void setDccEnabled(bool enabled);
 125     void setOutgoingIp(const QHostAddress &outgoingIp);
 126     void setIpDetectionMode(DccConfig::IpDetectionMode ipDetectionMode);
 127     void setPortSelectionMode(DccConfig::PortSelectionMode portSelectionMode);
 128     void setMinPort(quint16 port);
 129     void setMaxPort(quint16 port);
 130     void setChunkSize(int chunkSize);
 131     void setSendTimeout(int timeout);
 132     void setUsePassiveDcc(bool use);
 133     void setUseFastSend(bool use);
 134     /// @}
 135
 136 private:
 137     // The given values are used as default for both initialization and settings
 138     bool _dccEnabled                     {false};
 139     QHostAddress _outgoingIp             {QHostAddress::LocalHost};
 140     IpDetectionMode _ipDetectionMode     {IpDetectionMode::Automatic};
 141     PortSelectionMode _portSelectionMode {PortSelectionMode::Automatic};
 142     quint16 _minPort                     {1024};
 143     quint16 _maxPort                     {32767};
 144     int _chunkSize                       {16};
 145     int _sendTimeout                     {180};
 146     bool _usePassiveDcc                  {false};
 147     bool _useFastSend                    {false};
 148 };