"grp" --- O banco de dados de grupos
************************************

======================================================================

Este módulo fornece acesso ao banco de dados de grupos Unix. Ele está
disponível em todas as versões do Unix.

Disponibilidade: Unix, not Emscripten, not WASI.

As entradas do banco de dados de grupos são relatadas como um objeto
tupla ou similar, cujos atributos correspondem aos membros da
estrutura "group" (campo Atributo abaixo, consulte "<grp.h>"):

+---------+-------------+-----------------------------------+
| Índice  | Atributo    | Significado                       |
|=========|=============|===================================|
| 0       | gr_name     | o nome do grupo                   |
+---------+-------------+-----------------------------------+
| 1       | gr_passwd   | a senha do grupo (criptografada); |
|         |             | geralmente vazia                  |
+---------+-------------+-----------------------------------+
| 2       | gr_gid      | O ID numérico do grupo            |
+---------+-------------+-----------------------------------+
| 3       | gr_mem      | todos os nomes de usuários dos    |
|         |             | membros do grupo                  |
+---------+-------------+-----------------------------------+

O gid é um inteiro, nome e senha são strings, e a lista de membros é
uma lista de strings. (Observe que a maioria dos usuários não são
listados explicitamente como membros do grupo em que estão, de acordo
com o banco de dados de senhas. Verifique ambos os bancos de dados
para obter informações completas sobre associação. Observe também que
um "gr_name" que começa com "+" ou "-" provavelmente é uma referência
YP/NIS e pode não ser acessível via "getgrnam()" ou "getgrgid()".)

Isto define os seguintes itens

grp.getgrgid(id)

   Retorna a entrada do banco de dados de grupos para o ID do grupo
   numérico fornecido. "KeyError" é levantada se a entrada solicitada
   não puder ser encontrada.

   Alterado na versão 3.10: "TypeError" é levantada para argumentos
   não inteiros, como pontos flutuantes ou strings.

grp.getgrnam(name)

   Retorna a entrada do banco de dados de grupos para o nome do grupo
   fornecido. "KeyError" é levantada se a entrada solicitada não puder
   ser encontrada.

grp.getgrall()

   Retorna uma lista de todas as entradas de grupo disponíveis, em
   ordem arbitrária.

Ver também:

  Módulo "pwd"
     Uma interface para o banco de dados de usuários, semelhante a
     esta.

  Módulo "spwd"
     Uma interface para o banco de dados de senhas shadow, similar a
     esta.
