write(2) and write(3) ERRORS section and equivalent calls

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Man pages for write(2) and write(3) should, in ERRORS section, clearly state that the errors for an equivalent calls apply and errno is set according to those equivalent calls.

Right now write(3) says in DESCRIPTION section among a sea of text:
"If fildes refers to a socket, write() shall be equivalent to send() with no flags set."

And write(2) in ERRORS section:
"Other errors may occur, depending on the object connected to fd."

As an example, if fildes is a socket and write errors with EMSGSIZE (as is possible by default in Linux, man 7 udp) documentation is unclear what happens since in write(3) equivalent calls and errno is not mentioned in the ERRORS section and in write(2) other errors are undocumented.

Emil Fihlman
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux