lspci(8) – Linux homem página

Nome

lspci – lista todos os dispositivos PCI

Sinopse

lspci

Descrição

lspci é um utilitário para a apresentação de informações sobre os barramentos PCI no sistema e dispositivos conectados a eles.

por padrão, Ele mostra uma breve lista de dispositivos. Use as opções descritas abaixo para solicitar uma saída mais descritiva ou saída destinada a analisar outros programas.

se vai comunicar erros nos controladores de dispositivos PCI ou no próprio lspci, por favor inclua a saída de “lspci-vvx” ou ainda melhor “lspci-vvxx”(no entanto, veja abaixo para possíveis ressalvas).

algumas partes da saída, especialmente nos modos altamente verbosos, são provavelmente inteligíveis apenas para hackers experientes PCI. Para definições exatas dos campos, consulte as especificações PCI ou o cabeçalho.h e / usr / include / linux / pci.h incluir arquivos.

o acesso a algumas partes do espaço de configuração PCI é restrito à raiz em muitos sistemas operacionais, por isso as características do lspci disponíveis para os normalusers são limitadas. No entanto, o lspci tenta o seu melhor para exibir tanto quanto disponível e marcar todas as outras informações com <acesso negado>texto.

opções

modos de visualização Básicos

– m

descarregar dados do dispositivo PCI numa forma legível por máquina compatível para trás. Veja abaixo para mais detalhes.

-mm

despeja os dados do dispositivo PCI numa forma legível por máquina para fácil processamento por programas. Veja abaixo para mais detalhes.

-t

mostra um diagrama semelhante a uma árvore contendo todos os autocarros, pontes, dispositivos e ligações entre eles.

mostrar as opções

– v

ser descritivo e mostrar informações detalhadas sobre todos os dispositivos.

-vv

seja muito verboso e mostre mais detalhes. Este nível inclui tudo o que for considerado útil.

-vvv

seja ainda mais verboso e exiba tudo o que somos capazes de analisar, mesmo que não pareça interessante em tudo (por exemplo, regiões de memória indefinidas).

-k

mostrar os controladores de kernel que manipulam cada dispositivo e também os módulos de kernel capazes de o manusear. Ligado por omissão quando-v é dado no modo normal de saída. (Atualmente trabalha apenas no Linux com o kernel 2.6 ou mais recente.)

– x

Mostrar dump hexadecimal da parte padrão do espaço de configuração (os primeiros 64 bytes ou 128 bytes para pontes CardBus).

-xxx

mostrar o dump hexadecimal de todo o espaço de configuração PCI. Está disponível apenas para root como vários dispositivos PCI estoiram quando você tenta ler algumas partes do espaço de configuração (este comportamento provavelmente não viola o padrão PCI, mas é pelo menos muito estúpido). No entanto, tais dispositivos são raros, então você não precisa se preocupar muito.

-XXX

mostrar o dump hexadecimal do espaço de configuração PCI alargado (4096-byte) Disponível nos barramentos PCI-X 2.0 e PCI Express.

-b

Bus-centric view. Mostrar todos os números e endereços IRQ como vistos pelas cartas no barramento PCI em vez de como visto pelo kernel.

-D

mostrar sempre os números do domínio PCI. Por padrão, lspci suprime – os em máquinas que têm apenas domínio 0.

opções para controlar a resolução de IDS para nomes

-n

mostrar os códigos de Fornecedor E Dispositivo PCI como números em vez de os Procurar na lista de ID PCI.

-nn

mostrar os códigos de Fornecedor E Dispositivo PCI como números e nomes.

-q

Use DNS para consultar a base de dados central de ID PCI se um dispositivo não for encontrado no ICP local.ficheiro de identificação. Se a consulta DNS for bem sucedida, o resultado é cache em~/.pciids-cache e é reconhecido em corridas subsequentes, mesmo se-q não é dado mais. Por favor, use esta opção dentro de scripts automatizados apenas com precaução para evitar sobrecarregar os servidores de banco de dados.

-qq

igual a-q, mas o cache local é reiniciado.

-Q

consultar a base de dados central mesmo para entradas que são reconhecidas localmente. Use isto se suspeitar que o item apresentado está errado.

opções para a selecção de dispositivos

– s:] <bus>]:]] Mostra apenas os dispositivos no domínio especificado (no caso a sua máquina tem vários host pontes, eles podem compartilhar um barramento comum, número ou espaço em cada um dos themcan endereço de uma placa PCI domínio próprio; domínios são numerados de 0 a ffff), ônibus (0 a ff), slot (0 a 1f) e função (de 0 a 7). Cada componente do deviceaddress pode ser omitido ou definido como “*”, ambos significando “qualquer valor”. Todos os números são hexadecimais. Por exemplo,” 0: “designa todos os dispositivos do barramento 0,” 0 “designa todas as funções do dispositivo 0 em qualquer barramento,” 0.3 “selecciona a terceira função do dispositivo 0 em todos os barramentos e”.4 ” mostra apenas a quarta função de cada dispositivo. – d: Mostrar apenas os dispositivos com o fornecedor e o ID do dispositivo especificados. Ambos os ID’s são dados em hexadecimal e podem ser omitidos ou dados como “*”, ambos significando “anyvalue”.

outras opções

– i<ficheiro > usar<ficheiro > como lista de ID PCI em vez de /usr/share/hwdata/pci.identificacao. – p <file> Use < file> como o mapa do ID PCI tratado por módulos do núcleo. Por omissão, o lspci usa o/lib / modules/kernel_version / modules.pcimap. Appliesonly to Linux systems with recent enough module tools. – M

