<!-- 
RSS generated by JIRA (9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c) at Sat Feb 10 02:25:17 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>Whamcloud Community JIRA</title>
    <link>https://jira.whamcloud.com</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.4.14</version>
        <build-number>940014</build-number>
        <build-date>05-12-2023</build-date>
    </build-info>


<item>
            <title>[LU-9336] ssk: documentation of -d flag of lgss_sk is incomplete</title>
                <link>https://jira.whamcloud.com/browse/LU-9336</link>
                <project id="10000" key="LU">Lustre</project>
                    <description>&lt;p&gt;The documentation of the -d flag on lgss_sk only identifies is as setting the &quot;Key random data source&quot; but it also causes the shared key to be regenerated, regardless of the other flags. &lt;/p&gt;

&lt;p&gt;When converting a server shared key to a client one, it&apos;s necessary to use the -m modification flag to change the type attribute of the key. If one uses the -d flag as well, it will rewrite the shared key portion of the keyfile as well, and this behavior is not documented anywhere. This causes errors like:&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;Handling sk request
Decoded netstring of 653 bytes
Creating credentials &lt;span class=&quot;code-keyword&quot;&gt;for&lt;/span&gt; target: test-MDT0000-mdc-ffff88003c228800 with
nodemap: &lt;span class=&quot;code-keyword&quot;&gt;default&lt;/span&gt;
Searching &lt;span class=&quot;code-keyword&quot;&gt;for&lt;/span&gt; key with description: lustre:test:&lt;span class=&quot;code-keyword&quot;&gt;default&lt;/span&gt;
HMAC verification error: 0x60000 from peer 192.168.122.2@tcp
sending reply
writing message:...
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;

&lt;p&gt;It would be nice if this behavior was documented somewhere, though I personally feel like rewriting the shared key should be the sole domain of the -w flag. In any case, I thought I&apos;d report this issue in case it trips up anyone else.&lt;/p&gt;</description>
                <environment></environment>
        <key id="45479">LU-9336</key>
            <summary>ssk: documentation of -d flag of lgss_sk is incomplete</summary>
                <type id="4" iconUrl="https://jira.whamcloud.com/secure/viewavatar?size=xsmall&amp;avatarId=11310&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.whamcloud.com/images/icons/priorities/minor.svg">Minor</priority>
                        <status id="5" iconUrl="https://jira.whamcloud.com/images/icons/statuses/resolved.png" description="A resolution has been taken, and it is awaiting verification by reporter. From here issues are either reopened, or are closed.">Resolved</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="1">Fixed</resolution>
                                        <assignee username="hannac">Chris Hanna</assignee>
                                    <reporter username="kit.westneat">Kit Westneat</reporter>
                        <labels>
                    </labels>
                <created>Thu, 13 Apr 2017 15:10:58 +0000</created>
                <updated>Sat, 8 Jul 2017 02:08:20 +0000</updated>
                            <resolved>Mon, 1 May 2017 18:50:40 +0000</resolved>
                                    <version>Lustre 2.9.0</version>
                                    <fixVersion>Lustre 2.10.0</fixVersion>
                                        <due></due>
                            <votes>0</votes>
                                    <watches>5</watches>
                                                                            <comments>
                            <comment id="191970" author="hannac" created="Thu, 13 Apr 2017 20:37:56 +0000"  >
&lt;p&gt;Similarly, I see another problem with the documentation of the &#8216;-d&#8217; flag.  According to the lgss_sk help:&lt;/p&gt;

&lt;p&gt;&lt;del&gt;d|&lt;/del&gt;-data       &amp;lt;file&amp;gt;	Key random data source (Default: /dev/random)&lt;/p&gt;

&lt;p&gt;This implies to me, and I suspect it would to others, that the data file is a source of entropy for the generation of the key.  Instead, the file becomes the key, since get_key_data() just copies it in.  For example, if &#8220;-d /dev/zero&#8221; is specified when creating a new key:&lt;/p&gt;

