.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ID 1"
.TH ID 1 "2001-06-06" "perl v5.20.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
id \- show user information
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
id [\-Gnuagraph] [user]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
id displays the user and group names and numeric IDs of the calling
process.  If the real and effective IDs are different, both are displayed,
otherwise only the real \s-1ID\s0 is displayed.
.PP
If a user (username or user \s-1ID\s0) is specified, the information about that user
is displayed instead of the information from the calling process.
.SH "OPTIONS AND ARGUMENTS"
.IX Header "OPTIONS AND ARGUMENTS"
.IP "\fI\-G\fR Display all of the group IDs (effective, real, etc) separated by a space. The IDs are not in a given order." 4
.IX Item "-G Display all of the group IDs (effective, real, etc) separated by a space. The IDs are not in a given order."
.PD 0
.IP "\fI\-a\fR Nothing.  The option is included for compatibility with some versions of id." 4
.IX Item "-a Nothing. The option is included for compatibility with some versions of id."
.IP "\fI\-g\fR Display the effective group \s-1ID.\s0" 4
.IX Item "-g Display the effective group ID."
.IP "\fI\-h\fR Display the usage help message." 4
.IX Item "-h Display the usage help message."
.ie n .IP "\fI\-n\fR Force the options ""\-G"", ""\-g"" and ""\-u"" to display the matching name instead of the number for the user and group IDs.  If any of the \s-1ID\s0 numbers do not have a matching name, the number will be displayed as usual." 4
.el .IP "\fI\-n\fR Force the options \f(CW\-G\fR, \f(CW\-g\fR and \f(CW\-u\fR to display the matching name instead of the number for the user and group IDs.  If any of the \s-1ID\s0 numbers do not have a matching name, the number will be displayed as usual." 4
.IX Item "-n Force the options -G, -g and -u to display the matching name instead of the number for the user and group IDs. If any of the ID numbers do not have a matching name, the number will be displayed as usual."
.ie n .IP "\fI\-p\fR Display the user/group information on seperate lines.  If the username returned by getlogin is different than the username associated with the calling program's user \s-1ID,\s0 it is displayed preceded by the phrase ""login"".  The real \s-1ID,\s0 effective user \s-1ID \s0(if different), real group \s-1ID,\s0 and effective group \s-1ID \s0(if different) are displayed preceded by ""uid"", ""euid"", ""rgid"", and ""egid"" respectively.  Finally, group membership is displayed with each group separated by a space.  All information is displayed as names unless there is no name matching the \s-1ID. \s0 Then the \s-1ID\s0 is shown as usual." 4
.el .IP "\fI\-p\fR Display the user/group information on seperate lines.  If the username returned by getlogin is different than the username associated with the calling program's user \s-1ID,\s0 it is displayed preceded by the phrase ``login''.  The real \s-1ID,\s0 effective user \s-1ID \s0(if different), real group \s-1ID,\s0 and effective group \s-1ID \s0(if different) are displayed preceded by ``uid'', ``euid'', ``rgid'', and ``egid'' respectively.  Finally, group membership is displayed with each group separated by a space.  All information is displayed as names unless there is no name matching the \s-1ID. \s0 Then the \s-1ID\s0 is shown as usual." 4
.IX Item "-p Display the user/group information on seperate lines. If the username returned by getlogin is different than the username associated with the calling program's user ID, it is displayed preceded by the phrase login. The real ID, effective user ID (if different), real group ID, and effective group ID (if different) are displayed preceded by uid, euid, rgid, and egid respectively. Finally, group membership is displayed with each group separated by a space. All information is displayed as names unless there is no name matching the ID. Then the ID is shown as usual."
.ie n .IP "\fI\-r\fR Force the options ""\-g"" and <\-u> to display the information associated with the real user/group IDs instead of the effective \s-1ID\s0 information." 4
.el .IP "\fI\-r\fR Force the options \f(CW\-g\fR and <\-u> to display the information associated with the real user/group IDs instead of the effective \s-1ID\s0 information." 4
.IX Item "-r Force the options -g and <-u> to display the information associated with the real user/group IDs instead of the effective ID information."
.IP "\fI\-u\fR Display the effective user \s-1ID.\s0" 4
.IX Item "-u Display the effective user ID."
.PD
.SH "NOTES"
.IX Header "NOTES"
id returns 0 on success or 1 if an error occurred.
.SH "AUTHOR"
.IX Header "AUTHOR"
Theo Van Dinter (felicity@kluge.net)
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIwho\fR\|(1)
.SH "POD ERRORS"
.IX Header "POD ERRORS"
Hey! \fBThe above document had some coding errors, which are explained below:\fR
.IP "Around line 177:" 4
.IX Item "Around line 177:"
\&'=item' outside of any '=over'
.IP "Around line 214:" 4
.IX Item "Around line 214:"
You forgot a '=back' before '=head1'