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

Bug#445631: [Patch] getent: Please document exit codes in manpage



Package: libc6
Version: 2.3.6.ds1-13
Severity: wishlist
Tags: patch

Hello,

please document getent's exit codes in its manpage. After a short
glimpse at the source of getent I found out following exit codes:

0	Success
1	Unknown database
2	Key not found in database
3	Database does not support enumeration

I don't know though, whether this is complete and correct (please review).

Nevertheless I worked out a patch for the manpage's source file
getent.pod. After applying the patch a subsequent make is needed in
order to rebuild the manpage itself.

Thanks
  Micha
diff -Naur glibc-2.3.6.ds1.orig/debian/local/manpages/getent.pod glibc-2.3.6.ds1/debian/local/manpages/getent.pod
--- glibc-2.3.6.ds1.orig/debian/local/manpages/getent.pod	2007-10-07 13:41:44.000000000 +0200
+++ glibc-2.3.6.ds1/debian/local/manpages/getent.pod	2007-10-07 13:40:52.912051163 +0200
@@ -13,6 +13,18 @@
 Where I<database> is one of passwd, group, hosts, services, protocols,
 or networks.
 
+=head1 EXIT VALUES
+
+The I<getent> command exits with the following values:
+
+B<0>	Success
+
+B<1>	Unknown database
+
+B<2>	Key not found in database
+
+B<3>	Database does not support enumeration
+
 =head1 AUTHOR
 
 I<getent> was written by Thorsten Kukuk for the GNU C Library.

Attachment: signature.asc
Description: OpenPGP digital signature


Reply to: