Bug 52681

Summary: getspnam errno values
Product: Documentation Reporter: Wolfgang Rohdewald (wolfgang)
Component: man-pagesAssignee: documentation_man-pages (documentation_man-pages)
Status: RESOLVED CODE_FIX    
Severity: low CC: mtk.manpages
Priority: P1    
Hardware: All   
OS: Linux   
Kernel Version: Subsystem:
Regression: No Bisected commit-id:

Description Wolfgang Rohdewald 2013-01-14 01:48:41 UTC 
man getspnam, section ERRORS only mentions ERANGE.

If I cannot access /etc/shadow, EACCESS is returned.

Shouldn't EACCESS be mentioned on the man page?

kubuntu 12.10, kernel 3.5.0-21
Comment 1 Michael Kerrisk 2013-01-21 23:24:41 UTC 
Thanks. I've added EACCES under errors.

--- a/man3/getspnam.3
+++ b/man3/getspnam.3
@@ -224,6 +224,9 @@ The reentrant functions return zero on success.
 In case of error, an error number is returned.
 .SH ERRORS
 .TP
+.B EACCES
+The caller does not have permission to access the shadow password file.
+.TP
 .B ERANGE
 Supplied buffer is too small.
 .SH FILES