On Thu, 24 Jul 2014, Theodore Ts'o wrote: > On Thu, Jul 24, 2014 at 05:30:19PM -0300, Henrique de Moraes Holschuh wrote: > > > I wouldn't add the error to the man page until we actually modify the > > > kernel to add such a restriction. > > > > By then, it might be too late. It would be really sad to find ourselves > > forced to return ENOSYS to getrandom(GRND_RANDOM) when we actually wanted to > > return EPERM/EACCES. > > I wouldn't worry about. The reality is that anyone using GRND_RANDOM > has to be checking for error codes anyway, and if they do something ... > In general, all system calls can return errno's other than the ones > documented in the man page. This is certainly true for open(2), and > read(2) if you are using a network file system such as NFS. Someone A few manpages might actually have warnings to that effect, but it is not the rule. Amusingly enough, the one for read(2) does, while open(2) does not. IMHO the getrandom(2) case is slightly different: we already know to a high degree of confidence that we will want to convey a "permission denied" condition to userspace for getrandom(GRND_RANDOM) sooner or later. I'd be fine with text that mentions that GRND_RANDOM access by a process may be restricted/rejected by system policy in the future, so code should not assume any error return code from getrandom(GRND_RANDOM) would also apply to getrandom() without GRND_RANDOM, and must degrade gracefully and safely in that case. > I don't think it's necessary to add a sentence that other errors can > be returned in the future, and users much check for other errors, but > if you really think people are that stupid that we need to say > something which is true for every single system call in Linux, we can > do that.... Well, I feel we could go a bit further than usual for getrandom(2), but I've already stated my case. -- "One disk to rule them all, One disk to find them. One disk to bring them all and in the darkness grind them. In the Land of Redmond where the shadows lie." -- The Silicon Valley Tarot Henrique Holschuh -- To unsubscribe from this list: send the line "unsubscribe linux-api" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
