man-pages/pt/man8/adduser.8.html
2021-03-31 01:06:50 +01:00

321 lines
14 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of ADDUSER</TITLE>
</HEAD><BODY>
<H1>ADDUSER</H1>
Section: Maintenance Commands (8)<BR>Updated: Versão 3.118ubuntu2<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NOME</H2>
adduser, addgroup - adiciona um utilizador ou grupo ao sistema
<A NAME="lbAC">&nbsp;</A>
<H2>SINOPSE</H2>
<B>adduser</B> [options] [--home DIR] [--shell SHELL] [--no-create-home] [--uid
ID] [--firstuid ID] [--lastuid ID] [--ingroup GROUP | --gid ID]
[--disabled-password] [--disabled-login] [--gecos GECOS]
[--add_extra_groups] [--encrypt-home] user
<P>
<B>adduser</B> --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
<P>
<B>addgroup</B> [opções] [--gid ID] grupo
<P>
<B>addgroup</B> --system [opções] [--gid ID] grupo
<P>
<B>adduser</B> [opções] utilizador grupo
<A NAME="lbAD">&nbsp;</A>
<H3>OPÇÕES COMUNS</H3>
<BR>
[--quiet] [--debug] [--force-badname] [--help|-h] [--version] [--conf
FICHEIRO]
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIÇÃO</H2>
<P>
<B>adduser</B> e <B>addgroup</B> adicionam utilizadores e grupos ao sistema de
acordo com opções de linha de comandos e informação de configuração em
<I>/etc/adduser.conf</I>. Eles são frontends amigáveis para as ferramentas de
baixo nível como os programas <B>useradd,</B> <B>groupadd</B> e <B>usermod</B>,
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. <B>adduser</B> e
<B>addgroup</B> podem ser executados em um de cinco modos:
<A NAME="lbAF">&nbsp;</A>
<H3>Adicionar um utilizador normal</H3>
Se chamado com um argumento não-opção e sem as opções <B>--system</B> ou
<B>--group</B>, o <B>adduser</B> irá adicionar um utilizador normal.
<P>
<B>adduser</B> 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 <B>--uid</B>.
<P>
O alcance especificado no ficheiro de configuração pode ser sobreposto com
as opções <B>--firstuid</B> e <B>--lastuid</B>.
<P>
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 <B>USERGROUPS</B> para
<I>no</I>, todos os GIDs de utilizadores são definidos para <B>USERS_GID</B>. Os
grupos principais de utilizadores também podem ser sobrepostos a partir da
linha de comandos com as opções <B>--gid</B> ou <B>--ingroup</B> 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 <B>--add_extra_groups</B> na
linha de comandos.
<P>
<B>adduser</B> irá criar um título de directório home para <B>DHOME</B>,
<B>GROUPHOMES</B>, e <B>LETTERHOMES</B>. O directório home pode ser sobreposto a
partir da linha de comandos com a opção <B>--home</B>, e a shell com a opção
<B>--shell</B>. O bit set-group-ID do directório home é definido se
<B>USERGROUPS</B> for <I>yes</I>, para que quaisquer ficheiros criados no directório
home do utilizador tenham o grupo correcto.
<P>
<B>adduser</B> will copy files from <B>SKEL</B> into the home directory and prompt
for finger (gecos) information and a password. The gecos may also be set
with the <B>--gecos</B> option. With the <B>--disabled-login</B> option, the
account will be created but will be disabled until a password is set. The
<B>--disabled-password</B> option will not set a password, but login is still
possible (for example with SSH RSA keys). To set up an encrypted home
directory for the new user, add the <B>--encrypt-home</B> option. For more
information, refer to the -b option of <B><A HREF="/cgi-bin/man/man2html?1+ecryptfs-setup-private">ecryptfs-setup-private</A>(1).</B>
<P>
Se o ficheiro <B>/usr/local/sbin/adduser.local</B> existir, será executado após
a conta do utilizador ser definida de modo a fazer quaisquer configurações
locais. Os argumentos passados a <B>adduser.local</B> 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:
<DL COMPACT>
<DT id="1">0 se <DD>
<B>--quiet</B> for especificado
<DT id="2">1 se nenhum <DD>
<B>--quiet</B> nem <B>--debug</B> for especificado
<DT id="3">2 se <DD>
<B>--debug</B> for especificado
<P>
(O mesmo aplica-se à variável DEBUG, mas DEBUG está obsoleto e será removido
numa versão futura do <B>adduser</B>.)
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>Adicionar um utilizador de sistema</H3>
Se chamado com um argumento não-opção e a opção <B>--system</B>, o <B>adduser</B>
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 <B>--quiet</B>.
<P>
<B>adduser</B> 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 <B>--uid</B>.
<P>
Por predefinição, os utilizadores do sistema são colocados no grupo
<B>nogroup</B>. Para colocar o novo utilizador de sistema num grupo já
existente, use as opções <B>--gid</B> ou <B>--ingroup</B>. Para colocar o novo
utilizador de sistema num novo grupo com o mesmo ID. use a opção <B>--group</B>.
<P>
É criado um directório home pelas mesmas regras como para utilizadores
normais. O novo utilizador de sistema irá ter a shell <I>/usr/sbin/nologin</I>
(a menos que seja sobreposto pela opção <B>--shell</B>), e irá ter os logins
desactivados. Os ficheiros de configuração esqueleto não são copiados.
<A NAME="lbAH">&nbsp;</A>
<H3>Adicionar um grupo de utilizadores</H3>
Se o <B>adduser</B> for chamado com a opção <B>--group</B> e sem a opção
<B>--system</B>, ou se <B>addgroup</B> for chamado respectivamente, será adicionado
um grupo de utilizadores.
<P>
<P>
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 <B>--gid</B>.
<P>
O grupo é criado sem nenhum utilizador.
<A NAME="lbAI">&nbsp;</A>
<H3>Adicionar um grupo de sistema</H3>
Se <B>addgroup</B> for chamado com a opção <B>--system</B>, será adicionado um grupo
de sistema.
<P>
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 <B>--gid</B>.
<P>
O grupo é criado sem nenhum utilizador.
<A NAME="lbAJ">&nbsp;</A>
<H3>Adicionar um utilizador existente a um grupo existente</H3>
Se chamado com dois argumentos não-opção, <B>adduser</B> irá adicionar um
utilizador existente a um grupo existente.
<A NAME="lbAK">&nbsp;</A>
<H2>OPÇÕES</H2>
<DL COMPACT>
<DT id="4"><B>--conf FICHEIRO</B><DD>
Usa FICHEIRO em vez de <I>/etc/adduser.conf</I>.
<DT id="5"><B>--disabled-login</B><DD>
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.
<DT id="6"><B>--disabled-password</B><DD>
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.
<DT id="7"><B>--force-badname</B><DD>
By default, user and group names are checked against the configurable
regular expression <B>NAME_REGEX</B> (or <B>NAME_REGEX_SYSTEM</B> if <B>--system</B> is
specified) specified in the configuration file. This option forces
<B>adduser</B> and <B>addgroup</B> to apply only a weak check for validity of the
name. <B>NAME_REGEX</B> is described in <B><A HREF="/cgi-bin/man/man2html?5+adduser.conf">adduser.conf</A></B>(5).
<DT id="8"><B>--gecos GECOS</B><DD>
Define o campo gecos para a entrada nova gerada. O <B>adduser</B> não irá pedir
informação finger se esta opção for fornecida.
<DT id="9"><B>--gid ID</B><DD>
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.
<DT id="10"><B>--group</B><DD>
Quando combinado com <B>--system</B>, é criado um grupo com o mesmo nome e ID
que o utilizador de sistema. Se não for combinado com <B>--system</B>, é criado
um grupo com o nome fornecido. Esta é a acção predefinida se o programa for
invocado como <B>addgroup</B>.
<DT id="11"><B>--help</B><DD>
Mostra instruções breves.
<DT id="12"><B>--home DIR</B><DD>
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.
<DT id="13"><B>--shell SHELL</B><DD>
Usa SHELL como a shell de login do utilizador, em vez da predefinição
especificada pelo ficheiro de configuração.
<DT id="14"><B>--ingroup GROUP</B><DD>
Adiciona o novo utilizador ao GRUPO em vez a um grupo-de-utilizador ou ao
grupo predefinido por <B>USERS_GID</B> no ficheiro de configuração. Isto afecta
o grupo principal dos utilizadores. Para adicionar grupos adicionais, veja a
opção <B>add_extra_groups</B>.
<DT id="15"><B>--no-create-home</B><DD>
Não cria o directório home, mesmo que este não exista.
<DT id="16"><B>--quiet</B><DD>
Suprime mensagens informativas, apenas mostra avisos e erros.
<DT id="17"><B>--debug</B><DD>
É detalhado, muito útil de deseja descobrir um problema com o adduser.
<DT id="18"><B>--system</B><DD>
Cria um utilizador ou grupo de sistema.
<DT id="19"><B>--uid ID</B><DD>
Força o novo id de utilizador a ser o número fornecido. O <B>adduser</B> irá
falhar se o id de utilizador já estiver atribuído.
<DT id="20"><B>--firstuid ID</B><DD>
Sobrepõe o primeiro uid no alcance de onde o uid é escolhido (sobrepõe
<B>FIRST_UID</B> especificado no ficheiro de configuração).
<DT id="21"><B>--lastuid ID</B><DD>
Sobrepõe o último uid no alcance de onde o uid é escolhido a partir de (
<B>LAST_UID</B> )
<DT id="22"><B>--add_extra_groups</B><DD>
Adiciona o novo utilizador aos grupos extra definidos no ficheiro de
configuração.
<DT id="23"><B>--version</B><DD>
Mostra informação de versão e copyright.
<P>
</DL>
<A NAME="lbAL">&nbsp;</A>
<H2>VALORES DE SAÍDA</H2>
<P>
<DL COMPACT>
<DT id="24"><B>0</B><DD>
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.
<DT id="25"><B>1</B><DD>
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 <A HREF="/cgi-bin/man/man2html?5+adduser.conf">adduser.conf</A>(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 <B>--quiet</B> para tornar o
adduser mais detalhado.
<P>
</DL>
<A NAME="lbAM">&nbsp;</A>
<H2>FICHEIROS</H2>
<DL COMPACT>
<DT id="26">/etc/adduser.conf<DD>
Ficheiro de configuração predefinida para o adduser e addgroup
<DT id="27">/usr/local/sbin/adduser.local<DD>
Adições personalizadas opcionais
<P>
</DL>
<A NAME="lbAN">&nbsp;</A>
<H2>VEJA TAMBÉM</H2>
<B><A HREF="/cgi-bin/man/man2html?5+adduser.conf">adduser.conf</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?8+deluser">deluser</A></B>(8), <B><A HREF="/cgi-bin/man/man2html?8+groupadd">groupadd</A></B>(8), <B><A HREF="/cgi-bin/man/man2html?8+useradd">useradd</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+usermod">usermod</A></B>(8), Debian Policy 9.2.2.
<P>
<A NAME="lbAO">&nbsp;</A>
<H2>COPYRIGHT</H2>
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 <B>adduser</B>
original de Debian
<BR>
Copyright (C) 1994 Ian Murdock. <B>adduser</B> é software livre, veja a GNU
General Public Licence versão 2 ou posterior para condições de cópia. <I>Não</I>
há garantia.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="28"><A HREF="#lbAB">NOME</A><DD>
<DT id="29"><A HREF="#lbAC">SINOPSE</A><DD>
<DL>
<DT id="30"><A HREF="#lbAD">OPÇÕES COMUNS</A><DD>
</DL>
<DT id="31"><A HREF="#lbAE">DESCRIÇÃO</A><DD>
<DL>
<DT id="32"><A HREF="#lbAF">Adicionar um utilizador normal</A><DD>
<DT id="33"><A HREF="#lbAG">Adicionar um utilizador de sistema</A><DD>
<DT id="34"><A HREF="#lbAH">Adicionar um grupo de utilizadores</A><DD>
<DT id="35"><A HREF="#lbAI">Adicionar um grupo de sistema</A><DD>
<DT id="36"><A HREF="#lbAJ">Adicionar um utilizador existente a um grupo existente</A><DD>
</DL>
<DT id="37"><A HREF="#lbAK">OPÇÕES</A><DD>
<DT id="38"><A HREF="#lbAL">VALORES DE SAÍDA</A><DD>
<DT id="39"><A HREF="#lbAM">FICHEIROS</A><DD>
<DT id="40"><A HREF="#lbAN">VEJA TAMBÉM</A><DD>
<DT id="41"><A HREF="#lbAO">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:22 GMT, March 31, 2021
</BODY>
</HTML>