summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2013-09-20 12:38:00 +0100
committerPádraig Brady <P@draigBrady.com>2013-09-22 03:27:17 +0100
commit7415d8d9f823dae484d3791b425f184f1e3b4cad (patch)
treeca7c6b5124d25e355d8b210ac1d79ff2b6ffc414 /doc
parentf9992690f40646f64d8bd0bfb55faed1980df0ad (diff)
downloadcoreutils-7415d8d9f823dae484d3791b425f184f1e3b4cad.tar.xz
id: support specifying the user by user ID
* src/id.c (usage): Remove 'name' from the synopsis, implying that one can also specify by user ID. (main): Like chown(1), call parse_user_spec() to implement user name or ID lookup with appropriate precedence. * doc/coreutils.texi (id invocation): Mention that a user ID is supported and how '+' affects lookup order. * tests/misc/id-groups.sh: Remove test now subsumed into... * tests/misc/id-uid.sh: New test covering new interface. * tests/local.mk: Rename the test. * NEWS: Mention the new feature. Addresses http://bugs.gnu.org/15421
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d022c4560..5b2f6247b 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -14456,9 +14456,12 @@ logins, groups, and so forth.
running it if no user is specified. Synopsis:
@example
-id [@var{option}]@dots{} [@var{username}]
+id [@var{option}]@dots{} [@var{user}]
@end example
+@var{user} can be either a user ID or a name, with name lookup
+taking precedence unless the ID is specified with a leading @samp{+}.
+
@vindex POSIXLY_CORRECT
By default, it prints the real user ID, real group ID, effective user ID
if different from the real user ID, effective group ID if different from