/usr/include/kldap/ldapconnection.h is in kdepimlibs5-dev 4:4.13.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /*
This file is part of libkldap.
Copyright (c) 2004-2006 Szombathelyi György <gyurco@freemail.hu>
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 KLDAP_LDAPCONNECTION_H
#define KLDAP_LDAPCONNECTION_H
#include <QtCore/QString>
#include "ldapurl.h"
#include "ldapserver.h"
#include "kldap_export.h"
namespace KLDAP {
/**
* @brief
* This class represents a connection to an LDAP server.
*/
class KLDAP_EXPORT LdapConnection
{
public:
enum SASL_Fields {
SASL_Authname = 0x1,
SASL_Authzid = 0x2,
SASL_Realm = 0x4,
SASL_Password = 0x8
};
/** Constructs an LdapConnection object */
LdapConnection();
/** Constructs an LdapConnection with the parameters given in url */
explicit LdapConnection( const LdapUrl &url );
/** Constructs an LdapConnection with the parameters given in server */
explicit LdapConnection( const LdapServer &server );
virtual ~LdapConnection();
/**
* Sets the connection parameters via the specified url. After this,
* you need to call connect() to connect with the new parameters.
* @param url the URL containing the connection parameters
*/
void setUrl( const LdapUrl &url );
/**
* Returns the connection parameters which was specified with an LDAP Url
* or a LdapServer structure.
*/
const LdapServer &server() const;
/**
* Sets the connection parameters via the specified server structure. After
* this, you need to call connect() to connect with the new parameters.
* @param server the server object containing the connection parameters
*/
void setServer( const LdapServer &server );
/**
* Sets up the connection parameters with creating a handle to the LDAP server.
* Also sets sizelimit and timelimit and starts TLS if it is requested.
* Returns 0 if successful, else returns an LDAP error code, and an error
* string which is available via connectionError().
*/
int connect();
/**
* Returns a translated error string if connect() failed.
*/
QString connectionError() const;
/**
* Closes the LDAP connection.
*/
void close();
/** Sets the size limit for the connection.
* @param sizelimit the connection size limit to set
*/
bool setSizeLimit( int sizelimit );
/** Returns the current size limit. */
int sizeLimit() const;
/** Sets the time limit for the connection.
* @param timelimit the connection time limit to set
*/
bool setTimeLimit( int timelimit );
/** Returns the current time limit. */
int timeLimit() const;
/** Gets an option from the connection. The option value can be client
* library specific, so avoid this function if possible
* @param option the connection option to return
* @param value the value of option to get
*/
int getOption( int option, void *value ) const;
/** Sets an option in the connection. The option value can be client
* library specific, so avoid this function if possible */
int setOption( int option, void *value );
/** Returns the LDAP error code from the last operation */
int ldapErrorCode() const;
/** Returns the LDAP error string from the last operation */
QString ldapErrorString() const;
/** Returns a translated error message from the specified LDAP error code */
static QString errorString( int code );
/** Returns the SASL error string from the last SASL operation */
QString saslErrorString() const;
/**
* Returns the opaqe client-library specific LDAP object.
* Avoid its usage if you can.
*/
void *handle() const;
/**
* Returns the opaqe sasl-library specific SASL object.
* Avoid its usage if you can.
*/
void *saslHandle() const;
private:
class LdapConnectionPrivate;
LdapConnectionPrivate *const d;
Q_DISABLE_COPY( LdapConnection )
};
}
#endif
|