File	Date	Author	Commit
build-aux	2008-10-12	David M. Syzdek	[7dc2ed] Re-ordering configure.ac to prevent autoconf wa...
include	2009-01-20	David M. Syzdek	[249175] Starting libldif.la.
ldap-utils.xcodeproj	2009-01-20	David M. Syzdek	[249175] Starting libldif.la.
lib	2009-01-20	David M. Syzdek	[249175] Starting libldif.la.
po	2008-10-20	David M. Syzdek	[efb3c3] Preparing for release 0.1.1
src	2009-01-20	David M. Syzdek	[c5b61c] Merge branch 'master' of ssh://ssh.scm.syzdek.n...
.cvsignore	2008-01-14	syzdek	[f4726c] added new file to list
ABOUT-NLS	2008-01-13	syzdek	[10953d] initial import of files
AUTHORS	2008-01-13	syzdek	[10953d] initial import of files
COPYING	2008-01-13	syzdek	[10953d] initial import of files
ChangeLog	2008-10-20	David M. Syzdek	[efb3c3] Preparing for release 0.1.1
INSTALL	2008-10-12	David M. Syzdek	[7dc2ed] Re-ordering configure.ac to prevent autoconf wa...
Makefile.am	2009-01-20	David M. Syzdek	[249175] Starting libldif.la.
NEWS	2008-01-13	syzdek	[10953d] initial import of files
README	2008-10-20	David M. Syzdek	[efb3c3] Preparing for release 0.1.1
TODO	2008-10-13	David M. Syzdek	[fae60f] Preparing for release 1.0.0
acinclude.m4	2008-10-13	David M. Syzdek	[9d8a7e] Resolving issues with porting to FreeBSD.
configure.ac	2009-01-20	David M. Syzdek	[c5b61c] Merge branch 'master' of ssh://ssh.scm.syzdek.n...

Read Me

Contents
========
   I. Introduction
  II. Reporting Problems
 III. Obtaining the Source
  IV. Compiling and Installing
   V. Example Usage
  VI. Notes for Maintainers

I. Introduction
---------------

This package was developed to provide a set of tools to assist in fullfilling
requests for data and in performing maintenance on LDAP servers.  When applicable,
the command line switches for the OpenLDAP tools were used in this package.


II. Reporting Problems
----------------------

Please report problems regarding this package using the SourceForge Tracker.
The Tracker page for this project is available here:

	<a href=http://sourceforge.net/tracker/?group_id=214270>
	http://sourceforge.net/tracker/?group_id=214270
	</a>

If the Tracker is too confusing, time consuming, detailed, arbitrary,
ridiculous, chaotic, organized, purlple, "I don't speak your crazy
moon-language."; send the request to:

	<a href=mailto:syzdek@users.sourceforge.net>
	syzdek@users.sourceforge.net
	</a>


III. Obtaining the Source
-------------------------

This project is hosted on SourceForge.  The source code can be downloaded from
the following web page:

	<a href=https://sourceforge.net/projects/ldap-utils/>
	https://sourceforge.net/projects/ldap-utils/
	</a>

The latest source code can be retieved from Git using one of the the
following commands:

	git clone git://github.com/syzdek/ldap-utilities.git
	
	git clone git://git.scm.syzdek.net/pub/scm/devel/ldap-utils.git

The package should be copied to a directory called `ldap-utils' which contains
the latest development source.


IV. Compiling and Installing
----------------------------

This project uses GNU Autoconf, GNU Automake, and GNU Libtool in order to ease
porting source across multiple platforms.  As of this writing the source was 
known to compile for the following platforms:

	Apple OS X 10.5.1
	Slackware Linux 11.0
	FreeBSD 4.9 (With GNU Getopt)
	Windows XP SP2

The easist way to compile the source on a Unix platform is to run the
following:

	gzip -cd ldap-utils-x.x.x.tar.gz | tar -xvf -
	cd ldap-utils-x.x.x
	./configure
	make
	make install

For more information on building and installing using configure, please read
the INSTALL file.


V. Example Usage
----------------

Anonymous query that sorts using the "sn" attribute:
   $ ldap2csv -H ldap://ldap.foo.org:983/ -b ou=People,o=foo.org,o=internet \
      -S sn '(mail=*)' sn givenname mail workPhone

Authenticated query:
   $ ldap2csv -H ldap://ldap.foo.org:983/ -b ou=People,o=foo.org,o=internet \
      -D 'uid=admin,ou=People,o=internet' -w password \
      '(mail=*)' sn givenname mail workPhone


VI. Notes for Maintainers
-------------------------

Updating gettext:
   $ ./configure 
   $ (cd po; make update-po) 
   $ make distclean

Updating Github:
   $ git remote
   github
   origin
   $ git push github master

Creating MinGW toolchain:
   http://wiki.syzdek.net/wiki/Cross_Compiler

Creating Windows Binaries from OS X:
   $ export PATH=/usr/local/i386-mingw32/bin:${PATH}
   $ ./configure --host=i386-mingw32 --prefix=/tmp/ldap-utils \
      --enable-strictwarnings --enable-dependency-tracking
   $ make
   $ rm -fR /tmp/ldap-utils
   $ make install-strip
   $ cd /tmp/ldap-utils/bin
   $ ls -l


=============================================================================
End of Document