https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LU-7557 Lustre <p>Add fid_to_string and string_to_fid functions for more readable print/scan statements. Allow for error checking, defaults, etc.</p> <p>Example print statement:</p> <p>Original: C_DEBUG(D_PAGE, "%lu@"DFID" %p %lx %d\n",<br/> idx, PFID(&amp;hdr-&gt;coh_lu.loh_fid), vmpage, vmpage-&gt;private, type);</p> <p>New: C_DEBUG(D_PAGE, "%lu@%s %p %lx %d\n",<br/> idx, fid_to_string(hdr-&gt;coh_lu.loh_fid), vmpage, vmpage-&gt;private, type);</p> <p>Example scan:</p> <p>Original: if (sscanf(opt.o_src, SFID, RFID(&amp;old_fid)) != 3 || ...</p> <p>New: <br/> old_fid = string_to_fid(opt.o_src); <br/> if ( ...</p> LU-7557

Add fid_to_string and string_to_fid functions

Improvement Minor Open Unresolved Ben Evans Ben Evans Tue, 15 Dec 2015 16:30:34 +0000 Wed, 3 Feb 2016 16:23:57 +0000 0 6 <p>Offshoot from discussion of <a href="https://jira.whamcloud.com/browse/LU-5011" title="lustre_idl.h again does not compile in user space" class="issue-link" data-issue-key="LU-5011"><del>LU-5011</del></a></p> <p>Yes please do this. The upstream reviewers hate macros so replacing this with inline functions would be the way to go.</p> <p>The caller should be managing memory for fid_to_string, and you''ll need handle bad strings in string_to_fid, so how about these prototypes:</p> <p>int fid_to_string(const struct lu_fid *fid, char * str, size_t length);<br/> int string_to_fid(char * str, struct lu_fid *fid);</p> <p>To keep things simple I suggest that fid_to_string should not include the braces, and let applications add the braces where needed. </p> <p>I was thinking:</p> <p>const str* fid_to_string(const struct lu_fid <b>fid, str</b> string, int sz); </p> <p>struct lu_fid string_to_fid(char* fidstr);</p> <p>I'm fine with the nobraces version.</p> <p>99% of all the uses of this are going to be for printk statements, and all but one place where fids are read in.</p> <p>If these are going to be library functions then there will be more uses than just what you can find in the Lustre tree. We need to be able to handle whatever is thrown at us from external applications. </p> <p>Returning a pointer to the passed in buffer is reasonable for fid_to_string, just make sure to handle case when the buffer is too small in a sane way. </p> <p>I would prefer an actual return code from string_to_fid so applications using this can deal with garbage as early as possible.</p> <p>I was thinking it should look like atoi and itoa</p> <p>Well, atoi does no error checking and is essentially the poster child for what not to do. There is strtol which does check errors, but with an overly complex <a href="http://www.gnu.org/software/libc/manual/html_node/Parsing-of-Integers.html" class="external-link" target="_blank" rel="nofollow noopener">interface</a> for our needs. </p> <p>Instead of returning the error code (which seems the most conventional to me), another option is to pass &amp;error to the string_to_fid(). </p> <p>Just as a note I had discussion with Greg about the policy of UAPI type headers. What I was told was UAPI headers, ones shared between kernel and user space, should only contain data structure or simple defines. No functions should be used in UAPI headers. </p> <p>I think we've got more flexability with str_to_fid in terms of return and fields than fid_to_str.</p> <p>But yes, error checking is a good thing here.</p> <p>James, that's right and also there shouldn't be any inline functions in GPL headers intended to be used by non-GPL code. </p> <p>I agree with Robert here. Having an explicit error returned from string_to_fid() is needed to make the error handling reasonable. It might make sense to have a separate fid_to_string_br() or something that prints the standard square brackets around the FID, or it will make for a lot of "<span class="error">&#91;%s&#93;</span>" in the code, and easy to miss those and have inconsistent output. </p> <p>Ben Evans (bevans@cray.com) uploaded a new patch: <a href="http://review.whamcloud.com/17933" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/17933</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LU-7557" title="Add fid_to_string and string_to_fid functions" class="issue-link" data-issue-key="LU-7557">LU-7557</a> headers: add fid_to_str and str_to_fid<br/> Project: fs/lustre-release<br/> Branch: master<br/> Current Patch Set: 1<br/> Commit: fc8efddcdf460b40a61acb83da86ed6cf8ae4689</p> <p>Started based on comments in: <a href="https://jira.hpdd.intel.com/browse/LU-5011" class="external-link" target="_blank" rel="nofollow noopener">https://jira.hpdd.intel.com/browse/LU-5011</a></p> Development Rank 1|hzxvx3: Rank (Obsolete) 9223372036854775807