# `grp` — The group database

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

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.