diff --git a/pages.pt_BR/common/at.md b/pages.pt_BR/common/at.md index 33505ce19d..e23d8a3405 100644 --- a/pages.pt_BR/common/at.md +++ b/pages.pt_BR/common/at.md @@ -1,16 +1,24 @@ # at > Ferramenta para o agendamento de comandos. -> O serviço atd (ou atrun) deve estar sendo executado para as atuais execuções. +> Resultados serão enviados para o e-mail dos usuários. > Mais informações: . -- Executa comandos da standard input em 5 minutos (pressionar `Ctrl + D`quando acabar): +- Inicia o daemon `atd`: + +`systemctl start atd` + +- Cria comandos interativamente e executa-os em 5 minutos (pressione ` + D` quando acabar): `at now + 5 minutes` -- Executa um comando da standard input às 10:00 da manhã de hoje: +- Cria comandos interativamente e executa-os no horário específico: -`echo "{{./comando.sh}}" | at 1000` +`at {{hh:mm}}` + +- Executa um comando da `stdin` (standard input) às 10:00 da manhã de hoje: + +`echo "{{comando}}" | at 1000` - Executa comandos de um dado arquivo na próxima terça: diff --git a/pages.pt_BR/common/batch.md b/pages.pt_BR/common/batch.md new file mode 100644 index 0000000000..ab181677ec --- /dev/null +++ b/pages.pt_BR/common/batch.md @@ -0,0 +1,7 @@ +# batch + +> Este comando é um apelido de `at`. + +- Exibe documentação sobre o comando original: + +`tldr at` diff --git a/pages.pt_BR/common/curl.md b/pages.pt_BR/common/curl.md index 81673a6f24..56372b5e07 100644 --- a/pages.pt_BR/common/curl.md +++ b/pages.pt_BR/common/curl.md @@ -1,37 +1,37 @@ # curl -> Transfere dados entre o computador local e um servidor remoto. -> Suporta a maioria dos protocolos de comunicação, incluindo HTTP, FTP e POP3. +> Transfere dados entre o computador local e um servidor. +> Suporta a maioria dos protocolos de comunicação, incluindo HTTP, HTTPS, FTP, SCP, etc. > Mais informações: . -- Descarrega os conteúdos de um URL para um arquivo: +- Faz um pedido HTTP GET e descarrega os conteúdos em `stdout` (saída padrão): -`curl {{http://example.com}} --output {{arquivo}}` +`curl {{https://example.com}}` -- Descarrega um arquivo, gravando o resultado sob o nome do arquivo indicado pelo URL: +- Faz um pedido HTTP GET, segue redirecionamentos ``3xx` e descarrega os cabeçalhos da resposta e conteúdos para `stdout`: -`curl --remote-name {{http://example.com/arquivo}}` +`curl --location --dump-header - {{https://example.com}}` -- Descarrega um arquivo, seguindo redirecionamentos e automaticamente continuando transferências idênticas que tenham sido interrompidas: +- Baixa um arquivo, salvando a saída no arquivo indicado pela URL: -`curl --fail --remote-name --location --continue-at - {{http://example.com/arquivo}}` +`curl --remote-name {{https://example.com/arquivo.zip}}` -- Envia dados codificados por formulário (pedido POST do tipo `application/x-www-form-urlencoded`): +- Envia dados codificados por formulário (pedido POST do tipo `application/x-www-form-urlencoded`). Usa `--data @file_name` ou `--data @'-'` para ler da `stdin`: -`curl --data {{'nome=maria'}} {{http://example.com/formulario}}` +`curl -X POST --data {{'nome=maria'}} {{http://example.com/formulario}}` -- Envia um pedido com um cabeçalho adicional, usando um método HTTP personalizado: +- Envia um pedido com um cabeçalho adicional, usando um método HTTP personalizado e por meio de um proxy (tal como BurpSuite), ignorando certificados autoassinados inseguros: -`curl --header {{'X-Meu-Cabecalho: 123'}} --request {{PUT}} {{http://example.com}}` +`curl -k --proxy {{http://127.0.0.1:8080}} --header {{'Authorization: Bearer token'}} --request {{GET|PUT|POST|DELETE|PATCH|...}} {{https://example.com}}` - Envia dados no formato JSON, especificando o cabeçalho de tipo de conteúdo (content-type) apropriado: -`curl --data {{'{"nome":"maria"}'}} --header {{'Content-Type: application/json'}} {{http://example.com/usuarios/123}}` +`curl --data {{'{"nome":"maria"}'}} --header {{'Content-Type: application/json'}} {{http://example.com/usuarios/1234}}` -- Passa ao pedido o nome de usuário e senha para autenticação no servidor: +- Passa o certificado do cliente e chave para um recurso, pulando a validação do certificado: -`curl --user {{usuario}} {{http://example.com}}` +`curl --cert {{cliente.pem}} --key {{chave.pem}} --insecure {{https://example.com}}` -- Passa ao pedido o certificado do cliente e a chave para um recurso, omitindo a validação do certificado: +- Resolve um hostname para um endereço de IP personalizado, com a saída verbosa (similar a editar o arquivo `/etc/hosts` para resolução de DNS personalizada): -`curl --cert {{client.pem}} --key {{key.pem}} --insecure {{https://example.com}}` +`curl --verbose --resolve {{example.com}}:{{80}}:{{127.0.0.1}} {{http://example.com}}` diff --git a/pages.pt_BR/common/dd.md b/pages.pt_BR/common/dd.md index c765116c29..3a167f35c7 100644 --- a/pages.pt_BR/common/dd.md +++ b/pages.pt_BR/common/dd.md @@ -3,22 +3,22 @@ > Converte e copia um arquivo. > Mais informações: . -- Cria um USB drive bootável a partir de um arquivo isohybrid (como uma `archlinux-xxx.iso`) e mostra o progresso: +- Cria um dispositivo USB inicializável a partir de um arquivo isohybrid (tal como `archlinux-xxx.iso`) e mostra o progresso: -`dd if={{caminho/para/arquivo.iso}} of={{/dev/usb_drive}} status=progress` +`dd if={{caminho/para/arquivo.iso}} of={{/dev/dispositivo_usb}} status=progress` -- Clona um drive para outro drive com 4 MiB block e ignora erros: +- Clona um dispositivo para outro dispositivo com bloco de 4 MiB e descarta escritas antes que o comando termine: -`dd bs=4194304 conv=noerror if={{/dev/drive_fonte}} of={{/dev/drive_destino}}` +`dd bs=4194304 conv=fsync if={{/dev/dispositivo_origem}} of={{/dev/dispositivo_destino}}` -- Gera um arquivo com um número específico de bytes aleatórios utilizando o kernel random driver: +- Gera um arquivo com um número específico de bytes aleatórios utilizando o driver random do kernel: -`dd bs={{100}} count={{1}} if=/dev/urandom of={{caminho/para/arquivo_random}}` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{caminho/para/arquivo_aleatório}}` -- Faz o benchmark da performance de escrita de um disco: +- Faz análise do desempenho da escrita sequencial de um disco: `dd bs={{1024}} count={{1000000}} if=/dev/zero of={{caminho/para/arquivo_1GB}}` -- Gera um backup do sistema em um arquivo IMG e mostra o progresso: +- Cria um backup do sistema, salva-o em arquivo IMG (pode ser restaurado posteriormente trocando `if` e `of`) e mostra o progresso: -`dd if={{/dev/dispositivo_drive}} of={{caminho/para/arquivo.img}} status=progress` +`dd if={{/dev/dispositivo}} of={{caminho/para/arquivo.img}} status=progress` diff --git a/pages.pt_BR/common/docker-images.md b/pages.pt_BR/common/docker-images.md index ebc2030ea9..4bf260875b 100644 --- a/pages.pt_BR/common/docker-images.md +++ b/pages.pt_BR/common/docker-images.md @@ -7,7 +7,7 @@ `docker images` -- Lista todas as imagens Docker incluíndo imagens intermedirárias: +- Lista todas as imagens Docker incluindo imagens intermedirárias: `docker images --all` @@ -22,3 +22,7 @@ - Lista imagens que contenham um substring no seu nome: `docker images "{{*nome*}}"` + +- Classifica imagens pelo tamanho: + +`docker images --format "\{\{.ID\}\}\t\{\{.Size\}\}\t\{\{.Repository\}\}:\{\{.Tag\}\}" | sort -k 2 -h` diff --git a/pages.pt_BR/common/docker-ps.md b/pages.pt_BR/common/docker-ps.md index 9588904da0..3bd9ca56bb 100644 --- a/pages.pt_BR/common/docker-ps.md +++ b/pages.pt_BR/common/docker-ps.md @@ -1,36 +1,36 @@ # docker ps -> Lista os containers Docker. +> Lista os contêineres Docker. > Mais informações: . -- Lista containers Docker em execução: +- Lista contêineres Docker em execução: `docker ps` -- Lista todos containers Docker (em execução e parados): +- Lista todos contêineres Docker (em execução e parados): `docker ps --all` -- Lista os últimos containers criados (incluí todos os estados): +- Lista os últimos contêineres criados (inclui todos os estados): `docker ps --latest` -- Filtra os containers que contém uma substring no seu nome: +- Filtra os contêineres que contêm uma substring no seu nome: -`docker ps --filter="name={{nome}}"` +`docker ps --filter "name={{nome}}"` -- Filtra todos os containers que possuem uma imagem antepassada: +- Filtra todos os contêineres que compartilham uma determinada imagem com um antepassado: `docker ps --filter "ancestor={{imagem}}:{{tag}}"` -- Filtra containers que tenha o código de saída: +- Filtra contêineres que tenham o código de saída: -`docker ps --all --filter="exited={{código}}"` +`docker ps --all --filter "exited={{código}}"` -- Filtra containers por estado (criado, execução, removendo, pausado, finalizado e morto): +- Filtra contêineres por estado (created, running, removing, paused, exited e dead): `docker ps --filter "status={{estado}}"` -- Filtra containers que contenham um volume específico ou montado em um caminho específico: +- Filtra contêineres que montem um volume específico ou tenham um volume montado em um caminho específico: `docker ps --filter "volume={{caminho/para/diretório}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.pt_BR/common/find.md b/pages.pt_BR/common/find.md index ce802236a9..65b70666dd 100644 --- a/pages.pt_BR/common/find.md +++ b/pages.pt_BR/common/find.md @@ -7,11 +7,11 @@ `find {{caminho_raiz}} -name '{{*.ext}}'` -- Procura por arquivos que correspondam a padrões de caminho ou nome específico: +- Procura por arquivos que correspondam a vários padrões específicos de caminho/nome: `find {{caminho_raiz}} -path '{{**/caminho/**/*.ext}}' -or -name '{{*nome*}}'` -- Procura por diretórios que correspondam a um nome específico, sem o uso de case-sensitive: +- Procura por diretórios que correspondam a um nome específico, sem diferenciar maiúsculo de minúsculo: `find {{caminho_raiz}} -type d -iname '{{*nome*}}'` @@ -27,10 +27,10 @@ `find {{caminho_raiz}} -name '{{*.ext}}' -exec {{wc -l}} {} \;` -- Procura por todos os arquivos modificados hoje e passa o resultado para um único comando como argumento: +- Procura por todos os arquivos modificados hoje e passa os resultados para um único comando como argumentos: `find {{caminho_raiz}} -daystart -mtime {{-1}} -exec {{tar -cvf arquivo.tar}} {} \+` -- Procura por arquivos vazios (0 bytes) e os deleta: +- Procura por arquivos vazios (0 byte) ou diretórios e os exclui de forma verbosa: -`find {{caminho_raiz}} -type {{f}} -empty -delete` +`find {{caminho_raiz}} -type {{f|d}} -empty -delete -print` diff --git a/pages.pt_BR/common/git-add.md b/pages.pt_BR/common/git-add.md index 55db95c93d..248d5ba020 100644 --- a/pages.pt_BR/common/git-add.md +++ b/pages.pt_BR/common/git-add.md @@ -9,24 +9,28 @@ - Adiciona todos arquivos (rastreados ou não): -`git add -A` +`git add {{-A|--all}}` + +- Adiciona todos arquivos na pasta atual: + +`git add .` - Adiciona apenas arquivos rastreados: -`git add -u` +`git add {{-u|--update}}` - Adiciona arquivos ignorados: -`git add -f` +`git add {{-f|--force}}` - Interativamente adiciona partes dos arquivo: -`git add -p` +`git add {{-p|--patch}}` - Interativamente adiciona partes de um dado arquivo: -`git add -p {{caminho/para/arquivo}}` +`git add {{-p|--patch}} {{caminho/para/arquivo}}` - Interativamente adiciona arquivos ou partes modificadas: -`git add -i` +`git add {{-i|--interactive}}` diff --git a/pages.pt_BR/common/git-config.md b/pages.pt_BR/common/git-config.md index 824f56eda0..b1d0752399 100644 --- a/pages.pt_BR/common/git-config.md +++ b/pages.pt_BR/common/git-config.md @@ -1,37 +1,37 @@ # git config -> Gerencia configurações customizadadas para repositórios Git. -> Estas configurações podem ser locais (para o repositório corrente) ou globais (para o usuário atual). +> Gerencia configurações personalizadas para repositórios Git. +> Estas configurações podem ser locais (para o repositório atual) ou globais (para o usuário atual). > Mais informações: . -- Lista somente configurações locais (armazenadas no `.git/config` do repositório corrente): +- Define globalmente seu nome ou e-mail (essas informações são necessárias para fazer commit em um repositório e serão incluídas em todos os commits): -`git config --list --local` +`git config --global {{user.name|user.email}} "{{Seu nome|e-mail@example.com}}"` -- Lista somente configurações globais (armazenadas no `~/.gitconfig` por padrão ou no `$XDG_CONFIG_HOME/git/config` se tal arquivo existe): +- Lista configurações locais ou globais: -`git config --list --global` +`git config --list --{{local|global}}` - Lista somente configurações do sistema (armazenadas no `/etc/gitconfig`), e exibe o local do arquivo: `git config --list --system --show-origin` -- Obtém o valor de uma dada variável de configuração: +- Obtém o valor de uma dada configuração: `git config alias.unstage` -- Armazena o valor global de uma dada variável de configuração: +- Define o valor global de uma dada configuração: `git config --global alias.unstage "reset HEAD --"` -- Reverte o valor global de uma dada variável de configuração para seu valor padrão: +- Reverte a configuração global para seu valor padrão: `git config --global --unset alias.unstage` -- Edita a configuração Git do repositório corrente usando o editor padrão: +- Edita a configuração local do Git (`.git/config`) no editor padrão: `git config --edit` -- Edita a configuração global do Git usando o editor padrão: +- Edita a configuração global do Git (`~/.gitconfig` por padrão ou `$XDG_CONFIG_HOME/git/config` se tal arquivo existir) no editor padrão: `git config --global --edit` diff --git a/pages.pt_BR/common/git-diff.md b/pages.pt_BR/common/git-diff.md index a0ec9efea7..45c28cc91b 100644 --- a/pages.pt_BR/common/git-diff.md +++ b/pages.pt_BR/common/git-diff.md @@ -3,7 +3,7 @@ > Mostra alterações nos arquivos rastreados. > Mais informações: . -- Mostra as alterações não preparadas e sem commit: +- Mostra as alterações não preparadas: `git diff` @@ -19,9 +19,9 @@ `git diff 'HEAD@{3 months|weeks|days|hours|seconds ago}'` -- Mostra apenas os nomes dos arquivos alterados desde um determinado commit: +- Mostra estatísticas de comparação, como arquivos alterados, histogramas e número total de inserções/exclusões de linha: -`git diff --name-only {{commit}}` +`git diff --stat {{commit}}` - Emite um resumo das criações de arquivos, renomeações e alterações de modo desde um determinado commit: diff --git a/pages.pt_BR/common/git-remote.md b/pages.pt_BR/common/git-remote.md index 04761e8995..e812eeb87c 100644 --- a/pages.pt_BR/common/git-remote.md +++ b/pages.pt_BR/common/git-remote.md @@ -3,7 +3,7 @@ > Gerencia repositórios monitorados ("remotes"). > Mais informações: . -- Mostre uma lista de remotes existentes, seus nomes e URL: +- Lista remotes existentes com seus nomes e URLs: `git remote {{-v|--verbose}}` @@ -19,6 +19,10 @@ `git remote set-url {{nome_do_remote}} {{nova_url}}` +- Mostra a URL de um remote: + +`git remote get-url {{nome_do_remote}}` + - Remove um remote: `git remote remove {{nome_do_remote}}` diff --git a/pages.pt_BR/common/git-stage.md b/pages.pt_BR/common/git-stage.md new file mode 100644 index 0000000000..5bf06f845c --- /dev/null +++ b/pages.pt_BR/common/git-stage.md @@ -0,0 +1,8 @@ +# git stage + +> Este comando é um apelido de `git add`. +> Mais informações: . + +- Exibe documentação sobre o comando original: + +`tldr git add` diff --git a/pages.pt_BR/common/git-status.md b/pages.pt_BR/common/git-status.md index 78dec61940..a032e3a75d 100644 --- a/pages.pt_BR/common/git-status.md +++ b/pages.pt_BR/common/git-status.md @@ -1,7 +1,7 @@ # git status > Mostra as alterações nos arquivos em um repositório Git. -> Lista os arquivos alterados, adicionados e excluídos em comparação com o atual commit verificado. +> Lista os arquivos alterados, adicionados e excluídos em comparação com o atual commit do checkout. > Mais informações: . - Mostra arquivos alterados que ainda não foram adicionados para commit: @@ -10,12 +10,24 @@ - Fornece a saída em formato curto: -`git status -s` +`git status --short` + +- Mostra informação verbosa em alterações tanto na área de preparação e no diretório de trabalho: + +`git status --verbose --verbose` + +- Mostra informações da branch e de rastreamento: + +`git status --branch` + +- Mostra a saída em formato curto junto com as informações da branch: + +`git status --short --branch` + +- Mostra o número de entradas atualmente armazenadas: + +`git status --show-stash` - Não mostra arquivos não rastreados na saída: `git status --untracked-files=no` - -- Mostra a saída em formato curto junto com as informações da branch: - -`git status -sb` diff --git a/pages.pt_BR/common/git-tag.md b/pages.pt_BR/common/git-tag.md index 70d40dd5b4..fe3d8e2a8b 100644 --- a/pages.pt_BR/common/git-tag.md +++ b/pages.pt_BR/common/git-tag.md @@ -1,18 +1,18 @@ # git tag > Cria, exibe, exclui ou verifica tags. -> Uma tag é uma referência estática para um commit específico. +> Uma tag é uma referência estática para um commit. > Mais informações: . - Exibe todas as tags: `git tag` -- Crie uma tag com o nome fornecido apontando para o commit atual: +- Cria uma tag com o nome fornecido apontando para o commit atual: `git tag {{nome_da_tag}}` -- Crie uma tag com o nome fornecido apontando para um determinado commit: +- Cria uma tag com o nome fornecido apontando para um determinado commit: `git tag {{nome_da_tag}} {{commit}}` @@ -22,12 +22,16 @@ - Exclui a tag com o nome fornecido: -`git tag -d {{nome_da_tag}}` +`git tag {{-d|--delete}} {{nome_da_tag}}` -- Obtenha tags atualizadas do upstream: +- Obtém tags atualizadas do remote: `git fetch --tags` -- Liste todas as tags cujos ancestrais incluem um determinado commit: +- Envia uma tag para o remote: + +`git push origin tag {{nome_da_tag}}` + +- Lista todas as tags cujos ancestrais incluem um determinado commit: `git tag --contains {{commit}}` diff --git a/pages.pt_BR/common/npm.md b/pages.pt_BR/common/npm.md index 28f577957c..0ac49dac7f 100644 --- a/pages.pt_BR/common/npm.md +++ b/pages.pt_BR/common/npm.md @@ -4,9 +4,9 @@ > Gerencia projetos Node.js e suas dependências de módulos. > Mais informações: . -- Interativamente cria um arquivo `package.json`: +- Cria um arquio `package.json` com os valores padrões (omita `--yes` para torná-lo interativo): -`npm init` +`npm init {{-y|--yes}}` - Baixa todos os pacotes listados como dependências em `package.json`: @@ -28,10 +28,10 @@ `npm uninstall {{pacote}}` -- Lista as dependências instaladas localmente: +- Lista todas as dependências instaladas localmente: `npm list` -- Lista os pacotes de nível superior instalados globalmente: +- Lista todos os pacotes de nível superior instalados globalmente: `npm list {{-g|--global}} --depth {{0}}` diff --git a/pages.pt_BR/linux/at.md b/pages.pt_BR/linux/at.md deleted file mode 100644 index 25fbc99c6c..0000000000 --- a/pages.pt_BR/linux/at.md +++ /dev/null @@ -1,20 +0,0 @@ -# at - -> Executa comandos em um determinado momento. -> Mais informações: . - -- Inicia o prompt `at` para que um novo conjunto de comandos seja agendado, pressione `Ctrl + D` para salvar e sair: - -`at {{hh:mm}}` - -- Executa os comandos e envia o resultado por e-mail utilizando algum programa de envio de e-mail local, por exemplo o Sendmail: - -`at {{hh:mm}} -m` - -- Executa um script em um determinado momento: - -`at {{hh:mm}} -f {{caminho/para/arquivo}}` - -- Mostra uma notificação de sistema às 23h em 18 de Fevereiro: - -`echo "notify-send '{{Acorda!}}'" | at {{11pm}} {{Feb 18}}`