kernelnewbies.kernelnewbies.org archive mirror
 help / color / mirror / Atom feed
* Comprehensive Linux API manual by subsystem Required
@ 2015-08-19 13:02 Sasha Mckinsey
  2015-08-21  4:48 ` Aruna Hewapathirane
  0 siblings, 1 reply; 3+ messages in thread
From: Sasha Mckinsey @ 2015-08-19 13:02 UTC (permalink / raw)
  To: kernelnewbies

Hello,

I know this is not a question which belongs in the Newbies list but there is a strong chance that someone out here might know about such a resource. 

I am developing a user space program which interacts with "file system" and "cryptography" so I looking for a comprehensive on the lines of "MSDN in Windows" which talks about the API by subsystem. Kindly provide the URL if you have such a manual/ resource in mind which is available on the net.

Thanks! 

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Comprehensive Linux API manual by subsystem Required
  2015-08-19 13:02 Comprehensive Linux API manual by subsystem Required Sasha Mckinsey
@ 2015-08-21  4:48 ` Aruna Hewapathirane
  2015-08-21  8:18   ` Valdis.Kletnieks at vt.edu
  0 siblings, 1 reply; 3+ messages in thread
From: Aruna Hewapathirane @ 2015-08-21  4:48 UTC (permalink / raw)
  To: kernelnewbies

>> I am developing a user space program which interacts with "file system"
https://www.kernel.org/doc/htmldocs/filesystems/index.html

> and "cryptography"
https://www.kernel.org/doc/htmldocs/crypto-API/index.html

The best documentation IS right there in the kernel source :)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.kernelnewbies.org/pipermail/kernelnewbies/attachments/20150821/cd1e4803/attachment.html 

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Comprehensive Linux API manual by subsystem Required
  2015-08-21  4:48 ` Aruna Hewapathirane
@ 2015-08-21  8:18   ` Valdis.Kletnieks at vt.edu
  0 siblings, 0 replies; 3+ messages in thread
From: Valdis.Kletnieks at vt.edu @ 2015-08-21  8:18 UTC (permalink / raw)
  To: kernelnewbies

On Fri, 21 Aug 2015 00:48:26 -0400, Aruna Hewapathirane said:

> >> I am developing a user space program which interacts with "file system"
> https://www.kernel.org/doc/htmldocs/filesystems/index.html
>
> > and "cryptography"
> https://www.kernel.org/doc/htmldocs/crypto-API/index.html
>
> The best documentation IS right there in the kernel source :)

And to address why there isn't a comprehensive API manual:

Documentation/stable_api_nonsense.txt

Unless you install the tools and do a 'make kerneldoc' yourself, any manual
of the API will quickly grow out of date. The diffstat from v4.0 to v4.1 was:

 10094 files changed, 454027 insertions(+), 253911 deletions(-)

That's more churn than anybody can document - which is why LDD3, although
an excellent book, is no longer in sync with the source.

Also, some free advice: If this is for production use and not a toy project,
find an actual security/crypto expert and have them do a review.  Even better
if they are onboard during the design phase. Crypto is easy to do, but a total
bitch to do *right*.

If you don't believe me, go look at how many times OpenSSL has been broken
in the past 2 years or so.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 848 bytes
Desc: not available
Url : http://lists.kernelnewbies.org/pipermail/kernelnewbies/attachments/20150821/225bb7b1/attachment.bin 

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2015-08-21  8:18 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-08-19 13:02 Comprehensive Linux API manual by subsystem Required Sasha Mckinsey
2015-08-21  4:48 ` Aruna Hewapathirane
2015-08-21  8:18   ` Valdis.Kletnieks at vt.edu

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).