granicus.if.org Git - shadow/blob - man/groups.1.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id='groups.1'>
   3   <!-- $Id: groups.1.xml,v 1.16 2006/05/20 12:11:38 kloczek Exp $ -->
   4   <refmeta>
   5     <refentrytitle>groups</refentrytitle>
   6     <manvolnum>1</manvolnum>
   7     <refmiscinfo class="sectdesc">User Commands</refmiscinfo>
   8   </refmeta>
   9   <refnamediv id='name'>
  10     <refname>groups</refname>
  11     <refpurpose>display current group names</refpurpose>
  12   </refnamediv>
  13
  14   <refsynopsisdiv id='synopsis'>
  15     <cmdsynopsis>
  16       <command>groups</command>
  17       <arg choice='opt'>
  18         <replaceable>user</replaceable>
  19       </arg>
  20     </cmdsynopsis>
  21   </refsynopsisdiv>
  22
  23   <refsect1 id='description'>
  24     <title>DESCRIPTION</title>
  25     <para>
  26       <command>groups</command> displays the current group names or ID
  27       values. If the value does not have a corresponding entry in
  28       <filename>/etc/group</filename>, the value will be displayed as the
  29       numerical group value. The optional <emphasis
  30       remap='I'>user</emphasis> parameter will display the groups for the
  31       named <emphasis remap='I'>user</emphasis>.
  32     </para>
  33   </refsect1>
  34
  35   <refsect1 id='note'>
  36     <title>NOTE</title>
  37     <para>
  38       Systems which do not support concurrent group sets will have the
  39       information from <filename>/etc/group</filename> reported. The user
  40       must use <command>newgrp</command> or <command>sg</command> to change
  41       their current real and effective group ID.
  42     </para>
  43   </refsect1>
  44
  45   <refsect1 id='files'>
  46     <title>FILES</title>
  47     <variablelist>
  48       <varlistentry>
  49         <term><filename>/etc/group</filename></term>
  50         <listitem>
  51           <para>Group account information.</para>
  52         </listitem>
  53       </varlistentry>
  54     </variablelist>
  55   </refsect1>
  56
  57   <refsect1 id='see_also'>
  58     <title>SEE ALSO</title>
  59     <para>
  60       <citerefentry>
  61         <refentrytitle>newgrp</refentrytitle><manvolnum>1</manvolnum>
  62       </citerefentry>,
  63       <citerefentry>
  64         <refentrytitle>getgid</refentrytitle><manvolnum>2</manvolnum>
  65       </citerefentry>,
  66       <citerefentry>
  67         <refentrytitle>getgroups</refentrytitle><manvolnum>2</manvolnum>
  68       </citerefentry>,
  69       <citerefentry>
  70         <refentrytitle>getuid</refentrytitle><manvolnum>2</manvolnum>
  71       </citerefentry>.
  72     </para>
  73   </refsect1>
  74 </refentry>