guestmount - Online na nuvem

PROGRAMA:

NOME

guestmount - Monte um sistema de arquivos convidado no host usando FUSE e libguestfs

SINOPSE

guestmount [--options] -a disk.img -m device [--ro] ponto de montagem

guestmount [--options] -a disk.img -i [--ro] ponto de montagem

guestmount [--options] -d Guest -i [--ro] ponto de montagem

ATENÇÃO

Usando "guestmount" no modo de gravação em máquinas virtuais ativas ou simultaneamente com outro disco
ferramentas de edição podem ser perigosas, podendo causar danos ao disco. A máquina virtual
deve ser encerrado antes de usar este comando, e as imagens de disco não devem ser editadas
simultaneamente.

Use o --ro (somente leitura) opção para usar "guestmount" com segurança se a imagem de disco ou virtual
a máquina pode estar ativa. Você pode ver resultados estranhos ou inconsistentes se estiver executando
simultaneamente com outras alterações, mas com esta opção, você não corre o risco de corromper o disco.

DESCRIÇÃO

O programa guestmount pode ser usado para montar sistemas de arquivos de máquinas virtuais e outros discos
imagens no host. Ele usa libguestfs para acessar o sistema de arquivos convidado e FUSE (o
"sistema de arquivos no espaço do usuário") para fazer com que apareça como um dispositivo montável.

Junto com outras opções, você deve fornecer pelo menos um dispositivo (-a opção) ou libvirt
domínio (-d opção), e pelo menos um ponto de montagem (-m opção) ou use a -i inspeção
opção ou o --viver opção. Como isso funciona é melhor explicado no peixe convidado(1)
página de manual ou olhando os exemplos abaixo.

O FUSE permite montar sistemas de arquivos como não-root. O ponto de montagem deve ser propriedade de você, e o
sistema de arquivos não será visível para qualquer outro usuário, a menos que você faça certas
mudanças de configuração para /etc/fuse.conf. Para desmontar o sistema de arquivos, use o
desmontagem de convidado(1) comando.

EXEMPLOS

Para um convidado típico do Windows que tem seu sistema de arquivos principal na primeira partição:

guestmount -a windows.img -m / dev / sda1 --ro / mnt

Para um convidado Linux típico que tem um / Bota sistema de arquivos na primeira partição, e o
sistema de arquivos raiz em um volume lógico:

guestmount -a linux.img -m / dev / VG / LV -m / dev / sda1:/ Bota --ro / mnt

Para fazer com que o libguestfs detecte pontos de montagem de convidados para você:

guestmount -a convidado.img -i --ro / mnt

Para um convidado libvirt chamado "Convidado", você pode fazer:

guestmount -d Convidado -i --ro / mnt

Se você não sabe quais sistemas de arquivos estão contidos em um convidado ou imagem de disco, use
virt-sistemas de arquivos(1) primeiro:

virt-filesystems -d MyGuest

Se você deseja rastrear as chamadas libguestfs, mas sem informações de depuração excessivas, nós
recomendar:

guestmount [...] --trace / mnt

Se você deseja depurar o programa, recomendamos:

guestmount [...] --trace --verbose / mnt

Para desmontar o sistema de arquivos após usá-lo:

desmontagem de convidado / mnt

NOTAS

Outros usuários não podes Vejo da sistema de arquivo by omissão
Se você montar um sistema de arquivos como um usuário (por exemplo, root), então outros usuários não serão capazes de ver
por padrão. A correção é adicionar a opção FUSE "allow_other" ao montar:

sudo guestmount [...] -o permitir_outro / mnt

Possibilitando FUSE
Em algumas distros, pode ser necessário adicionar-se a um grupo especial (por exemplo, "fuse") antes de você
pode usar qualquer sistema de arquivos FUSE. Isso é necessário no Debian e derivados.

Em outras distros, nenhum grupo especial é necessário. Não é necessário no Fedora ou Red Hat
Linux empresarial.

montagem do fusor erro: "Dispositivo or recurso ocupado"
Você pode ver este erro quando outro processo no sistema salta para o ponto de montagem que você
acabou de criar, mantendo-o aberto e impedindo que você o desmonte. O usual
os culpados são vários programas de "indexação" de GUI.

A solução alternativa popular para este problema é repetir o comando "fusermount -u" alguns
vezes até que funcione (desmontagem de convidado(1) faz isso por você). Infelizmente este não é um
correção confiável se (por exemplo) o sistema de arquivos montado for particularmente grande e o
programa intruso particularmente persistente.

