Difference between revisions of "Talk:Random Numbers"

From OpenSSLWiki
Jump to: navigation, search
(Should we be promoting a commericla company section added)
(Is RAND_poll part of the public API?: conflicting statement about APIs only being guaranteed once documented)
Line 10: Line 10:
  
 
--[[User:Matt|Matt]] 12:26, 9 March 2013 (UTC)
 
--[[User:Matt|Matt]] 12:26, 9 March 2013 (UTC)
 +
 +
I think it would be good to get a clear statement of what constitutes the public API, because I'm getting conflicting messages.  You state that anything in an installed header file is part of the public API.  However, [[Contributions#Code_Maturity]] implies that functions are not part of the API until they are documented.  Since RAND_poll is not documented, that interpretation would suggested that RAND_poll is not yet "cast in stone" and is subject to change.
 +
 +
--[[User:Ppelleti|Ppelleti]] 00:03, 19 March 2013 (UTC)
  
 
==Should we be promoting a commercial company?==
 
==Should we be promoting a commercial company?==

Revision as of 00:03, 19 March 2013

void * casting hack?

The thing about casting to void* and using "%p" just to print an unsigned long in hex seemed a little odd to me. Am I missing something as to why "0x%lx" isn't a viable option?

--Ppelleti 03:00, 8 March 2013 (UTC)

Is RAND_poll part of the public API?

I have removed the question about whether RAND_poll is considered part of the public API. The "rand" module contains two header files: rand.h and rand_locl.h. The first becomes part of the deployment when you install OpenSSL, whilst the latter does not. This is a common theme throughout the library. Basically anything in the *_locl.h header files should be considered private to the library, whilst anything that gets deployed should be considered part of the public API. Since RAND_poll is in rand.h (which gets deployed during installation) it should be considered part of the public API.

--Matt 12:26, 9 March 2013 (UTC)

I think it would be good to get a clear statement of what constitutes the public API, because I'm getting conflicting messages. You state that anything in an installed header file is part of the public API. However, Contributions#Code_Maturity implies that functions are not part of the API until they are documented. Since RAND_poll is not documented, that interpretation would suggested that RAND_poll is not yet "cast in stone" and is subject to change.

--Ppelleti 00:03, 19 March 2013 (UTC)

Should we be promoting a commercial company?

I am a little concerned about the link to entropykey. Should we be promoting a commercial company? Whilst the text reads fine at the moment it could be the "thin end of the wedge". This is a wiki after all. What's to stop other companies coming along and adding links to their products? How will we then decide which edits are ok, and which not? We don't want the page degenerating into a long list of products. Should we not have a policy of "no commerical endorsements"?

--Matt 12:33, 9 March 2013 (UTC)