KIMAP::GetQuotaRootJob
#include <getquotarootjob.h>
Public Member Functions | |
GetQuotaRootJob (Session *session) | |
QMap< QByteArray, qint64 > | allLimits (const QByteArray &root) const |
QMap< QByteArray, qint64 > | allUsages (const QByteArray &root) const |
qint64 | limit (const QByteArray &root, const QByteArray &resource) const |
QString | mailBox () const |
QList< QByteArray > | roots () const |
void | setMailBox (const QString &mailBox) |
qint64 | usage (const QByteArray &root, const QByteArray &resource) const |
Public Member Functions inherited from KIMAP::QuotaJobBase | |
QuotaJobBase (Session *session) | |
qint64 | limit (const QByteArray &resource) |
qint64 | usage (const QByteArray &resource) |
Protected Member Functions | |
void | doStart () override |
void | handleResponse (const Response &response) override |
Protected Member Functions inherited from KIMAP::QuotaJobBase | |
QuotaJobBase (JobPrivate &dd) | |
Detailed Description
Gets the quota root and resource limits for a mailbox.
Quotas are defined with respect to "resources" and "quota roots". A resource is a numerical property that can be limited, such as the octet size of all the messages in a mailbox, or the number of messages in a mailbox. Each mailbox has one or more quota roots, which are where the resource limits are defined. A quota root may or may not be a mailbox name, and an empty string is a valid quota root. All mailboxes with the same quota root share the resource limits of the quota root.
This job can only be run when the session is in the authenticated (or selected) state.
This job requires that the server supports the QUOTA capability, defined in RFC 2087.
Definition at line 36 of file getquotarootjob.h.
Constructor & Destructor Documentation
◆ GetQuotaRootJob()
|
explicit |
Definition at line 37 of file getquotarootjob.cpp.
◆ ~GetQuotaRootJob()
|
override |
Definition at line 42 of file getquotarootjob.cpp.
Member Function Documentation
◆ allLimits()
|
nodiscard |
Get a map containing all resource limits for a quota root.
- Parameters
-
root the quota root to get resource limits for
- Returns
- a map from resource names to limits
Definition at line 149 of file getquotarootjob.cpp.
◆ allUsages()
|
nodiscard |
Get a map containing all resource usage figures for a quota root.
- Parameters
-
root the quota root to get resource usage figures for
- Returns
- a map from resource names to usage figures
Definition at line 132 of file getquotarootjob.cpp.
◆ doStart()
|
overrideprotected |
Definition at line 46 of file getquotarootjob.cpp.
◆ handleResponse()
|
overrideprotected |
Definition at line 52 of file getquotarootjob.cpp.
◆ limit()
|
nodiscard |
Get the current limit for a resource.
- Parameters
-
root the quota root to get the resource limit for resource the resource to get the limit for
- Returns
- the resource limit in appropriate units, or -1 if the limit is unknown or there is no limit on the resource
Definition at line 120 of file getquotarootjob.cpp.
◆ mailBox()
|
nodiscard |
The mailbox that the quota roots will be fetched for.
Definition at line 97 of file getquotarootjob.cpp.
◆ roots()
|
nodiscard |
The quota roots for the mailbox.
Definition at line 103 of file getquotarootjob.cpp.
◆ setMailBox()
void GetQuotaRootJob::setMailBox | ( | const QString & | mailBox | ) |
Set the mailbox to get the quota roots for.
- Parameters
-
mailBox the name of an existing mailbox
Definition at line 91 of file getquotarootjob.cpp.
◆ usage()
|
nodiscard |
Get the current usage for a resource.
Note that if there is no limit for a resource, the server will not provide information about resource usage.
- Parameters
-
root the quota root to get the resource usage for resource the resource to get the usage for
- Returns
- the resource usage in appropriate units, or -1 if the usage is unknown or there is no limit on the resource
Definition at line 109 of file getquotarootjob.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Sat Dec 21 2024 17:01:17 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.