summaryrefslogtreecommitdiffstats
path: root/install/tools/man
diff options
context:
space:
mode:
authorRob Crittenden <rcritten@redhat.com>2011-09-13 16:08:58 -0400
committerMartin Kosek <mkosek@redhat.com>2011-09-14 14:39:55 +0200
commitba1bdda25f1345fe015b3ba0abc6996bee223d35 (patch)
tree45c7896276a7ce53332f5756084ba982b16182a2 /install/tools/man
parent0882c25c665da4cf0a14ab4b8eae10bcf86e9c5d (diff)
downloadfreeipa-ba1bdda25f1345fe015b3ba0abc6996bee223d35.tar.gz
freeipa-ba1bdda25f1345fe015b3ba0abc6996bee223d35.tar.xz
freeipa-ba1bdda25f1345fe015b3ba0abc6996bee223d35.zip
Update ipa-ldap-updater man page saying it is not an end-user utility
https://fedorahosted.org/freeipa/ticket/1792
Diffstat (limited to 'install/tools/man')
-rw-r--r--install/tools/man/ipa-ldap-updater.112
1 files changed, 8 insertions, 4 deletions
diff --git a/install/tools/man/ipa-ldap-updater.1 b/install/tools/man/ipa-ldap-updater.1
index f906528a6..ed140b336 100644
--- a/install/tools/man/ipa-ldap-updater.1
+++ b/install/tools/man/ipa-ldap-updater.1
@@ -23,9 +23,11 @@ ipa\-ldap\-updater \- Update the IPA LDAP configuration
ipa\-ldap\-updater [options] input_file(s)
ipa\-ldap\-updater [options]
.SH "DESCRIPTION"
-Run with no file arguments, ipa\-ldap\-updater will process all files with the extension .update in /usr/share/ipa/updates.
+ipa\-ldap\-updater is used to apply updates to the IPA LDAP server when the IPA packages are being updated. It is not intended to be executed by end\-users.
-An update file describes an LDAP entry and a set of operations to be performed on that entry. It can be used to add new entries or modify existing entries. It cannot remove entries, just specific values in a given attribute.
+When run with no file arguments, ipa\-ldap\-updater will process all files with the extension .update in /usr/share/ipa/updates.
+
+An update file describes an LDAP entry and a set of operations to be performed on that entry. It can be used to add new entries or modify existing entries.
Blank lines and lines beginning with # are ignored.
@@ -37,7 +39,7 @@ There are 7 keywords:
* only: set an attribute to this
* deleteentry: remove the entry
* replace: replace an existing value, format is old: new
- * addifnew: add a new attribute and value only if the attribute doesn't already exist. Only works with single-value attributes.
+ * addifnew: add a new attribute and value only if the attribute doesn't already exist. Only works with single\-value attributes.
Values is a comma\-separated field so multi\-values may be added at one time. Double or single quotes may be put around individual values that contain embedded commas.
@@ -51,7 +53,7 @@ The available template variables are:
* $FQDN \- the fully\-qualified domain name of the IPA server being updated (ipa.example.com)
* $DOMAIN \- the domain name (example.com)
* $SUFFIX \- the IPA LDAP suffix (dc=example,dc=com)
- * $ESCAPED_SUFFIX \- the ldap-escaped IPA LDAP suffix
+ * $ESCAPED_SUFFIX \- the ldap\-escaped IPA LDAP suffix
* $LIBARCH \- set to 64 on x86_64 systems to be used for plugin paths
* $TIME \- an integer representation of current time
@@ -64,6 +66,8 @@ A few rules:
5. If a DN doesn't exist it is created from the 'default' entry and all updates are applied
6. If a DN does exist the default values are skipped
7. Only the first rule on a line is respected
+
+Adds and updates are applied from shortest to longest length of DN. Deletes are done from longest to shortest.
.SH "OPTIONS"
.TP
\fB\-d\fR, \fB\-\-debug