dmesg - exibe ou controla o buffer de anel do kernel
SINOPSIS
dmesg [opções]
dmesg --clear
dmesg --read-clear [opções]
dmesg --console-level nível
dmesg --console-on
dmesg --console-off
DESCRIÇÃO
dmesg é usado para examinar ou controlar o buffer de anel do kernel.
A ação padrão é exibir todas as mensagens do buffer de anel do kernel.
OPÇÕES
As opções --clear, --read-clear, --console-on, --console-off e --console-level são mutuamente exclusivas.
-C, --clear
Limpa o buffer de anel.
-c, --read-clear
Limpa o buffer de anel após imprimir seu conteúdo pela primeira vez.
-D, --console-off
Desativa a impressão de mensagens para o console.
-d, --show-delta
Exibe o timestamp e o tempo decorrido entre as mensagens. Se usado em conjunto com --notime, apenas o tempo decorrido sem o timestamp será impresso.
-E, --console-on
Ativa a impressão de mensagens para o console.
-e, --reltime
Exibe a hora local e o tempo decorrido em um formato legível. Esteja ciente de que a conversão para a hora local pode ser imprecisa (veja -T para mais detalhes).
-F, --file arquivo
Lê as mensagens do syslog do arquivo fornecido. Observe que -F não suporta mensagens no formato kmsg. Veja -K em vez disso.
-f, --facility lista
Restringe a saída à lista fornecida (separada por vírgulas) de instalações. Por exemplo:
dmesg --facility=daemon
imprimirá mensagens apenas de daemons do sistema. Para todas as instalações suportadas, veja a saída
de --help.
-H, --human
Habilita a saída legível para humanos. Veja também --color, --reltime e --nopager.
-J, --json
Usa o formato de saída JSON. O formato de saída de tempo está no formato "seg.useg" apenas, o nível de prioridade do log não é decodificado por padrão (use --decode para dividir em instalação e prioridade), as outras opções para controlar o formato de saída ou o formato de tempo são silenciosamente ignoradas.
-K, --kmsg-file arquivo
Lê as mensagens de /dev/kmsg do arquivo fornecido. Diferentes registros, conforme esperado, são separados por um byte nulo.
-k, --kernel
Imprime as mensagens do kernel.
-L, --color[=quando]
Coloriza a saída. O argumento opcional quando pode ser auto, nunca ou sempre. Se o argumento quando for omitido, ele assume o valor padrão de auto. As cores podem ser desativadas; para o valor padrão atual, veja a saída de --help. Veja também a seção CORES abaixo.
-l, --level lista
Restringe a saída à lista fornecida (separada por vírgulas) de níveis. Por exemplo:
dmesg --level=err,warn
imprimirá apenas mensagens de erro e aviso. Para todos os níveis suportados, veja a saída de
--help.
Anexar um sinal de mais + a um nome de nível também inclui todos os níveis superiores. Por exemplo:
dmesg --level=err+
imprimirá os níveis err, crit, alert e emerg.
Prefixá-lo incluirá todos os níveis inferiores.
-n, --console-level nível
Define o nível em que a impressão de mensagens é feita no console. O nível é um número de nível ou uma abreviação do nome do nível. Para todos os níveis suportados, veja a saída de --help.
Por exemplo, -n 1 ou -n emerg impede que todas as mensagens, exceto as mensagens de emergência (pânico), apareçam no console. Todos os níveis de mensagens ainda são gravados em /proc/kmsg, para que syslogd(8) ainda possa ser usado para controlar exatamente onde as mensagens do kernel aparecem. Quando a opção -n é usada, dmesg não imprimirá nem limpará o buffer de anel do kernel.
--noescape
Os caracteres não imprimíveis e potencialmente inseguros (por exemplo, sequências multibyte quebradas, caracteres de controle de terminal, etc.) são escapados no formato \x
-P, --nopager
Não envie a saída para um paginador. Um paginador é habilitado por padrão para a saída --human.
-p, --force-prefix
Adicione informações de instalação, nível ou carimbo de data/hora a cada linha de uma mensagem de várias linhas.
-r, --raw
Imprima o buffer de mensagem bruto, ou seja, não remova os prefixos de nível de log, mas todos os caracteres não imprimíveis ainda são escapados (veja também --noescape).
Observe que o formato bruto real depende do método pelo qual dmesg lê as mensagens do kernel. O dispositivo /dev/kmsg usa um formato diferente de syslog(2). Para compatibilidade com versões anteriores, dmesg sempre retorna dados no formato syslog(2). É possível ler os dados brutos reais de /dev/kmsg, por exemplo, com o comando 'dd if=/dev/kmsg iflag=nonblock'.
-S, --syslog
Force dmesg a usar a interface de kernel syslog(2) para ler as mensagens do kernel. O padrão é usar /dev/kmsg em vez de syslog(2) desde o kernel 3.5.0.
-s, --buffer-size size
Use um buffer de tamanho para consultar o buffer de anel do kernel. O valor padrão é 16392. (O tamanho padrão do buffer de syslog do kernel era 4096 no início, 8192 desde a versão 1.3.54 e 16384 desde a versão 2.1.113.) Se você definiu o buffer do kernel para ser maior que o padrão, esta opção pode ser usada para visualizar todo o buffer.
-T, --ctime
Imprima carimbos de data/hora legíveis por humanos.
Esteja ciente de que o carimbo de data/hora pode ser impreciso! A fonte de tempo usada para os logs não é atualizada após a suspensão/retomada do sistema. Os carimbos de data/hora são ajustados de acordo com a diferença atual entre os relógios de inicialização e monotônicos, isso funciona apenas para mensagens impressas após a última retomada.
--since time
Exiba registros desde o horário especificado. O suporte é fornecido para granularidade de subsegundos. O horário pode ser especificado de forma absoluta e também por meio de notação relativa (por exemplo, '1 hora atrás'). Esteja ciente de que o carimbo de data/hora pode ser impreciso e consulte --ctime para obter mais detalhes.
--until time
Exiba registros até o horário especificado. O suporte é fornecido para granularidade de subsegundos. O horário pode ser especificado de forma absoluta e também por meio de notação relativa (por exemplo, '1 hora atrás'). Esteja ciente de que o carimbo de data/hora pode ser impreciso e consulte --ctime para obter mais detalhes.
-t, --notime
Não imprima os carimbos de data/hora do kernel.
--time-format format
Imprima os carimbos de data/hora usando o formato fornecido, que pode ser ctime, reltime, delta, iso ou raw. Os três primeiros formatos são aliases das opções específicas do formato de tempo. O formato raw usa o formato de carimbo de data/hora padrão, mostrando os segundos desde a inicialização. O formato iso é uma implementação de dmesg do formato de carimbo de data/hora ISO-8601. O objetivo deste formato é facilitar a comparação de carimbos de data/hora entre dois sistemas e qualquer outro tipo de análise. A definição do carimbo de data/hora iso é: AAAA-MM-DD
O formato ISO tem o mesmo problema do ctime: a hora pode ser imprecisa quando um sistema é suspenso e retomado.
--time-format pode ser usado várias vezes com valores diferentes para formatar cada
formato especificado.
O delta sempre segue ctime ou raw se especificados juntos.
-u, --userspace
Imprime mensagens do espaço do usuário.
-w, --follow
Aguarda novas mensagens. Este recurso é suportado apenas em sistemas com um /dev/kmsg legível
(a partir do kernel 3.5.0).
-W, --follow-new
Aguarda e imprime apenas novas mensagens.
-x, --decode
Decodifica os números de facilidade e nível para prefixos legíveis por humanos.
-h, --help
Exibe o texto de ajuda e sai.
-V, --version
Exibe a versão e sai.
CORES
A colorização da saída é implementada pela funcionalidade terminal-colors.d(5). A colorização implícita
pode ser desabilitada por um arquivo vazio
/etc/terminal-colors.d/dmesg.disable
para o comando dmesg ou para todas as ferramentas por
/etc/terminal-colors.d/disable
Desde a versão 2.41, a variável de ambiente $NO_COLOR também é suportada para desabilitar a colorização da saída, a menos que seja explicitamente habilitada por uma opção de linha de comando.
O diretório $XDG_CONFIG_HOME/terminal-colors.d ou $HOME/.config/terminal-colors.d específico do usuário substitui a configuração global.
Observe que a colorização da saída pode ser habilitada por padrão e, neste caso, os diretórios terminal-colors.d não precisam existir ainda.
Os nomes de cores lógicos suportados por dmesg são:
subsys
O prefixo do subsistema da mensagem (por exemplo, "ACPI:").
time
O carimbo de data/hora da mensagem.
timebreak
O carimbo de data/hora da mensagem no formato ctime curto em --reltime ou --human.
alert
O texto da mensagem com a prioridade de log de alerta.
crit
O texto da mensagem com a prioridade de log crítica.
err
O texto da mensagem com a prioridade de log de erro.
warn
O texto da mensagem com a prioridade de log de aviso.
segfault
O texto da mensagem que informa sobre falha de segmentação.
STATUS DE SAÍDA
dmesg pode falhar ao relatar um erro de permissão negada. Isso geralmente é causado pela configuração dmesg_restrict do kernel, consulte syslog(2) para obter mais detalhes.
AUTORES
Karel Zak <\_\>
dmesg foi originalmente escrito por Theodore Ts’o <_>.
CONSULTE TAMBÉM
terminal-colors.d(5), syslogd(8)
RELATANDO BUGS
Para relatórios de bugs, use o rastreador de problemas [https://github.com/util-linux/util-linux/issues].
DISPONIBILIDADE
O comando dmesg faz parte do pacote util-linux, que pode ser baixado do Arquivo do Kernel Linux [https://www.kernel.org/pub/linux/utils/util-linux/].