GSoC/GCI Archive
Google Code-in 2010 DragonFly BSD

doc: Write an EXAMPLES section for the writev(2) manpage

completed by: Nagato Yuki

mentors: Samuel J. Greear, Pratyush Kshirsagar, Venkatesh Srinivas

writev(2) is used to write a vector of data to a socket, it is beneficial because it allows, in effect, multiple write operations to be combined into a single operation, increasing performance. writev(2) should be demonstrated in an example on both blocking and non-blocking sockets.


Write an EXAMPLES section for the writev(2) manpage(s) showing the usage of the functions defined in those manpage(s) in a plausible, real-world and if possible only semi-contrived scenario.


All examples should follow the style guidelines in the style(9) manpage.

All examples should be written in a manner that is self-documenting and make copious use of comments in order to explain the actions being taken.

Examples should be real and working code. They should not include headers or even a main function, but it should be reasonable for a developer to copy and paste an example from a manpage and expect it to work.


An example of a manpage with excellent example code is umtx(2).


Deliverables: A complete EXAMPLES manpage section in mdoc format.