Re: kern/32430: genfs lacking documentation

[Reinoud Zandijk <reinoud%NetBSD.org@localhost>]

On Sat, Jun 11, 2011 at 09:15:06AM +0000, Julian Fagir wrote:
>  recently we had a discussion in the IRCNet #netbsd about that topic.
>  After having a short look, we created a stub for genfs, layerfs, fifofs and
>  specfs by copying their description from the NetBSD internals guide and
>  adding some references.
>  
>  It is intended to be used as genfs(9), and also linked to layerfs(9),
>  fifofs(9), specfs(9).

Thanks for the start. What i was targeting in the PR however was a description
of the various generic FS functions genfs provides and more important its
callbacks.

I think the stub should be more seen as a genfs(0), layerfs(0), specfs(0),
fifofs(0). Still a nice thing to add :) Even if its just marked as a stub.
People seeing references to them at least have a way of knowing what it is all
about.

The genfs(9) could then deal with the semantics of the genfs and its callbacks
and their semantics i.e. when are they called and why. The specfs(9) could
then deal with the special issues around special files etc.

With regards,
Reinoud