snap - Ferramenta para interagir com snaps
SINOPSIS
snap [OPÇÕES]
DESCRIÇÃO
O comando snap permite instalar, configurar, atualizar e remover snaps. Snaps são pacotes que funcionam em muitas distribuições Linux diferentes, permitindo a entrega e operação seguras dos aplicativos e utilitários mais recentes.
OPÇÕES
Opções de aplicativo
COMANDOS
abort
Aborta uma alteração pendente
O comando abort tenta abortar uma alteração que ainda tem tarefas pendentes.
Uso: snap [OPÇÕES] abort [OPÇÕES-abort]
--last Seleciona a última alteração do tipo especificado (instalar, atualizar, remover, tentar, atualização automática, etc.). Uma
interrogação no final do tipo significa não fazer nada (em vez de retornar um erro)
se nenhuma alteração do tipo especificado for encontrada. Observe que a interrogação pode precisar ser protegida
do shell.
ack
Adiciona uma afirmação ao sistema
O comando ack tenta adicionar uma afirmação ao banco de dados de afirmações do sistema.
A afirmação também pode ser uma versão mais recente de uma afirmação pré-existente que a substituirá.
Para ter sucesso, a afirmação deve ser válida, sua assinatura verificada com uma chave pública conhecida e a afirmação consistente com sua condição prévia no banco de dados.
alias
Configura um alias manual
O comando alias cria um alias para o aplicativo snap especificado com o alias fornecido.
Depois que este alias manual é configurado, o comando de aplicativo respectivo pode ser invocado usando apenas o alias.
Uso: snap [OPÇÕES] alias [OPÇÕES-alias]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
aliases
Lista os aliases no sistema
O comando aliases lista todos os aliases disponíveis no sistema e seu status.
$ snap aliases <snap>
Lista apenas os aliases definidos pelo snap especificado.
changes
Lista as alterações do sistema
O comando changes exibe um resumo das alterações do sistema realizadas recentemente.
Uso: snap [OPÇÕES] changes [OPÇÕES-changes]
--abs-time
Exibe horários absolutos (no formato RFC 3339). Caso contrário, exibe horários relativos até 60 dias, então YYYY-MM-DD.
check-snapshot
Verifica um snapshot
O comando check-snapshot verifica os dados do usuário, do sistema e da configuração dos snaps incluídos no snapshot especificado.
A operação de verificação executa a mesma verificação de integridade de dados que é realizada quando um snapshot é restaurado.
Por padrão, este comando verifica todos os dados em um snapshot. Alternativamente, você pode especificar os dados de quais snaps verificar, ou para quais usuários, ou uma combinação destes.
Se um snap estiver incluído em uma operação check-snapshot, excluir seus dados de sistema e configuração da verificação não é possível no momento. Essa restrição pode ser removida no futuro.
Uso: snap [OPÇÕES] check-snapshot [OPÇÕES check-snapshot]
--no-wait
Não aguarde a conclusão da operação, apenas imprima o ID da alteração.
--users
Verifique os dados apenas de usuários específicos (separados por vírgula) (padrão: todos os usuários)
components
Liste os componentes disponíveis e instalados para os snaps instalados.
O comando components exibe um resumo dos componentes que estão instalados e disponíveis para o conjunto de snaps atualmente instalados.
Os componentes para snaps específicos instalados podem ser consultados fornecendo nomes de snaps como argumentos posicionais.
connect
Conecte um plugue a um slot.
O comando connect conecta um plugue a um slot. Ele pode ser chamado das seguintes maneiras:
$ snap connect <snap>:<plugue> <snap>:<slot>
Conecta o plugue fornecido ao slot fornecido.
$ snap connect <snap>:<plugue> <snap>
Conecta o plugue específico ao único slot no snap fornecido que corresponde à interface conectada. Se existir mais de um slot potencial, o comando falha.
$ snap connect <snap>:<plugue>
Conecta o plugue fornecido ao slot no snap core com um nome correspondente ao nome do plugue.
Uso: snap [OPÇÕES] connect [OPÇÕES connect]
--no-wait
Não aguarde a conclusão da operação, apenas imprima o ID da alteração.
connections
Liste as conexões de interface.
O comando connections lista as conexões entre plugues e slots no sistema.
A menos que <snap> seja fornecido, a listagem é para plugues e slots conectados para todos os snaps no sistema. Neste modo, passe --all para também listar plugues e slots não conectados.
$ snap connections <snap>
Lista os plugues e slots conectados e não conectados para o snap especificado.
Uso: snap [OPÇÕES] connections [OPÇÕES connections]
--all Mostre plugues e slots conectados e não conectados.
create-cohort
Crie chaves de coorte para um conjunto de snaps.
O comando create-cohort cria um conjunto de chaves de coorte para um determinado conjunto de snaps.
Uma coorte é uma visualização ou instantâneo do "mapa de canais" de um snap em um determinado momento, que fixa o conjunto de revisões para o snap, dadas outras restrições (por exemplo, canal ou arquitetura). A coorte é então identificada por uma chave opaca por snap que funciona em diferentes sistemas. As instalações ou atualizações do snap usando uma determinada chave de coorte usariam uma revisão fixa por até 90 dias, após o qual um novo conjunto de revisões seria fixado sob a mesma chave de coorte e um novo período de 90 dias seria iniciado.
debug
Execute comandos de depuração.
O comando debug contém uma seleção de subcomandos adicionais.
Os comandos de depuração podem ser removidos sem aviso prévio e podem não funcionar em sistemas não de desenvolvimento.
debug api
Execute uma consulta bruta para a API do snapd.
Execute uma consulta bruta para a API do snapd. Entradas complexas podem ser lidas de stdin, enquanto a saída é impressa em stdout. Veja exemplos abaixo:
Liste todos os snaps: $ snap debug api /v2/snaps
Encontre snaps com o nome foo: $ snap debug api '/v2/find?name=foo'
Solicite a atualização do snap 'some-snap': $ echo '{"action": "refresh"}' | snap debug api -X POST \ -H 'Content-Type: application/json' /v2/snaps/some-snap
Uso: debug api [api-OPTIONS]
--snap-socket
Usar o socket de acesso do snap
-H, --header
Definir cabeçalho (pode ser repetido várias vezes), o tipo e o valor do cabeçalho são separados por ': '
-X, --request
Método HTTP a ser usado (o padrão é GET)
--fail
Falhar em caso de erros de requisição
debug confinement
Imprimir o modo de confinamento em que o sistema opera
O comando confinement imprimirá o modo de confinamento (estrito, parcial ou nenhum) em que o sistema opera.
debug connectivity
Verificar o status da conectividade de rede
O comando connectivity verifica a conectividade de rede do snapd.
debug execution
Obter informações sobre os aspectos de execução dos comandos da cadeia de ferramentas snap
Exibir informações de depuração sobre os aspectos da execução da cadeia de ferramentas snap, como reexecução,
localização das ferramentas, etc.
debug execution apparmor
Mostrar apparmor
debug execution internal-tool
Mostrar informações de execução da ferramenta interna
debug execution snap
Mostrar informações de execução do snap
debug features
Obter a lista completa de tags de recursos
Exibir a saída JSON que contém a lista completa de tags de recursos presentes no snapd
e no snap. As tags de recursos são uma coleção de dados que descrevem caminhos de código significativos
dentro do snapd, incluindo tarefas, alterações, interfaces,
pontos finais, comandos snap
e funções de ajuda de garantia.
debug lsm
(interno) obter informações de status sobre LSMs
(interno) obter informações de status sobre LSMs
debug migrate-home
Migrar o diretório dos snaps para \~/Snap.
Migrar o diretório dos snaps para \~/Snap.
Uso: debug migrate-home [migrate-home-OPTIONS]
--no-wait
debug paths
Imprimir os caminhos do sistema
O comando paths imprime a lista de caminhos detectados e usados pelo snapd.
debug refresh-app-awareness
(interno) listar os detalhes do refresh-app-awareness
(interno) listar os detalhes do refresh-app-awareness
Uso: debug refresh-app-awareness [refresh-app-awareness-OPTIONS]
--unicode <padrão: "auto">
debug sandbox-features
Imprimir os recursos da sandbox disponíveis no sistema
O comando sandbox imprime as tags que descrevem os recursos dos componentes individuais da sandbox usados pelo
snapd em um determinado sistema.
Uso: debug sandbox-features [sandbox-features-OPTIONS]
--required
Garantir que o backend:recurso fornecido esteja disponível
debug seeding
Obter detalhes de seeding e preseeding
Obter detalhes de seeding e preseeding
Uso: debug seeding [seeding-OPTIONS]
--unicode <padrão: "auto">
debug stacktraces
Obter os rastreamentos de pilha de todas as goroutines do snapd
Obter os rastreamentos de pilha de todas as goroutines do snapd.
debug state
Inspecionar um arquivo de estado do snapd.
Inspecionar um arquivo de estado do snapd, ignorando a API do snapd.
Uso: debug state [state-OPTIONS]
--abs-time
Exibir horários absolutos (no formato RFC 3339). Caso contrário, exibir horários relativos até 60
dias, então YYYY-MM-DD.
--changes
Listar todas as alterações
--task ID da tarefa a ser inspecionada
--change
ID da alteração a ser inspecionada
--check
Verificar a consistência da alteração
--connections
Listar todas as conexões
--connection
Mostrar detalhes das conexões correspondentes (snap ou snap:plug, snap:slot ou snap:plug-or-slot)
--is-seeded
Exibir o status de seeding (verdadeiro ou falso)
--dot Saída Dot (graphviz)
--no-hold
Omitir tarefas no estado 'Hold' na saída de alterações
debug timings
Obter os tempos de execução das tarefas de uma alteração
O comando timings exibe detalhes sobre o tempo que cada tarefa leva para ser executada.
Uso: debug timings [timings-OPTIONS]
--last Selecionar a última alteração do tipo fornecido (install, refresh, remove, try, auto-refresh, etc.). Um ponto de interrogação no final do tipo significa não fazer nada (em vez de retornar um erro) se nenhuma alteração do tipo fornecido for encontrada. Observe que o ponto de interrogação pode precisar ser protegido do shell.
--ensure
Mostrar os tempos de execução para uma alteração relacionada à atividade Ensure fornecida (um de: auto-refresh, become-operational, refresh-catalogs, refresh-hints, seed)
--all Mostrar os tempos de execução para todas as execuções da atividade Ensure ou de inicialização fornecida, não apenas a mais recente
--startup
Mostrar os tempos de execução para a inicialização do subsistema fornecido (um de: load-state, ifacemgr)
--verbose
Mostrar mais informações
debug validate-seed
Validar seed do snap
Validar a correção do seed do snap localizado no diretório que contém o arquivo seed.yaml.
disable
Desabilitar um snap no sistema
O comando disable desabilita um snap. Os binários e serviços do snap não estarão mais disponíveis, mas todos os dados ainda estarão disponíveis e o snap poderá ser facilmente habilitado novamente.
Uso: snap [OPTIONS] disable [disable-OPTIONS]
--no-wait
Não esperar que a operação seja concluída, mas apenas imprimir o ID da alteração.
disconnect
Desconectar um plug de um slot
O comando disconnect desconecta um plug de um slot. Ele pode ser chamado das seguintes maneiras:
$ snap disconnect <snap>:<plug> <snap>:<slot>
Desconecta o plug específico do slot específico.
$ snap disconnect <snap>:<slot ou plug>
Desconecta tudo do plug ou slot fornecido. O nome do snap pode ser omitido para o snap core.
Quando uma conexão automática é desconectada manualmente, seu estado desconectado é mantido após uma atualização do snap. A flag --forget pode ser adicionada ao comando disconnect para redefinir esse comportamento e, consequentemente, reativar uma reconexão automática após uma atualização do snap.
Uso: snap [OPTIONS] disconnect [disconnect-OPTIONS]
--no-wait
Não esperar que a operação seja concluída, mas apenas imprimir o ID da alteração.
--forget
Esquecer o estado memorizado sobre a conexão fornecida.
download
Baixar o snap fornecido
O comando download baixa o snap, os componentes e suas declarações de suporte para o diretório atual com as extensões de arquivo .snap, .comp e .assert, respectivamente.
Uso: snap [OPTIONS] download [download-OPTIONS]
--channel
Usar este canal em vez de stable
--edge Instalar a partir do canal edge
--beta Instalar a partir do canal beta
--candidate
Instalar a partir do canal candidate
--stable
Instalar a partir do canal stable
--revision
Baixar a revisão fornecida de um snap. Ao baixar componentes, baixar os componentes associados à revisão do snap fornecida.
--basename
Use este basename para os arquivos de snap, componente e assertion (o padrão é <snap>_<revisão>)
--target-directory
Baixe para este diretório (o padrão é o diretório atual)
--only-components
Baixe apenas os componentes especificados, não o snap
--cohort
Baixe do cohort especificado
enable
Habilita um snap no sistema
O comando enable habilita um snap que foi desabilitado anteriormente.
Uso: snap [OPTIONS] enable [enable-OPTIONS]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
export-snapshot
Exporta um snapshot
Exporte um snapshot para o arquivo especificado.
find
Encontre pacotes para instalar
O comando find consulta a loja para pacotes disponíveis.
Com a flag --private, que exige que o usuário esteja conectado à loja (veja 'snap help login'), ele pesquisa snaps privados aos quais o usuário tem acesso de desenvolvedor, seja diretamente ou através do recurso de colaboração da loja.
Uma marca de seleção verde (dado o suporte a cores e Unicode) após o nome do editor indica que o editor foi verificado.
Uso: snap [OPTIONS] find [find-OPTIONS]
Aliases: search
--private
Pesquise snaps privados.
--narrow
Pesquise apenas snaps em "stable".
--section [="show-all-sections-please"] <default: "no-section-specified">
Restrinja a pesquisa a uma seção especificada.
--color <default: "auto">
Use um pouco de cor para destacar algumas coisas.
--unicode <default: "auto">
Use um pouco de Unicode para melhorar a legibilidade.
forget
Exclui um snapshot
O comando forget exclui um snapshot. Esta operação não pode ser desfeita.
Um snapshot contém arquivos para os dados do usuário, sistema e configuração de cada snap incluído no snapshot.
Por padrão, este comando exclui todos os dados em um snapshot. Alternativamente, você pode especificar os dados de quais snaps excluir.
Uso: snap [OPTIONS] forget [forget-OPTIONS]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
get
Imprime opções de configuração
O comando get imprime opções de configuração para o snap fornecido.
$ snap get snap-name username
frank
Se vários nomes de opções forem fornecidos, os valores correspondentes serão retornados:
$ snap get snap-name username password
Key Value
username frank
password ...
Valores aninhados podem ser recuperados através de um caminho pontilhado:
$ snap get snap-name author.name
frank
Uso: snap [OPTIONS] get [get-OPTIONS]
-t Tipagem estrita com nulos e strings entre aspas
-d Sempre retorne o documento, mesmo com uma única chave
-l Sempre retorne a lista, mesmo com uma única chave
help
Mostra ajuda sobre um comando
O comando help exibe informações sobre os comandos do snap.
Uso: snap [OPTIONS] help [help-OPTIONS]
--all Mostra um breve resumo de todos os comandos
import-snapshot
Importa um snapshot
Importe um conjunto de snapshot exportado para o sistema. O snapshot é importado com um novo ID de snapshot e pode ser restaurado usando o comando restore.
Uso: snap [OPÇÕES] import-snapshot [OPÇÕES de import-snapshot]
--abs-time
info
Exibe informações detalhadas sobre snaps
O comando info exibe informações detalhadas sobre snaps.
Os snaps podem ser especificados por nome ou por caminho; os nomes são procurados tanto na loja quanto nos snaps instalados; os caminhos podem se referir a um arquivo .snap ou a um diretório que contém um snap descompactado adequado para snap try (um exemplo disso seria o diretório prime que o snapcraft produz).
Uso: snap [OPÇÕES] info [OPÇÕES de info]
--color <padrão: "auto">
Use um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Use um pouco de Unicode para melhorar a legibilidade.
--abs-time
Exibe horários absolutos (no formato RFC 3339). Caso contrário, exibe horários relativos até 60 dias, depois YYYY-MM-DD.
--verbose
Inclui mais detalhes sobre o snap (notas expandidas, base, etc.)
install
Instala snaps no sistema
O comando install instala os snaps especificados no sistema.
Para instalar várias instâncias do mesmo snap, adicione um sublinhado e um identificador exclusivo (para cada instância) ao nome de um snap.
As instâncias paralelas são instaladas com --unaliased passado implicitamente para evitar conflitos com instalações existentes. Esse comportamento pode ser alterado passando --prefer, o que habilitará todos os aliases do snap especificado em preferência aos aliases conflitantes de outros snaps, cujos aliases automáticos serão desabilitados e os aliases manuais serão removidos.
Sem opções adicionais, os snaps são instalados rastreando o canal estável, com confinamento de segurança rigoroso. Todos os canais disponíveis de um snap são listados em sua saída snap info.
Quando --revision é usado, uma atualização posterior geralmente desfaz a substituição da revisão, retornando o snap para a revisão atual do canal que está sendo rastreado.
Use --name para definir o nome da instância ao instalar a partir de um arquivo snap.
Uso: snap [OPÇÕES] install [OPÇÕES de install]
--color <padrão: "auto">
Use um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Use um pouco de Unicode para melhorar a legibilidade.
--no-wait
Não espere que a operação termine, mas apenas imprima o ID da alteração.
--channel
Use este canal em vez de estável
--edge
Instale a partir do canal edge
--beta
Instale a partir do canal beta
--candidate
Instale a partir do canal candidate
--stable
Instale a partir do canal estável
--devmode
Coloque o snap no modo de desenvolvimento e desative o confinamento de segurança
--jailmode
Coloque o snap no modo de confinamento forçado
--classic
Coloque o snap no modo clássico e desative o confinamento de segurança
--revision
Instale a revisão especificada de um snap
--dangerous
Instale o arquivo snap especificado, mesmo que não haja assinaturas pré-reconhecidas para ele, o que significa que não foi verificado e pode ser perigoso (--devmode implica isso)
--unaliased
Instale o snap especificado sem habilitar seus aliases automáticos
--prefer
Ativa todos os aliases do snap fornecido, dando-lhes preferência em relação aos aliases conflitantes de outros snaps
--name
Instala o arquivo do snap sob o nome de instância fornecido
--cohort
Instala o snap no grupo fornecido
--ignore-validation
Ignora a validação de outros snaps que impedem a instalação
--transaction <padrão: "per-snap">
Realiza uma transação por snap ou uma para todos os snaps especificados
--quota-group
Adiciona o snap a um grupo de cotas durante a instalação
interface
Exibe detalhes das interfaces do snap
O comando interface exibe detalhes das interfaces do snap.
Se nenhum nome de interface for fornecido, uma lista de nomes de interface com pelo menos uma conexão será exibida, ou uma lista de todas as interfaces se --all for fornecido.
Uso: snap [OPÇÕES] interface [OPÇÕES da interface]
--attrs
Exibe os atributos da interface
--all
Inclui interfaces não utilizadas
known
Exibe as asserções conhecidas do tipo fornecido
O comando known exibe as asserções conhecidas do tipo fornecido. Se forem fornecidos pares header=value após o tipo de asserção, as asserções exibidas também devem ter os cabeçalhos especificados correspondendo aos valores fornecidos.
Uso: snap [OPÇÕES] known [OPÇÕES do known]
--remote
Consulta a loja para obter a asserção, via snapd, se possível
--direct
Consulta a loja para obter a asserção, sem tentar usar o snapd
list
Lista os snaps instalados
O comando list exibe um resumo dos snaps instalados no sistema atual.
Uma marca de seleção verde (dado suporte a cores e Unicode) após o nome do publicador indica que o publicador foi verificado.
Uso: snap [OPÇÕES] list [OPÇÕES da lista]
--all
Exibe todas as revisões
--color <padrão: "auto">
Usa um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Usa um pouco de Unicode para melhorar a legibilidade.
login
Autentica no snapd e na loja
O comando login autentica o usuário no snapd e na loja e salva as credenciais no arquivo ~/.snap/auth.json. A comunicação posterior com o snapd será feita usando essas credenciais.
Não é necessário fazer login para interagir com o snapd. Fazer login, no entanto, permite interações sem sudo, bem como alguns recursos voltados para desenvolvedores, conforme detalhado na ajuda dos comandos find, install e refresh.
Uma conta pode ser criada em https://login.ubuntu.com
logout
Sai do snapd e da loja
O comando logout desloga o usuário atual do snapd e da loja.
logs
Recupera os logs dos serviços
O comando logs recupera os logs dos serviços fornecidos e os exibe em ordem cronológica.
Uso: snap [OPÇÕES] logs [OPÇÕES dos logs]
--abs-time
Exibe os horários absolutos (no formato RFC 3339). Caso contrário, exibe os horários relativos até 60 dias e, em seguida, AAAA-MM-DD.
-n <padrão: "10">
Exibe apenas o número de linhas fornecido ou 'all'.
-f
Aguarda novas linhas e as imprime à medida que chegam.
model
Obtém o modelo ativo deste dispositivo
O comando model retorna as informações da asserção do modelo ativo para este dispositivo.
Por padrão, apenas as informações essenciais de identificação do modelo são incluídas na saída, mas isso pode ser expandido para incluir todos os cabeçalhos não-meta de uma declaração.
A saída detalhada é apresentada em um formato estruturado, semelhante ao YAML.
Da mesma forma, a declaração serial ativa pode ser usada para a saída em vez da declaração do modelo.
Uso: snap [OPÇÕES] model [opções-do-modelo]
--abs-time
Exibe os horários absolutos (no formato RFC 3339). Caso contrário, exibe os horários relativos até 60 dias e, em seguida, AAAA-MM-DD.
--color <padrão: "auto">
Use um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Use um pouco de Unicode para melhorar a legibilidade.
--serial
Imprime a declaração serial em vez da declaração do modelo.
--verbose
Imprime todos os campos de declaração específicos.
--assertion
Imprime a declaração bruta.
okay
Reconhece os avisos
O comando okay reconhece os avisos listados com 'snap warnings'.
Uma vez reconhecido, um aviso não aparecerá novamente, a menos que ocorra novamente e tenha se passado tempo suficiente.
pack
Empacota o diretório fornecido como um snap
O comando pack empacota o snap-dir fornecido como um snap e grava o resultado no target-dir. Se o target-dir for omitido, o resultado será gravado no diretório atual. Se tanto o source-dir quanto o target-dir forem omitidos, o comando pack empacota o diretório atual.
O nome de arquivo padrão para um snap pode ser derivado inteiramente do seu snap.yaml, mas em algumas situações é mais simples para um script fornecer o nome do arquivo. Nesses casos, --filename pode ser fornecido para substituir o padrão. Se este nome de arquivo não for absoluto, ele será considerado relativo ao targetdir.
Quando usado com --check-skeleton, pack verifica apenas se o snap-dir contém metadados snap válidos e gera um erro caso contrário. Os comandos de aplicativo listados no arquivo de metadados snap, mas que aparecem com bits de permissão incorretos, resultam em um erro. Os comandos ausentes do snap-dir são listados nas mensagens de diagnóstico.
Uso: snap [OPÇÕES] pack [opções-do-pack]
--check-skeleton
Valida apenas os metadados do snap-dir
--filename
Saída para este nome de arquivo
--compression
Compressão a ser usada (por exemplo, xz ou lzo)
prefer
Habilita aliases de um snap, desabilitando quaisquer aliases conflitantes
O comando prefer habilita todos os aliases do snap fornecido em preferência aos aliases conflitantes de outros snaps, cujos aliases serão desabilitados (ou removidos, para os manuais).
Uso: snap [OPÇÕES] prefer [opções-do-prefer]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
prepare-image
Prepara uma imagem de dispositivo
O comando prepare-image executa alguns dos passos necessários para criar imagens de dispositivo.
Para imagens core, ele não é invocado diretamente, mas geralmente via ubuntu-image.
Para preparar imagens clássicas, ele suporta um modo --classic
Uso: snap [OPÇÕES] prepare-image [opções-do-prepare-image]
--classic
Habilita o modo clássico para preparar uma imagem de modelo clássico
--preseed
Preseed (UC20+ apenas)
--preseed-sign-key
Nome da chave a ser usada para assinar a declaração de preconfiguração, caso contrário, usa a chave padrão.
--apparmor-features-dir
Caminho opcional para o diretório de recursos do kernel AppArmor (apenas UC20+).
--sysfs-overlay
Overlay sysfs opcional a ser usado ao executar as etapas de preconfiguração.
--arch
Especifica uma arquitetura para snaps para --classic quando o modelo não o faz.
--channel
O canal a ser usado.
--snap <snap>[=<channel>]
Inclui o snap fornecido da loja ou de um arquivo local e/ou especifica o canal a ser seguido para o snap fornecido.
--comp <snap>+<comp>
Inclui o componente fornecido da loja ou de um arquivo local.
--revisions
Especifica um arquivo seeds.manifest referenciando as revisões exatas dos snaps fornecidos que devem ser instalados.
--write-revisions [="./seed.manifest"]
Escreve um arquivo de manifesto contendo referências às revisões exatas dos snaps usados para a imagem. Um caminho para o manifesto é opcional.
--validation
Controla se as validações devem ser ignoradas ou aplicadas (padrão: ignorar).
--allow-snapd-kernel-mismatch
Se uma incompatibilidade entre as versões do snap snapd e snapd no kernel é permitida.
--assert <filename>
Inclui a declaração do arquivo local.
quota
Mostra o grupo de cotas de um conjunto de snaps.
O comando quota mostra informações sobre um grupo de cotas, incluindo o conjunto de snaps e quaisquer subgrupos que ele contém, bem como suas restrições de recursos e o uso atual desses recursos restritos.
quotas
Mostra grupos de cotas.
O comando quotas mostra todos os grupos de cotas.
reboot
Reinicia no sistema e modo selecionados.
O comando reboot reinicia o sistema em um modo específico do sistema de recuperação selecionado.
Quando chamado sem um rótulo de sistema e sem um modo, ele simplesmente acionará uma reinicialização normal.
Quando chamado sem um rótulo, o sistema atual será usado para o modo "run". O padrão sistema de recuperação será usado para os modos "recover", "factory-reset" e "install".
Observe que o modo "run" está disponível apenas para o sistema atual.
Uso: snap [OPÇÕES] reboot [OPÇÕES de reinicialização]
--run
Inicializa no modo run.
--install
Inicializa no modo install.
--recover
Inicializa no modo recover.
--factory-reset
Inicializa no modo factory-reset.
recovery
Lista os sistemas de recuperação disponíveis.
O comando recovery lista os sistemas de recuperação disponíveis.
Com --show-keys, ele exibe as chaves de recuperação que podem ser usadas para desbloquear as partições criptografadas se o desbloqueio automático específico do dispositivo não funcionar.
Uso: snap [OPÇÕES] recovery [OPÇÕES de recuperação]
--color <padrão: "auto">
Use um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Use um pouco de Unicode para melhorar a legibilidade.
--show-keys
Mostra as chaves de recuperação (se disponíveis) para desbloquear as partições criptografadas.
refresh
Atualiza os snaps no sistema.
O comando refresh atualiza os snaps especificados ou todos os snaps no sistema, caso nenhum seja especificado.
Sem mais opções, os snaps são atualizados para a revisão atual do canal em que estão rastreando, preservando suas opções de confinamento. Todos os canais disponíveis de um snap são listados em sua saída 'snap info'.
Quando --revision é usado, uma atualização posterior geralmente desfaz a substituição da revisão.
^ old (--hold) é usado para adiar as atualizações de snap refresh para todos os snaps quando nenhum snap é especificado, ou para os snaps especificados.
Quando nenhum snap é especificado, --hold é eficaz apenas em atualizações automáticas e não bloqueará solicitações de atualização gerais de snap refresh ou solicitações de snap específicas de snap refresh target-snap.
Quando os snaps são especificados, --hold é eficaz tanto em suas atualizações automáticas quanto em solicitações de atualização gerais de snap refresh. No entanto, as solicitações de snap específicas de snap refresh target-snap permanecem desbloqueadas e serão executadas.
Uso: `snap [OPTIONS] refresh [refresh-OPTIONS]`
`--color <default: "auto">`
Use um pouco de cor para destacar algumas coisas.
`--unicode <default: "auto">`
Use um pouco de Unicode para melhorar a legibilidade.
`--abs-time`
Exiba horários absolutos (no formato RFC 3339). Caso contrário, exiba horários relativos até 60 dias e, em seguida, AAAA-MM-DD.
`--no-wait`
Não espere que a operação seja concluída, mas apenas imprima o ID da alteração.
`--channel`
Use este canal em vez de estável.
`--edge`
Instale a partir do canal `edge`.
`--beta`
Instale a partir do canal `beta`.
`--candidate`
Instale a partir do canal `candidate`.
`--stable`
Instale a partir do canal `stable`.
`--devmode`
Coloque o snap no modo de desenvolvimento e desative o confinamento de segurança.
`--jailmode`
Coloque o snap no modo de confinamento reforçado.
`--classic`
Coloque o snap no modo clássico e desative o confinamento de segurança.
`--amend`
Permita uma tentativa de atualização em um snap desconhecido na loja.
`--revision`
Atualize para a revisão especificada.
`--cohort`
Atualize o snap para o grupo especificado.
`--leave-cohort`
Atualize o snap para fora de seu grupo.
`--list`
Mostre as novas versões dos snaps que seriam atualizados com a próxima atualização.
`--time`
Mostre informações de atualização automática, mas não execute uma atualização.
`--ignore-validation`
Ignore a validação por outros snaps que bloqueiam a atualização.
`--transaction <default: "per-snap">`
Tenha uma transação por snap ou uma para todos os snaps especificados.
`--hold [="forever"]`
Mantenha as atualizações por uma duração especificada (ou para sempre, se nenhum valor for especificado).
`--unhold`
Remova a retenção de atualização.
^ emodel
Remodele este dispositivo.
O comando remodel altera a declaração do modelo do dispositivo, seja para uma nova revisão ou para um modelo totalmente novo.
No processo, ele aplica quaisquer alterações implícitas ao dispositivo: novos snaps obrigatórios, novo kernel ou gadget, etc.
Snaps e declarações são baixados da loja, a menos que sejam fornecidos como arquivos locais especificados pelas opções --snap e --assertion. Se estiver usando essas opções, espera-se que todos os snaps e declarações necessários sejam fornecidos localmente; caso contrário, a remodelação falhará.
Uso: `snap [OPTIONS] remodel [remodel-OPTIONS]`
`--no-wait`
Não espere que a operação seja concluída, mas apenas imprima o ID da alteração.
`--snap`
Use um ou mais snaps disponíveis localmente.
`--assertion`
Use um ou mais arquivos de declaração disponíveis localmente.
--offline
Use apenas snaps e asserções pré-instalados e fornecidos localmente. Fornecer quaisquer snaps ou asserções localmente implica em --offline.
remove
Remove snaps do sistema
O comando remove remove a instância de snap especificada do sistema.
Por padrão, todas as revisões do snap são removidas, incluindo seus dados e o diretório de dados comum. Quando uma opção --revision é passada, apenas a revisão especificada é removida.
A menos que os snapshots automáticos sejam desativados, um snapshot de todos os dados do snap é salvo após a remoção, que fica disponível para restauração futura com snap restore. A opção --purge desativa a criação automática de snapshots.
Uso: snap [OPTIONS] remove [remove-OPTIONS]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
--revision
Remova apenas a revisão especificada
--purge
Remova o snap sem salvar um snapshot de seus dados
--terminate
Termine os processos em execução associados a um snap antes da remoção
remove-quota
Remova o grupo de cotas
O comando remove-quota remove o grupo de cotas fornecido.
Atualmente, apenas grupos de cotas sem subgrupos podem ser removidos. Para remover um grupo de cotas com subgrupos, os subgrupos devem primeiro ser removidos até que não haja mais subgrupos para o grupo e, em seguida, o próprio grupo pode ser removido.
Uso: snap [OPTIONS] remove-quota [remove-quota-OPTIONS]
--no-wait
restart
Reinicie os serviços
O comando restart reinicia os serviços fornecidos.
Se a opção --reload for fornecida, para cada serviço cujo aplicativo tenha um comando de recarga, uma recarga é executada em vez de uma reinicialização.
Uso: snap [OPTIONS] restart [restart-OPTIONS]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
--system
A operação deve afetar apenas os serviços do sistema.
--user A operação deve afetar apenas os serviços do usuário para o usuário atual.
--users
Se fornecido e definido como 'all', a operação deve afetar os serviços para todos os usuários.
--reload
Se o serviço tiver um comando de recarga, use-o em vez de reiniciá-lo.
restore
Restaure um snapshot
O comando restore substitui os dados atuais do usuário, do sistema e da configuração dos snaps incluídos pelos dados correspondentes do snapshot especificado.
Por padrão, este comando restaura todos os dados em um snapshot. Alternativamente, você pode especificar os dados de quais snaps restaurar, ou para quais usuários, ou uma combinação disso.
Se um snap estiver incluído em uma operação de restauração, excluir seus dados do sistema e configuração da restauração não é possível no momento. Esta restrição pode ser removida no futuro.
Uso: snap [OPTIONS] restore [restore-OPTIONS]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
--users
Restaure os dados apenas de usuários específicos (separados por vírgulas) (padrão: todos os usuários)
revert
Reverte o snap fornecido para o estado anterior
O comando revert reverte o snap fornecido para o estado anterior ao último atualização. Isso reativará a revisão anterior do snap e usará os dados originais associados a essa revisão, descartando quaisquer alterações de dados que foram feitas pela última revisão. Como exceção, os dados que o snap escolhe explicitamente compartilhar entre as revisões não são afetados pelo processo de reversão.
Uso: snap [OPÇÕES] revert [OPÇÕES-de-revert]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
--devmode
Coloque o snap no modo de desenvolvimento e desative o confinamento de segurança.
--jailmode
Coloque o snap no modo de confinamento reforçado.
--classic
Coloque o snap no modo clássico e desative o confinamento de segurança.
--revision
Reverta para a revisão especificada.
run
Execute o comando snap fornecido.
O comando `run` executa o comando snap fornecido com o confinamento e o ambiente corretos.
Uso: snap [OPÇÕES] run [OPÇÕES-de-run] <NOME-DO-SNAP>.<NOME-DO-APP> [<ARGUMENTO-DO-APP-SNAP>...]
--shell
Execute um shell em vez do comando (útil para depuração).
--debug-log
Habilite o registro de depuração durante as fases iniciais de inicialização do snap.
--strace [="with-strace"] <padrão: "no-strace">
Execute o comando sob o strace (útil para depuração). Opções extras do strace podem ser especificadas aqui. Passe --raw para os helpers iniciais do snap.
--gdbserver [=":0"] <padrão: "no-gdbserver">
Execute o comando com o gdbserver.
--trace-exec
Exiba os dados de tempo das chamadas exec.
save
Salve um instantâneo dos dados atuais.
O comando `save` cria um instantâneo dos dados atuais do usuário, sistema e configuração para os snaps especificados.
Por padrão, este comando salva os dados de todos os snaps para todos os usuários. Alternativamente, você pode especificar os dados de quais snaps salvar, ou para quais usuários, ou uma combinação de ambos.
Se um snap estiver incluído em uma operação de salvamento, excluir seus dados de sistema e configuração do instantâneo não é possível no momento. Esta restrição poderá ser removida no futuro.
Uso: snap [OPÇÕES] save [OPÇÕES-de-save]
--no-wait
Não aguarde a conclusão da operação, mas apenas imprima o ID da alteração.
--abs-time
Exiba os horários absolutos (no formato RFC 3339). Caso contrário, exiba horários relativos curtos.
--users
Instantâneo dos dados apenas de usuários específicos (separados por vírgulas) (padrão: todos os usuários).
saved
Liste os instantâneos armazenados atualmente.
O comando `saved` exibe uma lista de instantâneos que foram criados anteriormente com o comando `save`.
Uso: snap [OPÇÕES] saved [OPÇÕES-de-saved]
--abs-time
Exiba os horários absolutos (no formato RFC 3339). Caso contrário, exiba horários relativos curtos.
--id
Mostre apenas um instantâneo específico.
services
Consulte o status dos serviços.
O comando `services` lista informações sobre os serviços especificados ou sobre os serviços em todos os snaps atualmente instalados.
Se executado como usuário root, a coluna 'Startup' de qualquer serviço de usuário indicará se ele está habilitado globalmente (ou seja, `systemctl is-enabled`). Para visualizar o status real de 'Startup'|'Current' dos serviços de usuário para o próprio usuário root, `--user` pode ser fornecido.
Se executado como um usuário não root, o status 'Startup'|'Current' dos serviços do usuário será o status atual para o usuário que invocou o comando. Para visualizar o status de habilitação global dos serviços do usuário, use a opção --global.
Uso: snap [OPÇÕES] services [OPÇÕES-services]
-g, --global
Mostra o status de habilitação global para os serviços do usuário, em vez do status para o usuário atual.
-u, --user
Mostra o status atual dos serviços do usuário, em vez do status de habilitação global.
set
Altera as opções de configuração.
O comando set altera as opções de configuração fornecidas, conforme solicitado.
$ snap set snap-name username=frank password=$PASSWORD
Todas as alterações de configuração são persistidas de uma só vez e somente após o retorno bem-sucedido do hook de configuração do snap.
Valores aninhados podem ser modificados por meio de um caminho pontilhado:
$ snap set snap-name author.name=frank
Uma opção de configuração pode ser removida com o caractere de exclamação: $ snap set snap-name author!
Uso: snap [OPÇÕES] set [OPÇÕES-set]
--no-wait
Não aguarde a conclusão da operação, apenas imprima o ID da alteração.
-t
Analise o valor estritamente como um documento JSON.
-s
Analise o valor como uma string.
set-quota
Crie ou atualize um grupo de cotas.
O comando set-quota atualiza ou cria um grupo de cotas com o conjunto de snaps especificado.
Um grupo de cotas define limites de recursos para o conjunto de snaps ou serviços de snap que ele contém. Os snaps podem estar em, no máximo, um grupo de cotas, mas os grupos de cotas podem ser aninhados. Os grupos de cotas aninhados estão sujeitos à restrição de que a soma total de cada cota existente em subgrupos não pode exceder a do grupo pai do qual os grupos aninhados fazem parte.
Todos os snaps fornecidos são adicionados ao grupo; para remover um snap de um grupo de cotas, todo o grupo deve ser removido com `remove-quota` e recriado sem o snap. Para remover um subgrupo do grupo de cotas, o subgrupo deve ser removido diretamente com o comando `remove-quota`.
Para definir limites para serviços individuais, um ou mais serviços podem ser colocados em um subgrupo. O snap respectivo para cada serviço deve pertencer ao grupo pai do subgrupo. Esses subgrupos terão as mesmas limitações dos grupos aninhados, o que significa que seu uso combinado de recursos não pode exceder os limites de recursos definidos para o grupo pai. Os subgrupos que contêm serviços não podem ter suas próprias cotas de registro definidas e, em vez disso, herdam automaticamente quaisquer cotas de registro que o grupo de cotas pai possa ter.
O limite de memória para um grupo de cotas pode ser aumentado, mas não diminuído. Para diminuir o limite de memória para um grupo de cotas, todo o grupo deve ser removido com o comando `remove-quota` e recriado com um limite menor. Aumentar o limite de memória para um grupo de cotas não reinicia nenhum dos serviços associados aos snaps no grupo de cotas.
O limite de CPU para um grupo de cotas pode ser aumentado e diminuído após ser definido em um grupo de cotas. O limite de CPU pode ser especificado como uma única porcentagem, o que significa que o grupo de cotas tem permissão para usar uma porcentagem geral dos recursos de CPU. Definir como 50% significa que o grupo de cotas pode usar até 50% de todos os núcleos de CPU no conjunto de CPU permitido. Definir a porcentagem como 2100% significa que o grupo de cotas tem permissão para usar até 100% em dois núcleos de CPU.
O limite do conjunto de CPU para um grupo de cotas pode ser modificado para incluir novos CPUs ou para remover CPUs existentes da cota já definida.
O limite de threads para um grupo de cotas pode ser aumentado, mas não diminuído. Para diminuir o limite de threads para um grupo de cotas, todo o grupo deve ser removido com o comando remove-quota e recriado com um limite menor.
Os limites do diário podem ser aumentados e diminuídos após serem definidos em um grupo. Definir um limite de diário fará com que os snapshots no grupo sejam colocados no mesmo espaço de nomes de diário. Isso afetará o comportamento do comando log.
Novas cotas podem ser definidas em grupos de cotas existentes, mas as cotas existentes não podem ser removidas de um grupo de cotas sem remover e recriar todo o grupo.
Adicionar novos snapshots a um grupo de cotas fará com que todos os serviços não desativados nesse snapshot sejam reiniciados.
Um subgrupo existente não pode ser movido de um pai para outro.
Uso: snap [OPÇÕES] set-quota [OPÇÕES set-quota]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
--memory [=]
Cota de memória
--cpu [=]
Cota de CPU
--cpu-set [=]
Cota de conjunto de CPU
--threads [=]
Cota de threads
--journal-size [=]
Cota de tamanho do diário
--journal-rate-limit [=]
Cota de taxa do diário como
--parent [=]
Grupo de cotas pai
start
Iniciar serviços
O comando start inicia e, opcionalmente, habilita os serviços fornecidos.
Uso: snap [OPÇÕES] start [OPÇÕES start]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
--system
A operação deve afetar apenas os serviços do sistema.
--user A operação deve afetar apenas os serviços do usuário para o usuário atual.
--users
Se fornecido e definido como 'all', a operação deve afetar os serviços para todos os usuários.
--enable
Além de iniciar o serviço agora, organize para que ele seja iniciado na inicialização.
stop
Parar serviços
O comando stop para e, opcionalmente, desabilita os serviços fornecidos.
Uso: snap [OPÇÕES] stop [OPÇÕES stop]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
--system
A operação deve afetar apenas os serviços do sistema.
--user A operação deve afetar apenas os serviços do usuário para o usuário atual.
--users
Se fornecido e definido como 'all', a operação deve afetar os serviços para todos os usuários.
--disable
Além de parar o serviço agora, organize para que ele não seja mais iniciado na inicialização.
switch
Altera o snap para um canal diferente
O comando switch altera o snap fornecido para um canal diferente sem fazer uma atualização. Todos os canais disponíveis de um snap são listados em sua saída snap info.
Uso: snap [OPÇÕES] switch [OPÇÕES switch]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
--channel
Use este canal em vez do canal estável.
--edge
Instale a partir do canal edge.
--beta
Instale a partir do canal beta.
--candidate
Instale a partir do canal candidate.
--stable
Instale a partir do canal estável.
--cohort
Altere o snap para o grupo fornecido.
--leave-cohort
Remova o snap do seu grupo.
tasks
Liste as tarefas de uma alteração.
O comando `tasks` exibe um resumo das tarefas associadas a uma alteração específica.
Uso: snap [OPÇÕES] tasks [OPÇÕES-tasks]
Aliases: change
--abs-time
Exiba horários absolutos (no formato RFC 3339). Caso contrário, exiba horários relativos até 60 dias e, em seguida, AAAA-MM-DD.
--last
Selecione a última alteração do tipo fornecido (install, refresh, remove, try, auto-refresh, etc.). Um ponto de interrogação no final do tipo significa que nada deve ser feito (em vez de retornar um erro) se nenhuma alteração do tipo fornecido for encontrada. Observe que o ponto de interrogação pode precisar ser protegido do shell.
try
Teste um snap descompactado no sistema.
O comando `try` instala um snap descompactado no sistema para fins de teste. O conteúdo do snap descompactado continua a ser usado mesmo após a instalação, portanto, as alterações não relacionadas aos metadados entram em vigor instantaneamente. As alterações de metadados, como as realizadas no arquivo `snap.yaml`, exigirão uma reinstalação para entrarem em vigor.
Se o argumento `snap-dir` for omitido, o comando `try` tentará inferi-lo se o arquivo `snapcraft.yaml` e o diretório `prime` ou o arquivo `meta/snap.yaml` puderem ser encontrados em relação ao diretório de trabalho atual.
Uso: snap [OPÇÕES] try [OPÇÕES-try]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
--devmode
Coloque o snap no modo de desenvolvimento e desative o confinamento de segurança.
--jailmode
Coloque o snap no modo de confinamento forçado.
--classic
Coloque o snap no modo clássico e desative o confinamento de segurança.
unalias
Remova um alias manual ou os aliases de um snap inteiro.
O comando `unalias` remove um único alias se o argumento fornecido for um alias manual ou desativa todos os aliases de um snap, incluindo os manuais, se o argumento for um nome de snap.
Uso: snap [OPÇÕES] unalias [OPÇÕES-unalias]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
unset
Remova as opções de configuração.
O comando `unset` remove as opções de configuração fornecidas.
$ snap unset snap-name name address
Todas as alterações de configuração são persistidas de uma vez e somente após o retorno bem-sucedido do hook de configuração do snap.
Valores aninhados podem ser removidos por meio de um caminho delimitado por pontos:
$ snap unset snap-name user.name
Uso: snap [OPÇÕES] unset [OPÇÕES-unset]
--no-wait
Não espere que a operação termine, apenas imprima o ID da alteração.
validate
Liste ou aplique conjuntos de validação.
O comando `validate` lista ou aplica conjuntos de validação que especificam quais snaps devem ser instalados ou permitidos para serem instalados juntos, opcionalmente restritos a revisões fixas.
Um conjunto de validação pode estar no modo de monitoramento, caso em que suas restrições não são aplicadas, ou no modo de aplicação, caso em que o snapd não permitirá operações que resultariam em snaps que violassem as restrições do conjunto de validação.
Uso: snap [OPÇÕES] validate [opções-validate]
--monitor
Monitora o conjunto de validações fornecido
--enforce
Aplica o conjunto de validações fornecido
--forget
Remove o conjunto de validações fornecido
--refresh
Atualiza ou instala snaps para atender aos conjuntos de validações aplicados
--color <padrão: "auto">
Usa um pouco de cor para destacar algumas coisas.
--unicode <padrão: "auto">
Usa um pouco de Unicode para melhorar a legibilidade.
--no-wait
Não espera que a operação seja concluída, apenas imprime o ID da alteração.
version
Mostra detalhes da versão
O comando version exibe as versões do cliente, servidor e sistema operacional em execução.
wait
Aguarda a configuração
O comando wait aguarda até que uma configuração se torne verdadeira.
warnings
Lista avisos
O comando warnings lista os avisos que foram relatados ao sistema.
Depois que os avisos forem listados com 'snap warnings', 'snap okay' pode ser usado para silenciá-los. Um
aviso que foi silenciado dessa forma não será listado novamente, a menos que ocorra novamente _e_
um período de tempo mínimo tenha passado.
Os avisos expiram automaticamente e, uma vez expirados, são esquecidos.
Uso: snap [OPÇÕES] warnings [opções-warnings]
--abs-time
Exibe horários absolutos (no formato RFC 3339). Caso contrário, exibe horários relativos até 60
dias, depois AAAA-MM-DD.
--unicode <padrão: "auto">
Usa um pouco de Unicode para melhorar a legibilidade.
--all Mostra todos os avisos
--verbose
Mostra mais informações
watch
Observa uma alteração em andamento
O comando watch aguarda a conclusão da alteração fornecida e exibe o progresso (se disponível).
Uso: snap [OPÇÕES] watch [opções-watch]
--last Seleciona a última alteração do tipo fornecido (instalar, atualizar, remover, tentar, atualização automática, etc.). Um
ponto de interrogação no final do tipo significa não fazer nada (em vez de retornar um erro)
se nenhuma alteração do tipo fornecido for encontrada. Observe que o ponto de interrogação pode precisar ser protegido
do shell.
whoami
Mostra o e-mail com o qual o usuário está conectado
O comando whoami mostra o e-mail com o qual o usuário está conectado.
NOTAS
Documentação online
https://docs.snapcraft.io
BUGS
Reporte todos os bugs em https://bugs.launchpad.net/snapd/+filebug