Re: [Freeipa-devel] [PATCH 0020] Refactoring of default.conf man page
On 10/18/2012 05:14 PM, Rob Crittenden wrote: Tomas Babej wrote: Hi, Description for the 'server' and 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. Please provide feedback for added descriptions: +.TP +.B server hostname +Specifies the IPA Server hostname. This option is deprecated. +.TP +.B wait_for_attr boolean +Debug option. Waits for asynchronous execution of 389-ds postoperation plugins before returning data to the client, therefore data added by postoperation plugins is included in the result. Increases execution time. The rest of the patch is just sorting options lexicographically. Tomas Can you add startup_timeout as well? This controls the amount of time we wait when starting a service. The default is 2 minutes. And dogtag_version? The changes you made look good. rob The descriptions for the requested options have been added: +.B dogtag_version version +Stores the version of Dogtag. Value 9 is assumed if not specified otherwise. +.B startup_timeout time in seconds +Controls the amount of time waited when starting a service. The default value is 120 seconds. Tomas From 0b6a755a50de7a632ce8ca0a84bdf9f564e472f8 Mon Sep 17 00:00:00 2001 From: Tomas Babej tba...@redhat.com Date: Wed, 17 Oct 2012 08:27:26 -0400 Subject: [PATCH] Refactoring of default.conf man page Description for the 'dogtag_version', 'startup_timeout', 'server', 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. https://fedorahosted.org/freeipa/ticket/3071 --- ipa-client/man/default.conf.5 | 86 --- 1 file changed, 49 insertions(+), 37 deletions(-) diff --git a/ipa-client/man/default.conf.5 b/ipa-client/man/default.conf.5 index fb913e6cca79284fec9d2e3fab77fd47b4b8e48f..f779b51f53c1d181c954d90e686c945f62e5213a 100644 --- a/ipa-client/man/default.conf.5 +++ b/ipa-client/man/default.conf.5 @@ -71,21 +71,45 @@ Specifies the secure CA agent port. The default is 9443 for Dogtag 9, and 8443 f .B ca_ee_port port Specifies the secure CA end user port. The default is 9444 for Dogtag 9, and 8443 for Dogtag 10. .TP -.B ca_port port -Specifies the insecure CA end user port. The default is 9180 for Dogtag 9, and 8080 for Dogtag 10. -.TP .B ca_host hostname Specifies the hostname of the dogtag CA server. The default is the hostname of the IPA server. .TP +.B ca_port port +Specifies the insecure CA end user port. The default is 9180 for Dogtag 9, and 8080 for Dogtag 10. +.TP .B context context Specifies the context that IPA is being executed in. IPA may operate differently depending on the context. The current defined contexts are cli and server. Additionally this value is used to load /etc/ipa/\fBcontext\fR.conf to provide context\-specific configuration. For example, if you want to always perform client requests in verbose mode but do not want to have verbose enabled on the server, add the verbose option to \fI/etc/ipa/cli.conf\fR. .TP -.B verbose boolean -When True provides more information. Specifically this sets the global log level to info. -.TP .B debug boolean When True provides detailed information. Specifically this set the global log level to debug. Default is False. .TP +.B dogtag_version version +Stores the version of Dogtag. Value 9 is assumed if not specified otherwise. +.TP +.B domain domain +The domain of the IPA server e.g. example.com. +.TP +.B enable_ra boolean +Specifies whether the CA is acting as an RA agent, such as when dogtag is being used as the Certificate Authority. This setting only applies to the IPA server configuration. +.TP +.B fallback boolean +Specifies whether an IPA client should attempt to fall back and try other services if the first connection fails. +.TP +.B host hostname +Specifies the hostname of the IPA server. This value is used to construct URL values on the client and server. +.TP +.B in_server boolean +Specifies whether requests should be forwarded to an IPA server or handled locally. This is used internally by IPA in a similar way as context. The same IPA framework is used by the ipa command\-line tool and the server. This setting tells the framework whether it should execute the command as if on the server or forward it via XML\-RPC to a remote server. +.TP +.B in_tree boolean +This is used in development and is generally a detected value. It means that the code is being executed within a source tree. +.TP +.B interactive boolean +Specifies whether values should be prompted for or not. The default is True. +.TP +.B ldap_uri URI +Specifies the URI of the IPA LDAP server to connect to. The URI scheme may be one of \fBldap\fR or \fBldapi\fR. The default is to use ldapi, e.g. ldapi://%2fvar%2frun%2fslapd\-EXAMPLE\-COM.socket +.TP .B log_logger_XXX comma separated
Re: [Freeipa-devel] [PATCH 0020] Refactoring of default.conf man page
Tomas Babej wrote: On 10/18/2012 05:14 PM, Rob Crittenden wrote: Tomas Babej wrote: Hi, Description for the 'server' and 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. Please provide feedback for added descriptions: +.TP +.B server hostname +Specifies the IPA Server hostname. This option is deprecated. +.TP +.B wait_for_attr boolean +Debug option. Waits for asynchronous execution of 389-ds postoperation plugins before returning data to the client, therefore data added by postoperation plugins is included in the result. Increases execution time. The rest of the patch is just sorting options lexicographically. Tomas Can you add startup_timeout as well? This controls the amount of time we wait when starting a service. The default is 2 minutes. And dogtag_version? The changes you made look good. rob The descriptions for the requested options have been added: +.B dogtag_version version +Stores the version of Dogtag. Value 9 is assumed if not specified otherwise. +.B startup_timeout time in seconds +Controls the amount of time waited when starting a service. The default value is 120 seconds. Tomas ack, pushed to master and ipa-3-0 ___ Freeipa-devel mailing list Freeipa-devel@redhat.com https://www.redhat.com/mailman/listinfo/freeipa-devel
Re: [Freeipa-devel] [PATCH 0020] Refactoring of default.conf man page
Tomas Babej wrote: Hi, Description for the 'server' and 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. Please provide feedback for added descriptions: +.TP +.B server hostname +Specifies the IPA Server hostname. This option is deprecated. +.TP +.B wait_for_attr boolean +Debug option. Waits for asynchronous execution of 389-ds postoperation plugins before returning data to the client, therefore data added by postoperation plugins is included in the result. Increases execution time. The rest of the patch is just sorting options lexicographically. Tomas Can you add startup_timeout as well? This controls the amount of time we wait when starting a service. The default is 2 minutes. And dogtag_version? The changes you made look good. rob ___ Freeipa-devel mailing list Freeipa-devel@redhat.com https://www.redhat.com/mailman/listinfo/freeipa-devel
[Freeipa-devel] [PATCH 0020] Refactoring of default.conf man page
Hi, Description for the 'server' and 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. Please provide feedback for added descriptions: +.TP +.B server hostname +Specifies the IPA Server hostname. This option is deprecated. +.TP +.B wait_for_attr boolean +Debug option. Waits for asynchronous execution of 389-ds postoperation plugins before returning data to the client, therefore data added by postoperation plugins is included in the result. Increases execution time. The rest of the patch is just sorting options lexicographically. Tomas From 0ad81fd6cfca017631c705465f940a9b461a52ce Mon Sep 17 00:00:00 2001 From: Tomas Babej tba...@redhat.com Date: Wed, 17 Oct 2012 08:27:26 -0400 Subject: [PATCH] Refactoring of default.conf man page Description for the 'server' and 'wait_for_attr' option has been added. Option 'server' has been marked as deprecated, as it is not used anywhere in IPA code. All the options have been sorted lexicographically. https://fedorahosted.org/freeipa/ticket/3071 --- ipa-client/man/default.conf.5 | 80 +++ 1 file changed, 43 insertions(+), 37 deletions(-) diff --git a/ipa-client/man/default.conf.5 b/ipa-client/man/default.conf.5 index fb913e6cca79284fec9d2e3fab77fd47b4b8e48f..37e6cd2dc33e4ae47ab91334280480f5e5e7d3fa 100644 --- a/ipa-client/man/default.conf.5 +++ b/ipa-client/man/default.conf.5 @@ -71,21 +71,42 @@ Specifies the secure CA agent port. The default is 9443 for Dogtag 9, and 8443 f .B ca_ee_port port Specifies the secure CA end user port. The default is 9444 for Dogtag 9, and 8443 for Dogtag 10. .TP -.B ca_port port -Specifies the insecure CA end user port. The default is 9180 for Dogtag 9, and 8080 for Dogtag 10. -.TP .B ca_host hostname Specifies the hostname of the dogtag CA server. The default is the hostname of the IPA server. .TP +.B ca_port port +Specifies the insecure CA end user port. The default is 9180 for Dogtag 9, and 8080 for Dogtag 10. +.TP .B context context Specifies the context that IPA is being executed in. IPA may operate differently depending on the context. The current defined contexts are cli and server. Additionally this value is used to load /etc/ipa/\fBcontext\fR.conf to provide context\-specific configuration. For example, if you want to always perform client requests in verbose mode but do not want to have verbose enabled on the server, add the verbose option to \fI/etc/ipa/cli.conf\fR. .TP -.B verbose boolean -When True provides more information. Specifically this sets the global log level to info. -.TP .B debug boolean When True provides detailed information. Specifically this set the global log level to debug. Default is False. .TP +.B domain domain +The domain of the IPA server e.g. example.com. +.TP +.B enable_ra boolean +Specifies whether the CA is acting as an RA agent, such as when dogtag is being used as the Certificate Authority. This setting only applies to the IPA server configuration. +.TP +.B fallback boolean +Specifies whether an IPA client should attempt to fall back and try other services if the first connection fails. +.TP +.B host hostname +Specifies the hostname of the IPA server. This value is used to construct URL values on the client and server. +.TP +.B in_server boolean +Specifies whether requests should be forwarded to an IPA server or handled locally. This is used internally by IPA in a similar way as context. The same IPA framework is used by the ipa command\-line tool and the server. This setting tells the framework whether it should execute the command as if on the server or forward it via XML\-RPC to a remote server. +.TP +.B in_tree boolean +This is used in development and is generally a detected value. It means that the code is being executed within a source tree. +.TP +.B interactive boolean +Specifies whether values should be prompted for or not. The default is True. +.TP +.B ldap_uri URI +Specifies the URI of the IPA LDAP server to connect to. The URI scheme may be one of \fBldap\fR or \fBldapi\fR. The default is to use ldapi, e.g. ldapi://%2fvar%2frun%2fslapd\-EXAMPLE\-COM.socket +.TP .B log_logger_XXX comma separated list of regexps loggers matching regexp will be assigned XXX level. .IP @@ -118,32 +139,8 @@ expression metacharacter (matches any character) therefore you will usually need to escape the dot in the logger names by preceeding it with a backslash. .TP -.B domain domain -The domain of the IPA server e.g. example.com. -.TP -.B enable_ra boolean -Specifies whether the CA is acting as an RA agent, such as when dogtag is being used as the Certificate Authority. This setting only applies to the IPA server configuration. -.TP -.B fallback boolean -Specifies whether an IPA client should attempt to fall back and try other services if the first connection fails. -.TP -.B host hostname -Specifies the hostname of the