CVS update: php3/doc/functions

Date: Wednesday September 9, 1998 @ 12:35 Author: eschmid Update of /repository/php3/doc/functions In directory asf:/tmp/cvs-serv645 Modified Files: ldap.sgml Log Message: Started adding Nick's description. Index: php3/doc/functions/ldap.sgml diff -c php3/doc/functions/ldap.sgml:1.13 php3/doc/functions/ldap.sgml:1.14 *** php3/doc/functions/ldap.sgml:1.13 Thu Apr 23 18:03:27 1998 --- php3/doc/functions/ldap.sgml Wed Sep 9 12:35:01 1998 *************** *** 2,7 **** --- 2,62 ---- <title>LDAP Functions</title> <titleabbrev>LDAP</titleabbrev> + <partintro> + <title>Introduction to LDAP</title> + <para> + LDAP is the Lightweight Directory Access Protocol, and is a + protocol used to access "Directory Servers". The Directory is a + special kind of database that holds information in a tree + structure. + </para><para> + The concept is similar to your hard disk directory structure, + except that in this context, the root directory is "The world" + and the first level subdirectories are "countries". Lower levels + of the directory structure contain entries for companies, + organisations or places, while yet lower still we find directory + entries for people, and perhaps equipment or documents. + </para><para> + To refer to a file in a subdirectory on your hard disk, you might + use something like + </para> + <literallayout> + /usr/local/myapp/docs + </literallayout> + <para> + The forwards slash marks each division in the reference, and the + sequence is read from left to right. + </para><para> + The equivalent to the fully qualified file reference in LDAP is + the "distinguished name", referred to simply as "dn". An example + dn might be + </para> + <literallayout> + cn=John Smith,ou=Accounts,o=My Company,c=US + </literallayout> + <para> + The comma marks each division in the reference, and the sequence + is read from right to left. You would read this dn as .. + </para> + <literallayout> + country = US + organization = My Company + organizationalUnit = Accounts + commonName = John Smith + </literallayout> + <para> + In the same way as there are no hard rules about how you organise + the directory structure of a hard disk, a directory server + manager can set up any structure that is meaningful for the + purpose. However, there are some conventions that are used. The + message is that you can not write code to access a directory + server unless you know something about its structure, any more + than you can use a database without some knowledge of what is + available. + </para> + </partintro> + + <refentry id="function.ldap-add"> <refnamediv> <refname>ldap_add</refname> -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net