Uma correção adequada é usar um ponto de montagem privado, criando um novo namespace de montagem usando o
Específico para Linux clonar(2) /descompartilhar(2) sinalizar "CLONE_NEWNS". Infelizmente no momento isso
requer root e provavelmente também precisaríamos adicioná-lo como um recurso ao guestmount.

Corrida condições possível quando fechando down da da conexão
Quando desmontagem de convidado(1) /montagem do fusor(1) saídas, a montagem do convidado ainda pode estar funcionando e limpando
o ponto de montagem. A imagem do disco não será totalmente finalizada.

Isso significa que scripts como o seguinte têm uma condição de corrida desagradável:

guestmount -a disco.img -i / mnt
# copiar coisas para / mnt
desmontagem de convidado / mnt
# imediatamente tente usar 'disk.img' ** INSEGURO **

A solução é usar o --pid-arquivo opção de gravar o PID de montagem do convidado em um arquivo, então
após a desmontagem do convidado, gire à espera que este PID saia.

guestmount -a disk.img -i --pid-file guestmount.pid / mnt

# ...
# ...

# Salve o PID de guestmount * antes * de chamar guestunmount.
pid = "$ (cat guestmount.pid)"

# Desmonte o sistema de arquivos.
desmontagem de convidado / mnt

timeout = 10

contagem = $ tempo limite
while kill -0 "$ pid" 2> / dev / null && [$ count -gt 0]; Faz
dormir 1
((contar--))
feito
if [$ count -eq 0]; então
echo "$ 0: espera que a montagem do convidado saia falhou após $ timeout segundos"
sair 1
fi

# Agora é seguro usar a imagem de disco.

Observe que se você usar a API "guestfs_mount_local" diretamente (consulte "MOUNT LOCAL" em
convidados(3)) então é muito mais fácil escrever um programa seguro e livre de corridas.

OPÇÕES

-a imagem
--adicionar imagem
Adicione um dispositivo de bloco ou imagem de máquina virtual.

O formato da imagem do disco é detectado automaticamente. Para substituir isso e forçar um
formato particular use o --format = .. opção.

-a URI
--adicionar URI
Adicione um disco remoto. Veja "ADICIONANDO ARMAZENAMENTO REMOTO" em peixe convidado(1).

-c URI
--conectar URI
Quando usado em conjunto com o -d opção, isso especifica o URI libvirt a ser usado.
O padrão é usar a conexão libvirt padrão.

-d domínio-libvirt
--domínio domínio-libvirt
Adicione discos do domínio libvirt nomeado. Se o --ro opção também é usada, então qualquer
O domínio libvirt pode ser usado. No entanto, no modo de gravação, apenas os domínios libvirt que são
desligar pode ser nomeado aqui.

UUIDs de domínio podem ser usados ​​em vez de nomes.

--dir-cache-timeout N
Defina o tempo limite do cache readdir para N segundos, o padrão sendo 60 segundos. O readdir
cache [na verdade, existem vários caches semi-independentes] é preenchido após um
readdir(2) chamar com os atributos stat e extendido dos arquivos no diretório,
antecipando que serão solicitados logo em seguida.

Há também um cache de atributo diferente implementado pelo FUSE (veja a opção FUSE -o
attr_timeout), mas o cache do FUSE não antecipa solicitações futuras, apenas o cache
os que existem.

--echo-keys
Ao solicitar chaves e senhas, o guestfish normalmente desativa o eco para que você
não consigo ver o que você está digitando. Se você não está preocupado com os ataques de Tempestade e
não há mais ninguém na sala. Você pode especificar este sinalizador para ver o que está digitando.

--fd = FD
Especifique um descritor de arquivo pipe ou eventfd. Quando o ponto de montagem estiver pronto para ser usado,
guestmount grava um único byte neste descritor de arquivo. Isso pode ser usado em
Conjunção com --sem garfo para executar o guestmount cativo em outro processo.

--format = raw | qcow2 | ..
--formato
O padrão para o -a opção é detectar automaticamente o formato da imagem do disco. Usando
isso força o formato do disco para -a opções que seguem na linha de comando. Usando
--formato sem nenhum argumento volta para a detecção automática nas próximas -a opções.

Se você tiver imagens de disco de convidado não confiáveis ​​em formato raw, você deve usar esta opção para
especifique o formato do disco. Isso evita um possível problema de segurança com programas maliciosos
convidados (CVE-2010-3851). Veja também "guestfs_add_drive_opts" em convidados(3).

--fuse-ajuda
Exibir ajuda sobre as opções especiais do FUSE (consulte -o abaixo).

--Socorro
Exibe uma breve ajuda e sai.

-i
--inspetor
utilização inspetor virtual(1) código, inspecione os discos à procura de um sistema operacional e
montar sistemas de arquivos como seriam montados na máquina virtual real.

