";

		if (! $this->connect())
			return false;

		$search = @ldap_read( $this->connect(), $dn, 'objectClass=*', array( 'subschemaSubentry' ) );
		if( $debug ) { printf("%s::getSchemaDN(): ldap_read: ",get_class($this)); var_dump( $search ); echo "\n"; }
		if( ! $search ) {
			if( $debug ) printf("%s::getSchemaDN(): returning null. (search result is blank)
",get_class($this));
			return null;
		}

		if( @ldap_count_entries( $this->connect(), $search ) == 0 ) {
			if( $debug ) printf("%s::getSchemaDN(): returning null. (ldap_count_entries() == 0)
",get_class($this));
			return null;
		}

		$entries = @ldap_get_entries( $this->connect(), $search );
		if( $debug ) { echo "Entries (ldap_get_entries): "; var_dump( $entries ); echo "\n"; }
		if( ! $entries || ! is_array( $entries ) ) {
			if( $debug ) printf("%s::getSchemaDN(): returning null. (Bad entries, false or not array)
",get_class($this));
			return null;
		}

		$entry = isset( $entries[0] ) ? $entries[0] : false;
		if( ! $entry ) {
			if( $debug ) printf("%s::getSchemaDN(): returning null. (entry is false)
",get_class($this));
			return null;
		}

		$sub_schema_sub_entry = isset( $entry[0] ) ? $entry[0] : false;
		if( ! $sub_schema_sub_entry ) {
			if( $debug ) printf("%s::getSchemaDN(): returning null. (sub_schema_sub_entry val is false)
",get_class($this));
			return null;
		}

		$this->_schemaDN = isset( $entry[ $sub_schema_sub_entry ][0] ) ?  $entry[ $sub_schema_sub_entry ][0] : false;

		if( $debug ) printf("%s::getSchemaDN(): returning (%s)
",get_class($this),$this->_schemaDN);
		return $this->_schemaDN;
	}

	/**
	 * Fetches the raw schema array for the subschemaSubentry of the server. Note,
	 * this function has grown many hairs to accomodate more LDAP servers. It is
	 * needfully complicated as it now supports many popular LDAP servers that
	 * don't necessarily expose their schema "the right way".
	 *
	 * Please note: On FC systems, it seems that php_ldap uses /etc/openldap/ldap.conf in
	 * the search base if it is blank - so edit that file and comment out the BASE line.
	 *
	 * @param string $schema_to_fetch - A string indicating which type of schema to
	 *		fetch. Five valid values: 'objectclasses', 'attributetypes',
	 *		'ldapsyntaxes', 'matchingruleuse', or 'matchingrules'.
	 *		Case insensitive.
	 * @param dn $dn (optional) This paremeter is the DN of the entry whose schema you
	 * 		would like to fetch. Entries have the option of specifying
	 * 		their own subschemaSubentry that points to the DN of the system
	 * 		schema entry which applies to this attribute. If unspecified,
	 *		this will try to retrieve the schema from the RootDSE subschemaSubentry.
	 *		Failing that, we use some commonly known schema DNs. Default
	 *		value is the Root DSE DN (zero-length string)
	 * @return array an array of strings of this form:
	 *    Array (
	 *      [0] => "( 1.3.6.1.4.1.7165.1.2.2.4 NAME 'gidPool' DESC 'Pool ...
	 *      [1] => "( 1.3.6.1.4.1.7165.2.2.3 NAME 'sambaAccount' DESC 'Sa ...
	 *      etc.
	 */
	function getRawSchema($schema_to_fetch, $dn='')
	{
		global $lang;

		// Swith to true to enable verbose output of schema fetching progress
		$debug = false;

		if (! $this->connect())
			return false;

		// error checking
		$schema_to_fetch = strtolower( $schema_to_fetch );
		$valid_schema_to_fetch = array( 'objectclasses', 'attributetypes', 'ldapsyntaxes',
			'matchingrules', 'matchingruleuse' );

		if( ! in_array( $schema_to_fetch, $valid_schema_to_fetch ) )
		// This error message is not localized as only developers should ever see it
		pla_error( "Bad parameter provided to function to ". get_class($this) ."::getRawSchema(). '"
			. htmlspecialchars( $schema_to_fetch ) . "' is not valid for the schema_to_fetch parameter." );

		// Try to get the schema DN from the specified entry.
		$schema_dn = $this->getSchemaDN($dn,$debug);

		// Do we need to try again with the Root DSE?
		if( ! $schema_dn )
			$schema_dn = $this->getSchemaDN('', $debug);

		// Store the eventual schema retrieval in $schema_search
		$schema_search = null;

		if( $schema_dn ) {
			if( $debug ) { printf("%s::getRawSchema(): Found the Schema DN:
",get_class($this)); var_dump( $schema_dn ); echo "\n"; }
			$schema_search = @ldap_read( $this->connect(), $schema_dn, '(objectClass=*)',
				array( $schema_to_fetch ), 0, 0, 0, LDAP_DEREF_ALWAYS );

			// Were we not able to fetch the schema from the $schema_dn?
			$schema_entries = @ldap_get_entries( $this->connect(), $schema_search );
			if( $schema_search === false ||
				0 == @ldap_count_entries( $this->connect(), $schema_search ) ||
				! isset( $schema_entries[0][$schema_to_fetch] ) ) {

				// Try again with a different filter (some servers require (objectClass=subschema) like M-Vault)
				if( $debug ) printf("%s::getRawSchema(): Did not find the schema with (objectClass=*). Attempting with (objetClass=subschema):
",get_class($this));

				$schema_search = @ldap_read( $this->connect(), $schema_dn, '(objectClass=subschema)',
					array( $schema_to_fetch ), 0, 0, 0, LDAP_DEREF_ALWAYS );

				$schema_entries = @ldap_get_entries( $this->connect(), $schema_search );

		                // Still didn't get it?
				if( $schema_search === false ||
					0 == @ldap_count_entries( $this->connect(), $schema_search ) ||
					! isset( $schema_entries[0][$schema_to_fetch] ) ) {

					if( $debug ) printf("%s::getRawSchema(): Did not find the schema with DN: %s (with objectClass=* nor objectClass=subschema)
",get_class($this),$schema_dn);

					unset( $schema_entries );
					$schema_search = null;
				} else {
					if( $debug ) printf("%s::getRawSchema(): Found the schema at DN: %s (objectClass=subschema)
",get_class($this),$schema_dn);
				}
			} else {
				if( $debug ) printf("%s::getRawSchema(): Found the schema at DN: %s (objectClass=*)
",get_class($this),$schema_dn);
			}
		}

		// Second chance: If the DN or Root DSE didn't give us the subschemaSubentry, ie $schema_search
		// is still null, use some common subSchemaSubentry DNs as a work-around.

		if ($schema_search == null) {
			if( $debug )
				printf("%s::getRawSchema(): Attempting work-arounds for 'broken' LDAP servers...
",get_class($this));

			// OpenLDAP and Novell
			// @todo Fix expand_dn_with_base - no longer works since getBaseDN is now an arrya.
			$ldap['OpenLDAP']['cn=subschema'] = '(objectClass=*)';
//			$ldap['W2K3 AD'][expand_dn_with_base($this,'cn=Aggregate,cn=Schema,cn=configuration,',true)] = '(objectClass=*)';
//			$ldap['W2K AD'][expand_dn_with_base($this,'cn=Schema,cn=configuration,',true)] = '(objectClass=*)';
//			$ldap['W2K AD'][expand_dn_with_base($this,'cn=Schema,ou=Admin,',true)] = '(objectClass=*)';

			foreach ($ldap as $ldap_server_name => $ldap_options) {
				foreach ($ldap_options as $ldap_dn => $ldap_filter) {
					if( $debug ) printf("%s::getRawSchema(): Attempting [%s] (%s) (%s)
",get_class($this),$ldap_server_name,$ldap_dn,$ldap_filter);

					$schema_search = @ldap_read($this->connect(), $ldap_dn, $ldap_filter,
						array( $schema_to_fetch ), 0, 0, 0, LDAP_DEREF_ALWAYS );
				}

				if ($schema_search)
					break;
			}

			// Still cant find the schema, try with the RootDSE
			// Attempt to pull schema from Root DSE with scope "base", or
			// Attempt to pull schema from Root DSE with scope "one" (work-around for Isode M-Vault X.500/LDAP)
		}

		if ($schema_search == null) {
			foreach (array('base','one') as $ldap_scope) {
				if( $debug ) printf("%s::getRawSchema(): Attempting [%s] (%s) (%s) - %s
",get_class($this),'RootDSE','','(objectClass=*)',$ldap_scope);

				if ($ldap_scope == 'base')
					$schema_search = @ldap_read($this->connect(), '', '(objectClass=*)',
						array( $schema_to_fetch ), 0, 0, 0, LDAP_DEREF_ALWAYS );

				else
					$schema_search = @ldap_list($this->connect(), '', '(objectClass=*)',
						array( $schema_to_fetch ), 0, 0, 0, LDAP_DEREF_ALWAYS );

				$schema_entries = @ldap_get_entries( $this->connect(), $schema_search );
				if( ! isset( $schema_entries[0][$schema_to_fetch] ) )
					$schema_search = null;

				else
					break;
			}
		}

		// Shall we just give up?
		if( $schema_search == null ) {
			if( $debug ) printf("%s::getRawSchema(): Returning false since schema_search came back null",get_class($this));
			set_schema_cache_unavailable( $this->server_id, $schema_to_fetch );
			return false;
		}

		// Did we get something unrecognizable?
		if( 'resource' != gettype( $schema_search ) ) {
			if( $debug ) printf("%s::getRawSchema(): Returning false since schema_search is not of type 'resource', here is a dump:",get_class($this));
			if( $debug ) var_dump( $schema_search );
			if( $debug ) echo "