invocar o modo de mapeamento de barramento que efectua uma análise completa de todos os dispositivos PCI, incluindo os que estão por trás de pontes mal configuradas, etc. Esta opção dá resultados significativos apenas com um modo de acesso directo ao ‘hardware’, que normalmente requer privilégios de ‘root’. Por favor, note que o cartógrafo de ônibus apenas verifica o domínio PCI 0.

— version mostra a versão lspci. Esta opção deve ser utilizada isoladamente.

PCI access options

the PCI utilities use the PCI library to talk to PCI devices (see pcilib (7) for details). Você pode usar as seguintes opções para influenciar itsbehavior:-A<method > the library supports a variety of methods to access the PCI hardware. Por padrão, ele usa o primeiro método de acesso disponível, mas você pode usar esta opção tooverride esta decisão. Veja-uma ajuda para uma lista de métodos disponíveis e suas descrições. – O <param> = <valor> o comportamento da Biblioteca é controlado por vários parâmetros nomeados. Esta opção permite definir o valor de qualquer um dos parâmetros. Use-o help for list of known parameters and their default values. – H1

utilizar acesso directo ao hardware através do mecanismo de configuração Intel 1. (This is a shorthand for-A intel-conf1.)

-H2

Use acesso directo ao hardware através do mecanismo de configuração Intel 2. (This is a shorthand for-A intel-conf2.)

-F <arquivo> em Vez de acessar o hardware real, leia a lista de dispositivos e valores dos seus registos de configuração a partir do dado de arquivo produzido por uma execução anterior oflspci -x. Isto é muito útil para a análise do usuário fornecido relatórios de bugs, porque você pode exibir a configuração de hardware em qualquer maneira que você quiser withoutdisturbing o usuário com pedidos de mais lixeiras. – G

aumentar o nível de depuração da biblioteca.

saída legível por máquina

se pretender processar a saída do lspci automaticamente, por favor utilize um dos formatos de saída legíveis por máquina (- m,- vm,- vmm)descritos nesta secção. Todos os outros formatos são susceptíveis de mudar entre versões do lspci.Todos os números são impressos em hexadecimal. Se quiser processar os ID numéricos em vez dos nomes, por favor adicione o botão-n.

formato simples (- m)

no formato simples, cada dispositivo é descrito em uma única linha, que é formatado como parâmetros adequados para passar para um script shell, i.e., valor separado por espaços em branco, Citado e escapado, se necessário. Alguns dos argumentos posicionais: slot, classe, nome do fornecedor, o nome do dispositivo do fornecedor do subsistema nameand subsistema de nome (os dois últimos são vazias se o dispositivo não tem nenhuma subsistema); os argumentos restantes são a opção-como: -rrev

número de Revisão.

-interface de programação pprogif. A ordem relativa dos argumentos e opções posicionais é indefinida. Novas opções podem ser adicionadas em versões futuras, mas eles sempre terão um único documento não separado da opção por quaisquer espaços, de modo que eles podem ser facilmente ignorados se não forem reconhecidos.

formato descritivo (- vmm)

a saída descritiva é uma sequência de registos separados por linhas em branco. Cada registo descreve um único dispositivo por uma sequência de linhas, cada linha contendo um único par de “marca: valor”. A marca e o valor são separados por um único carácter de tabulação. Nem os registros nem as linhas dentro de arecord estão em qualquer ordem particular. As etiquetas são sensíveis a maiúsculas.

as seguintes marcas são definidas:

Fenda

o nome da fenda onde o dispositivo reside (barramento:dispositivo.funcao). Esta etiqueta é sempre a primeira de um disco.

Classe

nome da classe.

vendedor

nome do vendedor.

dispositivo

nome do dispositivo.

SVendor nome do Fornecedor do subsistema (opcional). Nome SDevice do subsistema (facultativo). PhySlot o slot físico onde o dispositivo reside (opcional, apenas Linux). Rev

número de revisão (facultativo).

ProgIf

interface de programação (opcional).

Driver

controlador de Kernel que está a lidar com o dispositivo (opcional, apenas Linux).

Módulo

módulo de Kernel relatando que ele é capaz de lidar com o dispositivo (opcional, apenas Linux).

novas tags podem ser adicionadas em versões futuras, então você deve ignorar silenciosamente quaisquer tags que você não reconhece.

Backward-compatible verbose format (- vm)

In this mode, lspci tries to be perfectly compatible with its old versions. É quase o mesmo que o formato descritivo regular, mas a etiqueta do dispositivo é usada tanto para o slot quanto para o nome do dispositivo, então ela ocorre duas vezes em um único registro. Por favor, evite usar este formato em qualquer novo código.

Files

/ usr / share / hwdata / pci.ids

a list of all known PCI IDs (vendors, devices, classes and subclasses). Mantido em http://pciids.sourceforge.net/, use o update-pciids Utility para baixar a versão mais recente. /usr / share/hwdata / pci.identificacao.gz se o lspci for compilado com suporte para compressão, este ficheiro é testado antes do pci.identificacao. ~/.pciids-cache todos os ID’s encontrados no modo de consulta DNS são Cache neste arquivo.

Bugs

às vezes, lspci não é capaz de decodificar os registros de configuração completamente. Isto geralmente acontece quando não existe documentação suficiente disponível para os autores. Nesses casos, pelo menos imprime o <?Marque para sinalizar que há potencialmente algo mais a dizer. Se você souber os detalhes,patches serão naturalmente bem-vindos.

o acesso ao espaço de configuração alargado é suportado actualmente apenas pelo back-end do linux_sysfs.

Veja Também:

setpci(8), atualize-pciids(8), pcilib(7)

Autor

PCI Utilitários são mantidos por Martin Mares <[email protected]>.



+