1[![GoDoc](https://godoc.org/gopkg.in/ldap.v3?status.svg)](https://godoc.org/gopkg.in/ldap.v3)
2[![Build Status](https://travis-ci.org/go-ldap/ldap.svg)](https://travis-ci.org/go-ldap/ldap)
3
4# Basic LDAP v3 functionality for the GO programming language.
5
6## Install
7
8For the latest version use:
9
10    go get gopkg.in/ldap.v3
11
12Import the latest version with:
13
14    import "gopkg.in/ldap.v3"
15
16## Required Libraries:
17
18 - gopkg.in/asn1-ber.v1
19
20## Features:
21
22 - Connecting to LDAP server (non-TLS, TLS, STARTTLS)
23 - Binding to LDAP server
24 - Searching for entries
25 - Filter Compile / Decompile
26 - Paging Search Results
27 - Modify Requests / Responses
28 - Add Requests / Responses
29 - Delete Requests / Responses
30 - Modify DN Requests / Responses
31
32## Examples:
33
34 - search
35 - modify
36
37## Contributing:
38
39Bug reports and pull requests are welcome!
40
41Before submitting a pull request, please make sure tests and verification scripts pass:
42```
43make all
44```
45
46To set up a pre-push hook to run the tests and verify scripts before pushing:
47```
48ln -s ../../.githooks/pre-push .git/hooks/pre-push
49```
50
51---
52The Go gopher was designed by Renee French. (http://reneefrench.blogspot.com/)
53The design is licensed under the Creative Commons 3.0 Attributions license.
54Read this article for more details: http://blog.golang.org/gopher
55