[SSSD] [PATCH] MAN: libkrb5 and SSSD use different expansions

Sumit Bose sbose at redhat.com
Fri Jan 30 10:40:28 UTC 2015


On Fri, Jan 30, 2015 at 05:22:53AM -0500, Dan Lavu wrote:
> Oooof... I tried digest mode so I can get a better overview of all the mailing lists I'm on and I found it more cumbersome. Anyways, here is my edit. 
> 
> Also does anybody know of a tool, so I can test the xml for errors and view the output like a man page? Without compiling the book? Thanks.

the tools are called xmllint and xsltproc but instead of running them
manually I would suggest to let make do this for you:

$ touch ../src/man/sssd-krb5.5.xml
$ make V=0 man_MANS=sssd-krb5.5                                                                                                                                                                    
make  all-recursive
make[1]: Entering directory '/home/sbose/sssd/master_build'
Making all in po
make[2]: Entering directory '/home/sbose/sssd/master_build/po'
make[2]: Nothing to be done for 'all'.
make[2]: Leaving directory '/home/sbose/sssd/master_build/po'
Making all in src/man
make[2]: Entering directory '/home/sbose/sssd/master_build/src/man'
/usr/bin/xmllint --catalogs --postvalid --nonet --noent --xinclude --noout ../../../src/man/sssd-krb5.5.xml
/usr/bin/xsltproc -o sssd-krb5.5  --catalogs --xinclude --nonet --stringparam profile.condition "with_false;with_sudo;with_autofs;with_ssh;with_pac_responder;with_ifp" http://docbook.sourceforge.net/release/xsl/current/manpages/profile-docbook.xsl ../../../src/man/sssd-krb5.5.xml
Note: Writing sssd-krb5.5

....
[dropped some addtional output]
...

$ man src/man/sssd-krb5.5


Here you can also see the xmllint and xsltproc option used to generate the man page.

HTH

bye,
Sumit

> 
> ----- Original Message -----
> From: "Jakub Hrozek" <jhrozek at redhat.com>
> To: sssd-devel at lists.fedorahosted.org
> Sent: Wednesday, January 28, 2015 9:28:25 AM
> Subject: Re: [SSSD] [PATCH] MAN: libkrb5 and SSSD use different expansions
> 
> On Wed, Jan 28, 2015 at 03:23:09PM +0100, Pavel Reichl wrote:
> > 
> > On 01/14/2015 06:16 PM, Pavel Reichl wrote:
> > >Hello, please see attached patch. Thanks!
> > >
> > >
> > >_______________________________________________
> > >sssd-devel mailing list
> > >sssd-devel at lists.fedorahosted.org
> > >https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
> > Should I ask some native speaker for review or shall we do the review
> > ourselves?
> 
> It would be nice if Stephen or Dan could help.
> _______________________________________________
> sssd-devel mailing list
> sssd-devel at lists.fedorahosted.org
> https://lists.fedorahosted.org/mailman/listinfo/sssd-devel

> diff --git a/src/man/sssd-krb5.5.xml b/src/man/sssd-krb5.5.xml
> index 5bcab21..ad6389b 100644
> --- a/src/man/sssd-krb5.5.xml
> +++ b/src/man/sssd-krb5.5.xml
> @@ -215,14 +215,34 @@
>                          <para>
>                              The default value for the credential cache name is
>                              sourced from the profile stored in the system wide
> -                            krb5.conf configuration file in the [libdefaults]
> +                            krb5.conf configuration file, in the [libdefaults]
>                              section. The option name is default_ccache_name.
>                              See krb5.conf(5)'s PARAMETER EXPANSION paragraph
>                              for additional information on the expansion format
>                              defined by krb5.conf.
>                          </para>
>                          <para>
> -                            Default: (from libkrb5)
> +                            NOTE: The value for the template is not the same
> +                            between sssd.conf and
> +                          <citerefentry>
> +                                <refentrytitle>krb5.conf</refentrytitle>
> +                                <manvolnum>5</manvolnum>
> +                          </citerefentry>
> +                        </para>
> +                        <para>
> +                            The equivalent values are listed below.
> +                          <variablelist>
> +                                <varlistentry>
> +                                    <term>krb5.conf</term>
> +                                    <listitem><para>KEYRING:persistent:%{uid}
> +                                                    </para></listitem>
> +                                </varlistentry>
> +                                <varlistentry>
> +                                    <term>sssd.conf</term>
> +                                    <listitem><para>KEYRING:persistent:%U
> +                                                    </para></listitem>
> +                                </varlistentry>
> +                          </variablelist>
>                          </para>
>                      </listitem>
>                  </varlistentry>
> 

> _______________________________________________
> sssd-devel mailing list
> sssd-devel at lists.fedorahosted.org
> https://lists.fedorahosted.org/mailman/listinfo/sssd-devel




More information about the sssd-devel mailing list