umount - desmontar sistemas de arquivos
SINTAXE
umount -a [-dflnrv] [-t fstype] [-O option...]
umount [-dflnrv] {diretório|dispositivo}
umount -h|-V
DESCRIÇÃO
O comando umount desmonta os sistemas de arquivos especificados da hierarquia de arquivos. Um sistema de arquivos é especificado fornecendo o diretório onde ele foi montado. Fornecer o dispositivo especial onde o sistema de arquivos reside também pode funcionar, mas está obsoleto, principalmente porque falhará caso este dispositivo tenha sido montado em mais de um diretório.
Observe que um sistema de arquivos não pode ser desmontado quando está "ocupado" - por exemplo, quando há arquivos abertos nele, ou quando algum processo tem seu diretório de trabalho lá, ou quando um arquivo de swap nele está em uso. O processo ofensor pode até ser o próprio umount - ele abre libc, e libc, por sua vez, pode abrir arquivos de localidade, por exemplo. Uma desmontagem "lazy" evita este problema, mas pode introduzir outros problemas. Veja a descrição da opção --lazy abaixo.
OPÇÕES
-a, --all
Todos os sistemas de arquivos descritos em /proc/self/mountinfo (ou no /etc/mtab descontinuado) são desmontados, exceto os sistemas de arquivos proc, devfs, devpts, sysfs, rpc_pipefs e nfsd. Esta lista de sistemas de arquivos pode ser substituída pela opção --types umount.
-A, --all-targets
Desmontar todos os pontos de montagem no namespace de montagem atual para o sistema de arquivos especificado. O sistema de arquivos pode ser especificado por um dos pontos de montagem ou o nome do dispositivo (ou UUID, etc.). Quando esta opção é usada em conjunto com --recursive, então todas as montagens aninhadas dentro do sistema de arquivos são recursivamente desmontadas. Esta opção é suportada apenas em sistemas onde /etc/mtab é um link simbólico para /proc/mounts.
-c, --no-canonicalize
Não canonicalizar caminhos. A canonicalização de caminhos é baseada nos chamados de sistema stat(2) e readlink(2). Estes chamados de sistema podem travar em alguns casos (por exemplo, em NFS se o servidor não estiver disponível). A opção deve ser usada com o caminho canônico para o ponto de montagem.
Esta opção é ignorada silenciosamente pelo umount para usuários não-root.
Para mais detalhes sobre esta opção, veja a página de manual mount(8). Observe que umount não passa esta opção para os helpers /sbin/umount.type.
-d, --detach-loop
Quando o dispositivo desmontado era um dispositivo de loop, também libere este dispositivo de loop. Esta opção é desnecessária para dispositivos inicializados por mount(8), neste caso, a funcionalidade "autoclear" é habilitada por padrão.
--fake
Faz com que tudo seja feito, exceto a execução real do chamado de sistema ou do helper umount; isso "simula" a desmontagem do sistema de arquivos. Pode ser usado para remover entradas do /etc/mtab descontinuado que foram desmontadas anteriormente com a opção -n.
-f, --force
Força uma desmontagem (no caso de um sistema NFS inatingível).
Observe que esta opção não garante que o comando umount não trave. É altamente recomendável usar caminhos absolutos sem links simbólicos para evitar chamadas de sistema readlink(2) e stat(2) em NFS inacessíveis durante o comando umount.
-i, --internal-only
Não chame o helper /sbin/umount.filesystem, mesmo que ele exista. Por padrão, um programa helper é chamado se existir.
-l, --lazy
Desmontagem lenta. Desanexe o sistema de arquivos da hierarquia de arquivos agora e limpe todas as referências a este sistema de arquivos assim que ele não estiver mais ocupado.
Uma reinicialização do sistema seria esperada em um futuro próximo se você for usar esta opção para um sistema de arquivos de rede ou sistema de arquivos local com submntagens. O caso de uso recomendado para umount -l é evitar travamentos durante o desligamento devido a um compartilhamento de rede inacessível, onde um umount normal travaria devido a um servidor inativo ou uma partição de rede. Remontagens do compartilhamento não serão possíveis.
-N, --namespace ns
Execute o comando umount no namespace de montagem especificado por ns. ns é o PID de um processo em execução nesse namespace ou um arquivo especial que representa esse namespace.
O umount alterna para o namespace quando lê /etc/fstab, grava em /etc/mtab (ou grava em /run/mount) e chama o sistema de chamada umount(2); caso contrário, ele é executado no namespace original. Isso significa que o namespace de montagem de destino não precisa conter bibliotecas ou outros requisitos necessários para executar o comando umount(2).
Consulte mount\_namespaces(7) para obter mais informações.
-n, --no-mtab
Desmonte sem gravar em /etc/mtab.
-O, --test-opts option...
Desmonte apenas os sistemas de arquivos que têm a opção especificada definida em /etc/fstab. Mais de uma opção pode ser especificada em uma lista separada por vírgulas. Cada opção pode ser prefixada com "no" para indicar que nenhuma ação deve ser tomada para essa opção.
-q, --quiet
Suprima as mensagens de erro "não montado".
-R, --recursive
Desmonte recursivamente cada diretório especificado. A recursão para cada diretório será interrompida se qualquer operação de desmontagem na cadeia falhar por qualquer motivo. O relacionamento entre os pontos de montagem é determinado pelas entradas em /proc/self/mountinfo. O sistema de arquivos deve ser especificado pelo caminho do ponto de montagem; a desmontagem recursiva pelo nome do dispositivo (ou UUID) não é suportada. A partir da versão 2.37, ele também desmonta todos os sistemas de arquivos sobrepostos (mais sistemas de arquivos no mesmo ponto de montagem).
-r, --read-only
Quando uma desmontagem falhar, tente remontar o sistema de arquivos como somente leitura.
-t, --types type...
Indique que as ações devem ser tomadas apenas em sistemas de arquivos do tipo especificado. Mais de um tipo pode ser especificado em uma lista separada por vírgulas. A lista de tipos de sistemas de arquivos pode ser prefixada com "no" para indicar que nenhuma ação deve ser tomada para todos os tipos mencionados. Observe que o umount lê informações sobre os sistemas de arquivos montados do kernel (/proc/mounts) e os nomes dos sistemas de arquivos podem ser diferentes dos nomes dos sistemas de arquivos usados em /etc/fstab (por exemplo, "nfs4" vs. "nfs").
-v, --verbose
Modo detalhado.
-h, --help
Exibe o texto de ajuda e sai.
-V, --version
Exibe a versão e sai.
DESMONTAGEM POR USUÁRIOS NÃO SUPERUSUÁRIOS
Normalmente, apenas o superusuário pode desmontar sistemas de arquivos. No entanto, quando /fstab contém a opção user em uma linha, qualquer pessoa pode desmontar o sistema de arquivos correspondente. Para obter mais detalhes, consulte a página do manual mount(8).
Desde a versão 2.34, o comando umount pode ser usado para realizar a operação de desmontagem também para sistemas de arquivos FUSE, se a tabela de montagem do kernel contiver o ID do usuário. Neste caso, a opção user= no arquivo /etc/fstab não é necessária.
Desde a versão 2.35, o comando umount não é interrompido quando as permissões do usuário são inadequadas de acordo com as regras de segurança internas do libmount. Ele desativa as permissões suid e continua como um usuário comum não-root. Isso pode ser usado para suportar casos de uso onde as permissões de root não são necessárias (por exemplo, sistemas de arquivos FUSE, namespaces de usuário, etc.).
DISPOSITIVO LOOP
O comando umount irá automaticamente desmontar o dispositivo loop previamente inicializado pelo comando mount(8), independentemente de /etc/mtab.
Neste caso, o dispositivo é inicializado com a flag "autoclear" (veja a saída de losetup(8) para mais detalhes), caso contrário, é necessário usar a opção --detach-loop ou chamar losetup -d device. O recurso autoclear é suportado desde o Linux 2.6.25.
Observe que, desde o kernel v3.7, o Linux usa a "destruição de dispositivo lenta". O sistema simplesmente marca o dispositivo loop com a flag autoclear e o destrói posteriormente. Se você precisar esperar pela remoção completa do dispositivo loop, chame udevadm settle após umount.
CÓDIGO DE SAÍDA
O comando umount possui os seguintes códigos de saída (os bits podem ser combinados com OR):
0 sucesso
1 invocação ou permissões incorretas
2 erro do sistema (falta de memória, não é possível criar um fork, não há mais dispositivos loop)
4 erro interno de montagem
8 interrupção do usuário
16 problemas ao gravar ou bloquear `/etc/mtab`
32 falha na montagem
64 algumas desmontagens tiveram sucesso
O comando umount -a retorna 0 (todas tiveram sucesso), 32 (todas falharam) ou 64 (algumas falharam, algumas tiveram sucesso).
126 falha ao executar o programa auxiliar de desmontagem externo `/sbin/umount.<type>` (desde util-linux v2.41)
AUXILIARES EXTERNOS
A sintaxe dos auxiliares de desmontagem externos é:
umount.suffix {directory|device} [-flnrv] [-N namespace] [-t type.subtype]
onde suffix é o tipo de sistema de arquivos (ou o valor de um marcador `uhelper=` ou `helper=` no arquivo mtab). A opção `-t` pode ser usada para sistemas de arquivos que possuem suporte a subtipo. Por exemplo:
umount.fuse -t fuse.sshfs
Um marcador `uhelper=something` (auxiliar não privilegiado) pode aparecer no arquivo `/etc/mtab` quando usuários comuns precisam ser capazes de desmontar um ponto de montagem que não está definido em `/etc/fstab` (por exemplo, para um dispositivo que foi montado por `udisks(1)`).
Um marcador `helper=type` no arquivo mtab irá redirecionar todas as solicitações de desmontagem para o auxiliar `/sbin/umount.type`, independentemente do UID.
Observe que /etc/mtab está atualmente obsoleto e as opções helper= e outras opções de montagem do espaço do usuário são mantidas pelo libmount.
O valor do código de saída do auxiliar é retornado como o código de saída de umount(8). O valor 126 é usado se o programa auxiliar de montagem for encontrado, mas a função execl() falhar.
AMBIENTE
LIBMOUNT_FSTAB=<path>
substitui o local padrão do arquivo fstab (ignorado para suid)
LIBMOUNT_DEBUG=all
habilita a saída de depuração do libmount
ARQUIVOS
/etc/mtab
tabela de sistemas de arquivos montados (obsoleto e geralmente substituído por um link simbólico para /proc/mounts)
/etc/fstab
tabela de sistemas de arquivos conhecidos
/proc/self/mountinfo
tabela de sistemas de arquivos montados gerada pelo kernel.
HISTÓRICO
Um comando umount apareceu na Versão 6 do AT&T UNIX.
VER TAMBÉM
umount(2), losetup(8), mount_namespaces(7), mount(8)
RELATANDO BUGS
Para relatar bugs, use o rastreador de problemas [https://github.com/util-linux/util-linux/issues].
DISPONIBILIDADE
O comando umount faz parte do pacote util-linux, que pode ser baixado do Linux Kernel Archive [https://www.kernel.org/pub/linux/utils/util-linux/].