aboutsummaryrefslogtreecommitdiff
path: root/coreutils-5.3.0-bin/man/cat1p/id.1p.txt
diff options
context:
space:
mode:
authorIndrajith K L2022-12-03 17:00:20 +0530
committerIndrajith K L2022-12-03 17:00:20 +0530
commitf5c4671bfbad96bf346bd7e9a21fc4317b4959df (patch)
tree2764fc62da58f2ba8da7ed341643fc359873142f /coreutils-5.3.0-bin/man/cat1p/id.1p.txt
downloadcli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.tar.gz
cli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.tar.bz2
cli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.zip
Adds most of the toolsHEADmaster
Diffstat (limited to 'coreutils-5.3.0-bin/man/cat1p/id.1p.txt')
-rw-r--r--coreutils-5.3.0-bin/man/cat1p/id.1p.txt279
1 files changed, 279 insertions, 0 deletions
diff --git a/coreutils-5.3.0-bin/man/cat1p/id.1p.txt b/coreutils-5.3.0-bin/man/cat1p/id.1p.txt
new file mode 100644
index 0000000..3f581cf
--- /dev/null
+++ b/coreutils-5.3.0-bin/man/cat1p/id.1p.txt
@@ -0,0 +1,279 @@
+id(P) id(P)
+
+
+
+
+
+NAME
+ id - return user identity
+
+SYNOPSIS
+ id [user]
+
+ id -G[-n] [user]
+
+ id -g[-nr] [user]
+
+ id -u[-nr] [user]
+
+
+DESCRIPTION
+ If no user operand is provided, the id utility shall
+ write the user and group IDs and the corresponding user
+ and group names of the invoking process to standard out-
+ put. If the effective and real IDs do not match, both
+ shall be written. If multiple groups are supported by
+ the underlying system (see the description of
+ {NGROUPS_MAX} in the System Interfaces volume of
+ IEEE Std 1003.1-2001), the supplementary group affilia-
+ tions of the invoking process shall also be written.
+
+ If a user operand is provided and the process has the
+ appropriate privileges, the user and group IDs of the
+ selected user shall be written. In this case, effective
+ IDs shall be assumed to be identical to real IDs. If the
+ selected user has more than one allowable group member-
+ ship listed in the group database, these shall be writ-
+ ten in the same manner as the supplementary groups
+ described in the preceding paragraph.
+
+OPTIONS
+ The id utility shall conform to the Base Definitions
+ volume of IEEE Std 1003.1-2001, Section 12.2, Utility
+ Syntax Guidelines.
+
+ The following options shall be supported:
+
+ -G Output all different group IDs (effective, real,
+ and supplementary) only, using the format "%u\n"
+ . If there is more than one distinct group affil-
+ iation, output each such affiliation, using the
+ format " %u" , before the <newline> is output.
+
+ -g Output only the effective group ID, using the
+ format "%u\n" .
+
+ -n Output the name in the format "%s" instead of the
+ numeric ID using the format "%u" .
+
+ -r Output the real ID instead of the effective ID.
+
+ -u Output only the effective user ID, using the for-
+ mat "%u\n" .
+
+
+OPERANDS
+ The following operand shall be supported:
+
+ user The login name for which information is to be
+ written.
+
+
+STDIN
+ Not used.
+
+INPUT FILES
+ None.
+
+ENVIRONMENT VARIABLES
+ The following environment variables shall affect the
+ execution of id:
+
+ LANG Provide a default value for the internationaliza-
+ tion variables that are unset or null. (See the
+ Base Definitions volume of IEEE Std 1003.1-2001,
+ Section 8.2, Internationalization Variables for
+ the precedence of internationalization variables
+ used to determine the values of locale cate-
+ gories.)
+
+ LC_ALL If set to a non-empty string value, override the
+ values of all the other internationalization
+ variables.
+
+ LC_CTYPE
+ Determine the locale for the interpretation of
+ sequences of bytes of text data as characters
+ (for example, single-byte as opposed to multi-
+ byte characters in arguments).
+
+ LC_MESSAGES
+ Determine the locale that should be used to
+ affect the format and contents of diagnostic mes-
+ sages written to standard error and informative
+ messages written to standard output.
+
+ NLSPATH
+ Determine the location of message catalogs for
+ the processing of LC_MESSAGES .
+
+
+ASYNCHRONOUS EVENTS
+ Default.
+
+STDOUT
+ The following formats shall be used when the LC_MESSAGES
+ locale category specifies the POSIX locale. In other
+ locales, the strings uid, gid, euid, egid, and groups
+ may be replaced with more appropriate strings corre-
+ sponding to the locale.
+
+
+ "uid=%u(%s) gid=%u(%s)\n", <real user ID>, <user-name>,
+ <real group ID>, <group-name>
+
+ If the effective and real user IDs do not match, the
+ following shall be inserted immediately before the '\n'
+ character in the previous format:
+
+
+ " euid=%u(%s)"
+
+ with the following arguments added at the end of the
+ argument list:
+
+
+ <effective user ID>, <effective user-name>
+
+ If the effective and real group IDs do not match, the
+ following shall be inserted directly before the '\n'
+ character in the format string (and after any addition
+ resulting from the effective and real user IDs not
+ matching):
+
+
+ " egid=%u(%s)"
+
+ with the following arguments added at the end of the
+ argument list:
+
+
+ <effective group-ID>, <effective group name>
+
+ If the process has supplementary group affiliations or
+ the selected user is allowed to belong to multiple
+ groups, the first shall be added directly before the
+ <newline> in the format string:
+
+
+ " groups=%u(%s)"
+
+ with the following arguments added at the end of the
+ argument list:
+
+
+ <supplementary group ID>, <supplementary group name>
+
+ and the necessary number of the following added after
+ that for any remaining supplementary group IDs:
+
+
+ ",%u(%s)"
+
+ and the necessary number of the following arguments
+ added at the end of the argument list:
+
+
+ <supplementary group ID>, <supplementary group name>
+
+ If any of the user ID, group ID, effective user ID,
+ effective group ID, or supplementary/multiple group IDs
+ cannot be mapped by the system into printable user or
+ group names, the corresponding "(%s)" and name argument
+ shall be omitted from the corresponding format string.
+
+ When any of the options are specified, the output format
+ shall be as described in the OPTIONS section.
+
+STDERR
+ The standard error shall be used only for diagnostic
+ messages.
+
+OUTPUT FILES
+ None.
+
+EXTENDED DESCRIPTION
+ None.
+
+EXIT STATUS
+ The following exit values shall be returned:
+
+ 0 Successful completion.
+
+ >0 An error occurred.
+
+
+CONSEQUENCES OF ERRORS
+ Default.
+
+ The following sections are informative.
+
+APPLICATION USAGE
+ Output produced by the -G option and by the default case
+ could potentially produce very long lines on systems
+ that support large numbers of supplementary groups. (On
+ systems with user and group IDs that are 32-bit integers
+ and with group names with a maximum of 8 bytes per name,
+ 93 supplementary groups plus distinct effective and real
+ group and user IDs could theoretically overflow the
+ 2048-byte {LINE_MAX} text file line limit on the default
+ output case. It would take about 186 supplementary
+ groups to overflow the 2048-byte barrier using id -G).
+ This is not expected to be a problem in practice, but in
+ cases where it is a concern, applications should con-
+ sider using fold -s before postprocessing the output of
+ id.
+
+EXAMPLES
+ None.
+
+RATIONALE
+ The functionality provided by the 4 BSD groups utility
+ can be simulated using:
+
+
+ id -Gn [ user ]
+
+ The 4 BSD command groups was considered, but it was not
+ included because it did not provide the functionality of
+ the id utility of the SVID. Also, it was thought that it
+ would be easier to modify id to provide the additional
+ functionality necessary to systems with multiple groups
+ than to invent another command.
+
+ The options -u, -g, -n, and -r were added to ease the
+ use of id with shell commands substitution. Without
+ these options it is necessary to use some preprocessor
+ such as sed to select the desired piece of information.
+ Since output such as that produced by:
+
+
+ id -u -n
+
+ is frequently wanted, it seemed desirable to add the
+ options.
+
+FUTURE DIRECTIONS
+ None.
+
+SEE ALSO
+ fold , logname , who , the System Interfaces volume of
+ IEEE Std 1003.1-2001, getgid(), getgroups(), getuid()
+
+COPYRIGHT
+ Portions of this text are reprinted and reproduced in
+ electronic form from IEEE Std 1003.1, 2003 Edition,
+ Standard for Information Technology -- Portable Operat-
+ ing System Interface (POSIX), The Open Group Base Speci-
+ fications Issue 6, Copyright (C) 2001-2003 by the Insti-
+ tute of Electrical and Electronics Engineers, Inc and
+ The Open Group. In the event of any discrepancy between
+ this version and the original IEEE and The Open Group
+ Standard, the original IEEE and The Open Group Standard
+ is the referee document. The original Standard can be
+ obtained online at http://www.open-
+ group.org/unix/online.html .
+
+
+
+POSIX 2003 id(P)