Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
id(1M)			System Administration Commands			id(1M)

NAME
       id - return user	identity

SYNOPSIS
       /usr/bin/id [-p]	[user]

       /usr/bin/id -a [-p] [user]

       /usr/xpg4/bin/id	[-p] [user]

       /usr/xpg4/bin/id	-G [-n]	[user]

       /usr/xpg4/bin/id	-g [-nr] [user]

       /usr/xpg4/bin/id	-u [-nr] [user]

DESCRIPTION
       If  no  user  operand  is  provided, the	id utility writes the user and
       group IDs and the corresponding user and	group names  of	 the  invoking
       process to standard output. If the effective and	real IDs do not	match,
       both are	written. If multiple groups are	supported  by  the  underlying
       system,	/usr/xpg4/bin/id  also writes the supplementary	group affilia-
       tions of	the invoking process.

       If a user operand is provided and the process has the appropriate priv-
       ileges,	the  user  and	group IDs of the selected user are written. In
       this case, effective IDs	are assumed to be identical to	real  IDs.  If
       the  selected  user has more than one allowable group membership	listed
       in the group database, /usr/xpg4/bin/id writes them in the same	manner
       as the supplementary groups described in	the preceding paragraph.

   Formats
       The  following  formats	are  used when the LC_MESSAGES locale category
       specifies the "C" 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 are  in-
       serted 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	is in-
       serted directly before the \n character in the format string (and after
       any  addition resulting from the	effective and real user	IDs not	match-
       ing):

       " egid=%u(%s)"

       with the	following arguments added at the end of	the argument list:

       <effectivegroup-ID>, <effectivegroupname>

       If the process has supplementary	group  affiliations  or	 the  selected
       user  is	 allowed  to belong to multiple	groups,	the first is added di-
       rectly before the NEWLINE character 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  re-
       maining 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
       is omitted from the corresponding format	string.

       When  any  of  the  options  are	specified, the output format is	as de-
       scribed under OPTIONS.

OPTIONS
       The  following  option	is   supported	 by   both   /usr/bin/id   and
       /usr/xpg4/bin/id. For /usr/xpg4/bin/id, -p is invalid if	specified with
       any of the -G, -g, or -u	options.

       -p		       Reports additionally the	current	 project  mem-
			       bership of the invoking process.	The project is
			       reported	using the	     format:

			       "projid=%u(%s)"

			       which is	inserted prior to the 0fR character of
			       the  default  format  described	in the Formats
			       section.	The arguments

			       <project	ID>,<project name>

			       are appended to the end of the  argument	 list.
			       If  the project ID cannot be mapped by the sys-
			       tem into	a printable project name,  the	corre-
			       sponding	(%s) and name argument is omitted from
			       the corresponding format	string.

   /usr/bin/id
       The following option is supported for /usr/bin/id only:

       -a	Reports	user name, user	 ID and	all the	groups	to  which  the
		user belongs.

   /usr/xpg4/bin/id
       The following options are supported for /usr/xpg4/bin/id	only:

       -G	Outputs	 all  different	group IDs (effective, real and supple-
		mentary) only, using the format	"%u\n".	If there is more  than
		one  distinct group affiliation, output	each such affiliation,
		using the format " %u",	before the NEWLINE character  is  out-
		put.

       -g	Outputs	only the effective group ID, using the format "%u\n".

       -n	Outputs	 the name in the format	"%s" instead of	the numeric ID
		using the format "%u".

       -r	Outputs	the real ID instead of the effective ID.

       -u	Outputs	only the effective user	ID, using the format "%u\n".

OPERANDS
       The following operand is	supported:

       user	The user (login) name for which	information is to be written.

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following	environment  variables
       that  affect  the execution of id: LANG,	LC_ALL,	LC_CTYPE, LC_MESSAGES,
       and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0	Successful completion.

       >0	An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

   /usr/bin/id
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu, SUNWcar		   |
       +-----------------------------+-----------------------------+

   /usr/xpg4/bin/id
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxcu4			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       fold(1),	logname(1), who(1), getgid(2), getgroups(2), getprojid(2), ge-
       tuid(2),	attributes(5), environ(5), standards(5)

NOTES
       Output  produced	 by the	-G option and by the default case could	poten-
       tially produce very long	lines on systems that support large numbers of
       supplementary groups.

SunOS 5.10			  24 Jan 2000				id(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=id&sektion=1m&manpath=SunOS+5.10>

home | help