ldapurl -
инструмент, позволяющий как компоновать, так и разбирать LDAP URI.
При запуске с параметром -Hldapurl
извлекает компоненты предоставленного с параметром аргумента ldapuri
и производит обратное преобразование hex-экранированных символов по мере необходимости.
По существу, в таком варианте этот инструмент представляет собой интерфейс для библиотечного вызова
ldap_url_parse(3).
В противном случае инструмент строит LDAP URI на основании компонентов,
предоставленных в соответствующих параметрах, выполняя обратную операцию.
Параметр -H несовместим с параметрами
-a,
-b,
-E,
-f,
-H,
-h,
-p,
-S
и
-s.
ПАРАМЕТРЫ
-a attrs
Задаёт разделённый запятыми список отбора атрибутов.
-b searchbase
Задаёт базу поиска searchbase.
-e [!]ext[=extparam]
Указывает общие расширения. Знак '!' обозначает критичность расширения.
Общие расширения:
[!]assert=<filter> (фильтр RFC 4515)
[!]authzid=<authzid> ("dn:<dn>" или "u:<user>")
[!]bauthzid (элемент управления authzid RFC 3829)
[!]chaining[=<resolve>[/<cont>]]
[!]manageDSAit
[!]noop
ppolicy
[!]postread[=<attrs>] (разделённый запятыми список атрибутов)
[!]preread[=<attrs>] (разделённый запятыми список атрибутов)
[!]relax
sessiontracking
abandon,cancel,ignore (сигнал SIGINT посылает abandon/cancel,
либо в ответ на него посылается ignore; если расширение помечено
как критичное, сигнал SIGINT не принимается;
ненастоящие элементы управления)
-E [!]ext[=extparam]
Указывает расширения URL; несовместим с параметром
-H.
-f filter
Задаёт фильтр URL. Никаких особых проверок на соответствие LDAP-фильтров требованиям
RFC 4515 не выполняется, но предоставленное значение hex-экранируется по мере необходимости.
-H ldapuri
Задаёт URI, который требуется разобрать.
-h ldaphost
Задаёт хост.
-p ldapport
Задаёт порт TCP.
-S scheme
Задаёт схему URL. Значения по умолчанию других полей, таких как ldapport,
могут зависеть от значения scheme.
-s {base|one|sub|children}
Задаёт диапазон поиска. Может принимать одно из следующих значений:
base,
one,
sub
или
children,
что означает поиск только по базовому объекту, на один уровень ниже, по всему поддереву и по дочерним записям соответственно.
Значение по умолчанию -
sub.
Примечание: для диапазона
children
требуется расширение LDAPv3 subordinate feature.
ФОРМАТ ВХОДНЫХ ДАННЫХ
При использовании параметра -H предоставляемый ldapuri разбирается на компоненты,
которые выводятся на стандартный вывод в LDIF-подобной форме.
В противном случае на стандартный вывод выводится URI, построенный с использованием значений,
предоставленных с другими параметрами.
ПРИМЕРЫ
Команда
ldapurl -h ldap.example.com -b dc=example,dc=com -s sub -f "(cn=Some One)"
Если ошибок не произошло, код завершения - ноль. При наличии ошибок код завершения будет ненулевым,
а в стандартный поток ошибок будет выведено диагностическое сообщение.
Программное обеспечение OpenLDAP
разработано и поддерживается проектом OpenLDAP <http://www.openldap.org/>.
Программное обеспечение OpenLDAP
является производным от релиза 3.3 LDAP Мичиганского Университета.
