New: glibc 2.16 included a new function __ppc_get_timebase
https://bugzilla.kernel.org/show_bug.cgi?id=50151
Summary: glibc 2.16 included a new function __ppc_get_timebase
Product: Documentation
Version: unspecified
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: tuliom-Igl6534fJ5VwFqzsTH5u/[email protected]
Regression: No
Created an attachment (id=85661)
--> (https://bugzilla.kernel.org/attachment.cgi?id=85661)
Patch that adds the man-page for __ppc_get_timebase
glibc 2.16 included a new function to read the Time Base Register on Power processors on the following commit:
http://sourceware.org/git/?p=glibc.git;a=commit;h=d9dc34cd569bcfe714fe8c708e58c028106e8b2e
The attached patch adds the new man-page and applies to the master branch.
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]
--- Comment #1 from Michael Kerrisk <[email protected]> 2013-01-21 23:33:07 --- Hello Tulio,
What's the significance of the __" prefix in this function name? Is this function really intended for userspace?
Also, what about __ppc_get_timebase_freq(). Does it likewise need to be documented?
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #2 from Tulio Magno Quites Machado Filho <tuliom-Igl6534fJ5VwFqzsTH5u/[email protected]> 2013-01-23 19:12:52 --- (In reply to comment #1)
Quoted 1 line
What's the significance of the __" prefix in this function name?
It was a convention adopted for platform specific functions. You may find more information in
http://www.gnu.org/software/libc/manual/html_node/Adding-Platform_002dspecific.html#Adding-Platform_002dspecific
Quoted 1 line
Is this function really intended for userspace?
Yes.
Quoted 2 lines
Also, what about
__ppc_get_timebase_freq(). Does it likewise need to be documented?
Yes. I'm also planning to prepare it's manpage.
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #3 from Michael Kerrisk <[email protected]> 2013-01-24 03:05:00 --- Would it make sense to document both functions on one page (since they seem
closely related)?
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #4 from Tulio Magno Quites Machado Filho <tuliom-Igl6534fJ5VwFqzsTH5u/[email protected]> 2013-01-24 10:56:51 --- Yes.
I also think this test [1] is good candidate for an example on how to use them.
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #5 from Michael Kerrisk <[email protected]> --- (In reply to Michael Kerrisk from comment #1)
Quoted 7 lines
Hello Tulio,
What's the significance of the __" prefix in this function name? Is this function really intended for userspace?
Also, what about
__ppc_get_timebase_freq(). Does it likewise need to be documented?
Hello Tulio,
Okay -- this fell on the ground for a very long time. Sorry about that. But your patch is applied now. What shall we do about __ppc_get_timebase_freq()? (I see there is documentation in the glibc manual.)
Thanks,
Michael
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #6 from Tulio Magno Quites Machado Filho <tuliom-Igl6534fJ5VwFqzsTH5u/[email protected]> --- (In reply to Michael Kerrisk from comment #5)
Quoted 2 lines
Okay -- this fell on the ground for a very long time. Sorry about that. But your patch is applied now.
Thanks for applying it!
Quoted 1 line
What shall we do about
__ppc_get_timebase_freq()? (I see there is documentation in the glibc manual.)
Yes, it does.
I'll add it to the same man page. Just give me some time because I'll be on a trip for the next 2 weeks.
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
--- Comment #7 from Tulio Magno Quites Machado Filho <tuliom-Igl6534fJ5VwFqzsTH5u/[email protected]> --- (In reply to Michael Kerrisk from comment #5)
Quoted 1 line
What shall we do about
__ppc_get_timebase_freq()?
I've just sent a patch adding it to the same page.
http://marc.info/?l=linux-man&m=143258058005074&w=2
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 50151] glibc 2.16 included a new function __ppc_get_timebase
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=50151
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
Resolution|--- |CODE_FIX--- Comment #8 from Michael Kerrisk <[email protected]> --- Patch applied. Closing.
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html