&lt;p&gt;Version:        1&lt;br/&gt;
Type:           server&lt;br/&gt;
HMAC alg:       SHA256&lt;br/&gt;
Crypto alg:     AES-256-CTR&lt;br/&gt;
Ctx Expiration: 604800 seconds&lt;br/&gt;
Shared keylen:  256 bits&lt;br/&gt;
Prime length:   2048 bits&lt;br/&gt;
File system:    test&lt;br/&gt;
MGS NIDs:      &lt;br/&gt;
Nodemap name:   default&lt;br/&gt;
Shared key:&lt;br/&gt;
  0000: 0000 0000 0000 0000 0000 0000 0000 0000  ................&lt;br/&gt;
  0010: 0000 0000 0000 0000 0000 0000 0000 0000  ................&lt;/p&gt;

&lt;p&gt;This could be more clearly reflected in the help.  I also agree and propose that the -m flag should not rewrite the original secret when adding the client prime, just because the -d option was specified.&lt;/p&gt;</comment>
                            <comment id="192415" author="adilger" created="Tue, 18 Apr 2017 08:22:10 +0000"  >&lt;p&gt;Kit, Chris, since you are most familiar with this code, could one of you please submit a patch to fix the man page and/or user manual.&lt;/p&gt;

&lt;p&gt;Kit, do you think that this interaction between options should be considered a defect and instead fixed in the code, rather than a comment in the man page that the user will likely not read closely before they get it wrong?&lt;/p&gt;</comment>
                            <comment id="193427" author="hannac" created="Tue, 25 Apr 2017 18:36:15 +0000"  >&lt;p&gt;I can write a quick code patch to make the -m and -d flags incompatible, and fix the help text to clarify that -d specifies the data source without any additional randomization. I don&apos;t think there is any reason to use modify on the key data source, as one could just create new key.  Any objections?&lt;/p&gt;</comment>
                            <comment id="193453" author="kit.westneat" created="Tue, 25 Apr 2017 21:36:02 +0000"  >&lt;p&gt;That works for me!&lt;/p&gt;</comment>
                            <comment id="193585" author="gerrit" created="Wed, 26 Apr 2017 14:03:28 +0000"  >&lt;p&gt;Chris Hanna (hannac@iu.edu) uploaded a new patch: &lt;a href=&quot;https://review.whamcloud.com/26838&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://review.whamcloud.com/26838&lt;/a&gt;&lt;br/&gt;
Subject: &lt;a href=&quot;https://jira.whamcloud.com/browse/LU-9336&quot; title=&quot;ssk: documentation of -d flag of lgss_sk is incomplete&quot; class=&quot;issue-link&quot; data-issue-key=&quot;LU-9336&quot;&gt;&lt;del&gt;LU-9336&lt;/del&gt;&lt;/a&gt; utils: prevent key clobber and clarify lgss_sk usage&lt;br/&gt;
Project: fs/lustre-release&lt;br/&gt;
Branch: master&lt;br/&gt;
Current Patch Set: 1&lt;br/&gt;
Commit: 6f0ff3f9c5b2b7bdf69b8f5c7c4e3a2732ee26ac&lt;/p&gt;</comment>
                            <comment id="194045" author="gerrit" created="Mon, 1 May 2017 17:50:12 +0000"  >&lt;p&gt;Oleg Drokin (oleg.drokin@intel.com) merged in patch &lt;a href=&quot;https://review.whamcloud.com/26838/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://review.whamcloud.com/26838/&lt;/a&gt;&lt;br/&gt;
Subject: &lt;a href=&quot;https://jira.whamcloud.com/browse/LU-9336&quot; title=&quot;ssk: documentation of -d flag of lgss_sk is incomplete&quot; class=&quot;issue-link&quot; data-issue-key=&quot;LU-9336&quot;&gt;&lt;del&gt;LU-9336&lt;/del&gt;&lt;/a&gt; utils: prevent key clobber and clarify lgss_sk usage&lt;br/&gt;
Project: fs/lustre-release&lt;br/&gt;
Branch: master&lt;br/&gt;
Current Patch Set: &lt;br/&gt;
Commit: 236651f59c321cadb66043a5d31174e8ec74c043&lt;/p&gt;</comment>
                            <comment id="194068" author="pjones" created="Mon, 1 May 2017 18:50:40 +0000"  >&lt;p&gt;Landed for 2.10&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                            <customfield id="customfield_10890" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10390" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hzza4v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10090" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                </customfields>
    </item>
</channel>
</rss>