KIMAP2::Acl

KIMAP2::Acl Namespace Reference

Typedefs

typedef QFlags< RightRights
 

Enumerations

enum  Right {
  None = 0x000000 , Lookup = 0x000001 , Read = 0x000002 , KeepSeen = 0x000004 ,
  Write = 0x000008 , Insert = 0x000010 , Post = 0x000020 , Create = 0x000040 ,
  CreateMailbox = 0x000080 , DeleteMailbox = 0x000100 , DeleteMessage = 0x000200 , Delete = 0x000400 ,
  Admin = 0x000800 , Expunge = 0x001000 , WriteShared = 0x002000 , Custom0 = 0x004000 ,
  Custom1 = 0x008000 , Custom2 = 0x010000 , Custom3 = 0x020000 , Custom4 = 0x040000 ,
  Custom5 = 0x080000 , Custom6 = 0x100000 , Custom7 = 0x200000 , Custom8 = 0x400000 ,
  Custom9 = 0x800000
}
 

Functions

KIMAP2_EXPORT Rights denormalizedRights (Rights rights)
 
KIMAP2_EXPORT Rights normalizedRights (Rights rights)
 
KIMAP2_EXPORT Rights rightsFromString (const QByteArray &string)
 
KIMAP2_EXPORT QByteArray rightsToString (Rights rights)
 

Detailed Description

Operations for dealing with mailbox permissions.

Typedef Documentation

◆ Rights

Definition at line 96 of file acl.h.

Enumeration Type Documentation

◆ Right

Possible rights that can be held on a mailbox.

Enumerator
Lookup 

Mailbox is visible to LIST/LSUB commands, SUBSCRIBE mailbox.

Read 

SELECT the mailbox, perform STATUS.

KeepSeen 

Set or clear the \Seen flag on messages in the mailbox, and keep it across sessions.

Write 

Set or clear flags other than \Seen and \Deleted on messages in the mailbox.

Insert 

Perform APPEND and COPY with the mailbox as the target.

Post 

Send mail to the submission address for the mailbox.

Note: this is not enforced by IMAP4, but is purely advisory.

Create 

Obsolete as of RFC 4314, replaced by CreateMailbox and DeleteMailbox.

CreateMailbox 

Create new child mailboxes, or move a mailbox with this mailbox as the new parent.

Note that what constitutes a "child" mailbox is implementation-defined, but . or / are usually used as separaters.

DeleteMailbox 

Delete or move the mailbox.

DeleteMessage 

Set or clear the \Deleted flag on messages in the mailbox.

Delete 

Obsolete as of RFC 4314, replaced by DeleteMessage and Expunge.

Admin 

View and modify the access control list for the mailbox.

Expunge 

Expunge the messages in this mailbox.

Note that if this right is not held on a mailbox, closing the mailbox (see CloseJob) will succeed, but will not expunge the messages.

WriteShared 

Write shared annotations.

See RFC 5257. Only supported by servers that implement the ANNOTATE extension.

Custom0 

Server-specific right 0.

Custom1 

Server-specific right 1.

Custom2 

Server-specific right 2.

Custom3 

Server-specific right 3.

Custom4 

Server-specific right 4.

Custom5 

Server-specific right 5.

Custom6 

Server-specific right 6.

Custom7 

Server-specific right 7.

Custom8 

Server-specific right 8.

Custom9 

Server-specific right 9.

Definition at line 39 of file acl.h.

Function Documentation

◆ denormalizedRights()

KIMAP2::Acl::Rights KIMAP2::Acl::denormalizedRights ( Rights rights)

Returns a rights mask that contains both obsolete and new flags if one of them is set.

Parameters
rightsset of Rights flags to augment
Since
4.6

Definition at line 118 of file acl.cpp.

◆ normalizedRights()

KIMAP2::Acl::Rights KIMAP2::Acl::normalizedRights ( Rights rights)

Returns a rights mask that has no obsolete members anymore, i.e.

obsolete flags are removed and replaced by their successors.

Parameters
rightsset of Rights flags to normalize
Since
4.6

Definition at line 104 of file acl.cpp.

◆ rightsFromString()

KIMAP2::Acl::Rights KIMAP2::Acl::rightsFromString ( const QByteArray & string)

Convert the text form of a set of rights into a Rights bitflag.

Modifier flags ('+' and '-') are ignored, as are any unknown characters. This method will not complain if you give it something that is not a list of rights.

Definition at line 69 of file acl.cpp.

◆ rightsToString()

QByteArray KIMAP2::Acl::rightsToString ( Rights rights)

Convert a set of rights into text format.

No modifier flag ('+' or '-') will be included.

Definition at line 91 of file acl.cpp.

This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Oct 11 2024 12:20:23 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.