Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

LDAPURL(1)							    LDAPURL(1)

NAME
       ldapurl - LDAP URL formatting tool

SYNOPSIS
       ldapurl	    [-a attrs]	    [-b searchbase]	[-e [!]ext[=extparam]]
       [-E [!]ext[=extparam]] [-f filter] [-H ldapuri] [-h ldaphost] [-p ldap‐
       port] [-s {base|one|sub|children}] [-S scheme]

DESCRIPTION
       ldapurl	is  a  command that allows to either compose or decompose LDAP
       URIs.

       When invoked with the -H option, ldapurl extracts the components of the
       ldapuri	option argument, unescaping hex-escaped chars as required.  It
       basically acts as a frontend to the ldap_url_parse(3) call.  Otherwise,
       it builds an LDAP URI based on the components passed with the appropri‐
       ate options, performing the inverse operation.  Option -H is incompati‐
       ble with options -a, -b, -E, -f, -H, -h, -p, -S, and -s.

OPTIONS
       -a attrs
	      Set a comma-separated list of attribute selectors.

       -b searchbase
	      Set the searchbase.

       -e [!]ext[=extparam]

       -E [!]ext[=extparam]

	      Specify  general	extensions  with -e and search extensions with
	      -E.  ´!´ indicates criticality.

	      General extensions:
		[!]assert=<filter>   (an RFC 4515 Filter)
		[!]authzid=<authzid> ("dn:<dn>" or "u:<user>")
		[!]manageDSAit
		[!]noop
		ppolicy
		[!]postread[=<attrs>]	     (a comma-separated attribute list)
		[!]preread[=<attrs>] (a comma-separated attribute list)
		abandon, cancel (SIGINT sends abandon/cancel; not really controls)

	      Search extensions:
		[!]domainScope				     (domain scope)
		[!]mv=<filter>				     (matched values filter)
		[!]pr=<size>[/prompt|noprompt]	     (paged results/prompt)
		[!]sss=[-]<attr[:OID]>[/[-]<attr[:OID]>...]  (server side sorting)
		[!]subentries[=true|false]	     (subentries)
		[!]sync=ro[/<cookie>]			     (LDAP Sync refreshOnly)
			rp[/<cookie>][/<slimit>]     (LDAP Sync refreshAndPersist)

       -f filter
	      Set the URL filter.  No particular check on conformity with  RFC
	      4515  LDAP filters is performed, but the value is hex-escaped as
	      required.

       -H ldapuri
	      Specify URI to be exploded.

       -h ldaphost
	      Set the host.

       -p ldapport
	      Set the TCP port.

       -S scheme
	      Set the URL scheme.  Defaults for other fields,  like  ldapport,
	      may depend on the value of scheme.

       -s {base|one|sub|children}
	      Specify  the scope of the search to be one of base, one, sub, or
	      children to specify a base object, one-level, subtree, or	 chil‐
	      dren search.  The default is sub.	 Note: children scope requires
	      LDAPv3 subordinate feature extension.

OUTPUT FORMAT
       If the -H option is used, the ldapuri supplied is exploded in its  com‐
       ponents, which are printed to standard output in an LDIF-like form.

       Otherwise, the URI built using the values passed with the other options
       is printed to standard output.

EXAMPLE
       The following command:

	   ldapuri -h ldap.example.com -b dc=example,dc=com -s sub -f "(cn=Some One)"

       returns

	   ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)

       The command:

	   ldapuri -H ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)

       returns

	   scheme: ldap
	   host: ldap.example.com
	   port: 389
	   dn: dc=example,dc=com
	   scope: sub
	   filter: (cn=Some One)

DIAGNOSTICS
       Exit status is zero if no errors occur.	Errors result  in  a  non-zero
       exit status and a diagnostic message being written to standard error.

SEE ALSO
       ldap(3), ldap_url_parse(3),

AUTHOR
       The OpenLDAP Project <http://www.openldap.org/>

ACKNOWLEDGEMENTS
       OpenLDAP	 Software  is developed and maintained by The OpenLDAP Project
       <http://www.openldap.org/>.  OpenLDAP Software is derived from  Univer‐
       sity of Michigan LDAP 3.3 Release.

OpenLDAP 2.4.23			  2010/06/30			    LDAPURL(1)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome