1 /***************************************************************************
2 * Copyright (C) 2005-2020 by the Quassel Project *
3 * devel@quassel-irc.org *
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. *
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. *
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 ***************************************************************************/
23 #include "common-export.h"
25 #include <QHostAddress>
27 #include "syncableobject.h"
30 * Class holding the core-side DCC configuration.
32 * @warning Equality and assignment operators are optimized for use in a settings page
33 * and do not cover all attributes!
35 class COMMON_EXPORT DccConfig : public SyncableObject
40 /// Whether DCC is enabled
41 Q_PROPERTY(bool dccEnabled READ isDccEnabled WRITE setDccEnabled)
42 /// The IP to use for outgoing traffic
43 Q_PROPERTY(QHostAddress outgoingIp READ outgoingIp WRITE setOutgoingIp)
44 /// The IP detection mode
45 Q_PROPERTY(DccConfig::IpDetectionMode ipDetectionMode READ ipDetectionMode WRITE setIpDetectionMode)
46 /// The port range selection mode
47 Q_PROPERTY(DccConfig::PortSelectionMode portSelectionMode READ portSelectionMode WRITE setPortSelectionMode)
48 /// Minimum port to use for incoming connections
49 Q_PROPERTY(quint16 minPort READ minPort WRITE setMinPort)
50 /// Maximum port to use for incoming connections
51 Q_PROPERTY(quint16 maxPort READ maxPort WRITE setMaxPort)
52 /// The chunk size to be used
53 Q_PROPERTY(int chunkSize READ chunkSize WRITE setChunkSize)
54 /// The timeout for DCC transfers
55 Q_PROPERTY(int sendTimeout READ sendTimeout WRITE setSendTimeout)
56 /// Whether passive (reverse) DCC should be used
57 Q_PROPERTY(bool usePassiveDcc READ usePassiveDcc WRITE setUsePassiveDcc)
58 /// Whether fast sending should be used
59 Q_PROPERTY(bool useFastSend READ useFastSend WRITE setUseFastSend)
63 * Mode for detecting the outgoing IP
65 enum class IpDetectionMode : quint8
67 Automatic, ///< Automatic detection (network socket or USERHOST)
68 Manual, ///< Manually specified IP
70 Q_ENUMS(IpDetectionMode)
73 * Mode for selecting the port range for DCC
75 enum class PortSelectionMode : quint8
77 Automatic, ///< Automatic port selection
78 Manual, ///< Manually specified port range
80 Q_ENUMS(PortSelectionMode)
85 * Initializes the object with useful default values.
87 * @param[in] parent QObject parent
89 DccConfig(QObject* parent = nullptr);
94 * @note Only compares properties relevant for config management!
96 * @param[in] other Right-hand side instance
97 * @returns Whether the two instances have equal properties
99 bool operator==(const DccConfig& other);
103 bool isDccEnabled() const;
104 QHostAddress outgoingIp() const;
105 IpDetectionMode ipDetectionMode() const;
106 PortSelectionMode portSelectionMode() const;
107 quint16 minPort() const;
108 quint16 maxPort() const;
109 int chunkSize() const;
110 int sendTimeout() const;
111 bool usePassiveDcc() const;
112 bool useFastSend() const;
118 void setDccEnabled(bool enabled);
119 void setOutgoingIp(const QHostAddress& outgoingIp);
120 void setIpDetectionMode(DccConfig::IpDetectionMode ipDetectionMode);
121 void setPortSelectionMode(DccConfig::PortSelectionMode portSelectionMode);
122 void setMinPort(quint16 port);
123 void setMaxPort(quint16 port);
124 void setChunkSize(int chunkSize);
125 void setSendTimeout(int timeout);
126 void setUsePassiveDcc(bool use);
127 void setUseFastSend(bool use);
131 // The given values are used as default for both initialization and settings
132 bool _dccEnabled{false};
133 QHostAddress _outgoingIp{QHostAddress::LocalHost};
134 IpDetectionMode _ipDetectionMode{IpDetectionMode::Automatic};
135 PortSelectionMode _portSelectionMode{PortSelectionMode::Automatic};
136 quint16 _minPort{1024};
137 quint16 _maxPort{32767};
139 int _sendTimeout{180};
140 bool _usePassiveDcc{false};
141 bool _useFastSend{false};