.\" Someone tell emacs that this is an -*- nroff -*- source file. .\" Copyright 1997, 1998, 1999 Guy Maor. .\" Adduser and this manpage are copyright 1995 by Ted Hajek, .\" With much borrowing from the original adduser copyright 1994 by .\" Ian Murdock. .\" This is free software; see the GNU General Public License version .\" 2 or later for copying conditions. There is NO warranty. .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ADDUSER 8 "Versão 3.115" "Debian GNU/Linux" .SH NOME adduser, addgroup \- adiciona um utilizador ou grupo ao sistema .SH SINOPSE \fBadduser\fP [opções] [\-\-home DIRECTÓRIO] [\-\-shell|\-s SHELL] [\-\-no\-create\-home] [\-\-uid ID] [\-\-firstuid ID] [\-\-lastuid ID] [\-\-ingroup GRUPO | \-\-gid ID] [\-\-disabled\-password] [\-\-disabled\-login] [\-\-gecos GECOS] [\-\-add_extra_groups] utilizador .PP \fBadduser\fP \-\-system [opções] [\-\-home DIRECTÓRIO] [\-\-shell SHELL] [\-\-no\-create\-home] [\-\-uid ID] [\-\-group | \-\-ingroup GRUPO | \-\-gid ID] [\-\-disabled\-password] [\-\-disabled\-login] [\-\-gecos GECOS] utilizador .PP \fBaddgroup\fP [opções] [\-\-gid ID] grupo .PP \fBaddgroup\fP \-\-system [opções] [\-\-gid ID] grupo .PP \fBadduser\fP [opções] utilizador grupo .SS "OPÇÕES COMUNS" .br [\-\-quiet] [\-\-debug] [\-\-force\-badname] [\-\-help|\-h] [\-\-version] [\-\-conf FICHEIRO] .SH DESCRIÇÃO .PP \fBadduser\fP e \fBaddgroup\fP adicionam utilizadores e grupos ao sistema de acordo com opções de linha de comandos e informação de configuração em \fI/etc/adduser.conf\fP. Eles são frontends amigáveis para as ferramentas de baixo nível como os programas \fBuseradd,\fP \fBgroupadd\fP e \fBusermod\fP, escolhendo por predefinição valores UID e GID respeitantes da política Debian, criando um directório home com o esqueleto da configuração, executando um script personalizado, e outras funcionalidades. \fBadduser\fP e \fBaddgroup\fP podem ser executados em um de cinco modos: .SS "Adicionar um utilizador normal" Se chamado com um argumento não\-opção e sem as opções \fB\-\-system\fP ou \fB\-\-group\fP, o \fBadduser\fP irá adicionar um utilizador normal. \fBadduser\fP irá escolher o primeiro UID disponível dentro do alcance para utilizadores normais especificado no ficheiro de configuração. O UID pode ser sobreposto com a opção \fB\-\-uid\fP. O alcance especificado no ficheiro de configuração pode ser sobreposto com as opções \fB\-\-firstuid\fP e \fB\-\-lastuid\fP. Por predefinição, cada utilizador em Debian GNU/Linux recebe um grupo correspondente com o mesmo nome. Grupos\-de\-utilizadores permitem que directórios com acesso de escrita para grupos sejam mantidos facilmente ao colocar os utilizadores apropriados no novo grupo, definindo o bit set\-group\-ID no directório, e assegurando que todos os utilizadores usam uma umask de 002. Se esta opção for desligada ao definir \fBUSERGROUPS\fP para \fIno\fP, todos os GIDs de utilizadores são definidos para \fBUSERS_GID\fP. Os grupos principais de utilizadores também podem ser sobrepostos a partir da linha de comandos com as opções \fB\-\-gid\fP ou \fB\-\-ingroup\fP para definir o grupo por id ou nome, respectivamente. Também, utilizadores podem ser adicionados a um ou mais grupos definidos em adduser.conf seja ao definir ADD_EXTRA_GROUPS para 1 em adduser.conf,ou passando \fB\-\-add_extra_groups\fP na linha de comandos. \fBadduser\fP irá criar um título de directório home para \fBDHOME\fP, \fBGROUPHOMES\fP, e \fBLETTERHOMES\fP. O directório home pode ser sobreposto a partir da linha de comandos com a opção \fB\-\-home\fP, e a shell com a opção \fB\-\-shell\fP. O bit set\-group\-ID do directório home é definido se \fBUSERGROUPS\fP for \fIyes\fP, para que quaisquer ficheiros criados no directório home do utilizador tenham o grupo correcto. \fBadduser\fP irá copiar ficheiros de \fBSKEL\fP para o directório home e irá pedir informação do finger (gecos) e uma palavra\-passe. A gecos também pode ser definida com a opção \fB\-\-gecos\fP. Com a opção \fB\-\-disabled\-login\fP, a conta será criada mas irá ficar desactivada até que se defina uma palavra\-passe. A opção \fB\-\-disabled\-password\fP não irá definir uma palavra\-passe, mas o login continua a ser possível (por exemplo com chaves SSH RSA). Se o ficheiro \fB/usr/local/sbin/adduser.local\fP existir, será executado após a conta do utilizador ser definida de modo a fazer quaisquer configurações locais. Os argumentos passados a \fBadduser.local\fP são: .br nome\-de\-utilizador uid gid directório\-home .br A variável de ambiente VERBOSE é definida de acordo com a seguinte regra: .TP 0 se \fB\-\-quiet\fP for especificado .TP 1 se nenhum \fB\-\-quiet\fP nem \fB\-\-debug\fP for especificado .TP 2 se \fB\-\-debug\fP for especificado (O mesmo aplica\-se à variável DEBUG, mas DEBUG está obsoleto e será removido numa versão futura do \fBadduser\fP.) .SS "Adicionar um utilizador de sistema" Se chamado com um argumento não\-opção e a opção \fB\-\-system\fP, o \fBadduser\fP irá adicionar um utilizador de sistema. Se já existir um utilizador com o mesmo nome dentro do alcance uid do sistema (ou, se o uid for especificado e já existir um utilizador com esse uid), o adduser irá terminar com um aviso. Este aviso pode ser suprimido ao adicionar \fB\-\-quiet\fP. \fBadduser\fP irá escolher o primeiro UID disponível do alcance para utilizadores de sistema especificado no ficheiro de configuração (FIRST_SYSTEM_UID e LAST_SYSTEM_UID). Se deseja ter um UID especificado, você pode especificá\-lo usando a opção \fB\-\-uid\fP. Por predefinição, os utilizadores do sistema são colocados no grupo \fBnogroup\fP. Para colocar o novo utilizador de sistema num grupo já existente, use as opções \fB\-\-gid\fP ou \fB\-\-ingroup\fP. Para colocar o novo utilizador de sistema num novo grupo com o mesmo ID. use a opção \fB\-\-group\fP. É criado um directório home pelas mesmas regras como para utilizadores normais. O novo utilizador de sistema irá ter a shell \fI/bin/false\fP (a menos que seja sobreposto pela opção \fB\-\-shell\fP), e irá ter os logins desactivados. Os ficheiros de configuração esqueleto não são copiados. .SS "Adicionar um grupo de utilizadores" Se o \fBadduser\fP for chamado com a opção \fB\-\-group\fP e sem a opção \fB\-\-system\fP, ou se \fBaddgroup\fP for chamado respectivamente, será adicionado um grupo de utilizadores. Será escolhido um GID do alcance especificado para GIDS de sistema no ficheiro de configuração (FIRST_GID, LAST_GID). Para sobrepor esse mecanismo você pode fornecer o GID usando a opção \fB\-\-gid\fP. O grupo é criado sem nenhum utilizador. .SS "Adicionar um grupo de sistema" Se \fBaddgroup\fP for chamado com a opção \fB\-\-system\fP, será adicionado um grupo de sistema. Será escolhido um GID do alcance especificado para GIDS de sistema no ficheiro de configuração (FIRST_SYSTEM_GID, LAST_SYSTEM_GID). Para sobrepor esse mecanismo você pode fornecer o GID usando a opção \fB\-\-gid\fP. O grupo é criado sem nenhum utilizador. .SS "Adicionar um utilizador existente a um grupo existente" Se chamado com dois argumentos não\-opção, \fBadduser\fP irá adicionar um utilizador existente a um grupo existente. .SH OPÇÕES .TP \fB\-\-conf FICHEIRO\fP Usa FICHEIRO em vez de \fI/etc/adduser.conf\fP. .TP \fB\-\-disabled\-login\fP Não executa o passwd para definir a palavra\-passe. O utilizador não poderá usar a sua conta até que a palavra\-passe seja definida. .TP \fB\-\-disabled\-password\fP Tal como \-\-disabled\-login, mas os logins continuam a ser possíveis (por exemplo usando chaves SSH RSA) mas não usando autenticação por palavra\-passe. .TP \fB\-\-force\-badname\fP Por predefinição, os nomes de utilizadores e grupos são verificados contra uma expressão regular configurável \fBNAME_REGEX\fP especificada no ficheiro de configuração. Esta opção força \fBadduser\fP e \fBaddgroup\fP a aplicar apenas uma verificação fraca para validade do nome. \fBNAME_REGEX\fP está descrito em \fBadduser.conf\fP(5). .TP \fB\-\-gecos GECOS\fP Define o campo gecos para a entrada nova gerada. O \fBadduser\fP não irá pedir informação finger se esta opção for fornecida. .TP \fB\-\-gid ID\fP Ao criar um grupo, esta opção força o novo groupid ao número fornecido. Ao criar um utilizador, esta opção irá colocar o utilizador nesse grupo. .TP \fB\-\-group\fP Quando combinado com \fB\-\-system\fP, é criado um grupo com o mesmo nome e ID que o utilizador de sistema. Se não for combinado com \fB\-\-system\fP, é criado um grupo com o nome fornecido. Esta é a acção predefinida se o programa for invocado como \fBaddgroup\fP. .TP \fB\-\-help\fP Mostra instruções breves. .TP \fB\-\-home DIR\fP Usa DIR como o directório home do utilizador, em vez da predefinição especificada pelo ficheiro de configuração. Se o directório não existir, ele é criado e são copiados os ficheiros de esqueleto. .TP \fB\-\-shell SHELL\fP Usa SHELL como a shell de login do utilizador, em vez da predefinição especificada pelo ficheiro de configuração. .TP \fB\-\-ingroup GROUP\fP Adiciona o novo utilizador ao GRUPO em vez a um grupo\-de\-utilizador ou ao grupo predefinido por \fBUSERS_GID\fP no ficheiro de configuração. Isto afecta o grupo principal dos utilizadores. Para adicionar grupos adicionais, veja a opção \fBadd_extra_groups\fP. .TP \fB\-\-no\-create\-home\fP Não cria o directório home, mesmo que este não exista. .TP \fB\-\-quiet\fP Suprime mensagens informativas, apenas mostra avisos e erros. .TP \fB\-\-debug\fP É detalhado, muito útil de deseja descobrir um problema com o adduser. .TP \fB\-\-system\fP Cria um utilizador ou grupo de sistema. .TP \fB\-\-uid ID\fP Força o novo id de utilizador a ser o número fornecido. O \fBadduser\fP irá falhar se o id de utilizador já estiver atribuído. .TP \fB\-\-firstuid ID\fP Sobrepõe o primeiro uid no alcance de onde o uid é escolhido (sobrepõe \fBFIRST_UID\fP especificado no ficheiro de configuração). .TP \fB\-\-lastuid ID\fP Sobrepõe o último uid no alcance de onde o uid é escolhido a partir de ( \fBLAST_UID\fP ) .TP \fB\-\-add_extra_groups\fP Adiciona o novo utilizador aos grupos extra definidos no ficheiro de configuração. .TP \fB\-\-version\fP Mostra informação de versão e copyright. .SH "VALORES DE SAÍDA" .TP \fB0\fP O utilizador existe como especificado. Isto pode ter 2 causas: O utilizador foi criado pelo adduser ou o utilizador já estava presente no sistema antes do adduser ser invocado. Se o adduser retornava 0, invocar o adduser uma segunda vez com os mesmo parâmetros irá retornar 0 como antes. .TP \fB1\fP A criação do utilizador ou grupo falhou porque já estava presente com outro UID/GID diferente do especificado. O nome de utilizador ou nome de grupo foi rejeitado devido a um desencontro com as expressões regulares configuradas, veja adduser.conf(5). Adduser foi abortado por um sinal. .br Ou por muitas razões ainda não documentadas que são então escritas na consola. Você deve considerar remover a opção \fB\-\-quiet\fP para tornar o adduser mais detalhado. .SH FICHEIROS .TP /etc/adduser.conf Ficheiro de configuração predefinida para o adduser e addgroup .TP /usr/local/sbin/adduser.local Adições personalizadas opcionais .SH "VEJA TAMBÉM" \fBadduser.conf\fP(5), \fBdeluser\fP(8), \fBgroupadd\fP(8), \fBuseradd\fP(8), \fBusermod\fP(8), Debian Policy 9.2.2. .SH COPYRIGHT Copyright (C) 1997, 1998, 1999 Guy Maor. Modificações por Roland Bauerschmidt e Marc Haber. Patches adicionais por Joerg Hoh e Stephen Gran. .br Copyright (C) 1995 Ted Hajek, com muita coisa emprestada do \fBadduser\fP original de Debian .br Copyright (C) 1994 Ian Murdock. \fBadduser\fP é software livre, veja a GNU General Public Licence versão 2 ou posterior para condições de cópia. \fINão\fP há garantia.