--keys-from-stdin
Leia os parâmetros de chave ou senha de stdin. O padrão é tentar ler
senhas do usuário abrindo / dev / tty.

--viver
Conecte-se a uma máquina virtual ativa. (Experimental, consulte "ANEXAR A DAMÕES EM EXECUÇÃO"
in convidados(3)).

-m dev [: ponto de montagem [: opções [: fstype]]
--montar dev [: ponto de montagem [: opções [: fstype]]]
Monte a partição nomeada ou volume lógico no ponto de montagem fornecido in da convidado (isto
não tem nada a ver com pontos de montagem no host).

Se o ponto de montagem for omitido, o padrão é /. Você tem que montar algo /.

A terceira (e raramente usada) parte do parâmetro de montagem é a lista de opções de montagem
usado para montar o sistema de arquivos subjacente. Se não for fornecido, as opções de montagem
são a string vazia ou "ro" (o último se o --ro sinalizador é usado). Por
especificando as opções de montagem, você sobrescreve esta escolha padrão. Provavelmente o único
tempo que você usaria é para habilitar ACLs e / ou atributos estendidos se o sistema de arquivos
pode apoiá-los:

-m / dev / sda1: /: acl, user_xattr

A quarta parte do parâmetro é o driver do sistema de arquivos a ser usado, como "ext3" ou
"ntfs". Isso raramente é necessário, mas pode ser útil se vários drivers forem válidos para um
sistema de arquivos (por exemplo: "ext2" e "ext3"), ou se libguestfs identificar incorretamente um sistema de arquivos.

--sem garfo
Não daemonize (ou bifurque no fundo).

-n
--sem sincronização
Por padrão, tentamos sincronizar o disco convidado quando o ponto de montagem do FUSE é desmontado.
Se você especificar esta opção, não tentaremos sincronizar o disco. Veja o
discussão de autosync no convidados(3) página de manual.

-o opção
--opção opção
Passe opções extras para o FUSE.

Para obter uma lista de todas as opções extras suportadas pelo FUSE, use o comando abaixo. Observação
que só o FUSÍVEL -o opções podem ser passadas e apenas algumas delas são uma boa ideia.

guestmount --fuse-help

Algumas opções FUSE potencialmente úteis:

-o permitir_outro
Permita que outros usuários vejam o sistema de arquivos.

-o attr_timeout = N
Habilite o cache de atributos por FUSE e defina o tempo limite para N segundos.

-o kernel_cache
Permitir que o kernel armazene os arquivos em cache (reduz o número de leituras que precisam ser feitas
através de convidados(3) API). Isso geralmente é uma boa ideia se você puder pagar o
uso de memória extra.

-o uid = N -o gid = N
Use essas opções para mapear todos os UIDs e GIDs dentro do sistema de arquivos convidado para o
valores escolhidos.

-o use_ino
Preserve os números de inode do sistema de arquivos subjacente.

Sem esta opção, o FUSE cria seus próprios números de inode. O inode numera você
ver em estado(2), "ls -i" etc não são os números de inode do sistema de arquivos subjacente.

Note esta opção é potencialmente perigosa se o sistema de arquivos subjacente consistir em
vários pontos de montagem, como você pode ver números de inode duplicados aparecendo através
FUSÍVEL. O uso desta opção pode confundir alguns softwares.

--pid-arquivo nome do arquivo
Grave o PID do processo de trabalho guestmount em "filename".

-r
--ro
Adicione dispositivos e monte tudo como somente leitura. Também desabilite gravações e faça o disco
aparecem como somente leitura para o FUSE.

Isso é altamente recomendado se você não for editar o disco convidado. Se o convidado
está em execução e esta opção é não fornecido, então há um grande risco de disco
corrupção no hóspede. Tentamos evitar que isso aconteça, mas nem sempre é
possível.

Veja também "ABERTURA DE DISCOS PARA LEITURA E ESCRITA" em peixe convidado(1).

--selinux
Habilite o suporte SELinux para o convidado.

-v
--verbose
Habilite mensagens detalhadas de libguestfs subjacentes.

-V
--versão
Exiba a versão do programa e saia.

-w
--rw
Isso muda o -a, -d e -m opções para que os discos sejam adicionados e as montagens sejam feitas
ler escrever.

Consulte "ABRINDO OS DISCOS PARA LER E ESCREVER" em peixe convidado(1).

-x
--vestígio
Rastreie chamadas libguestfs e entradas em cada função FUSE.

Isso também impede que o daemon bifurque no fundo (veja --sem garfo).

Use guestmount online usando serviços onworks.net