Ubuntu Manpage: proc - pseudo sistema de arquivos de informações de processos.

Provided by: manpages-pt_20040726-2_all

NOME

       proc - pseudo sistema de arquivos de informações de processos.

DESCRIÇÃO

/proc é um pseudo sistema de arquivos usado como uma interface para as
estruturas de dados do kernel, assim como para leitura e interpretação
de /dev/kmem. Muitos dos arquivos fornecem somente permissões de
leitura, mas alguns permitem que variáveis do kernel seja alteradas.

Apresentamos a seguir uma rápida descrição da hierarquia do /proc.

[n��mero]
Há um subdiretório numérico para cada processo que esteja sendo
executado; o subdiretório tem o nome da identificação do
processo (PID). Cada um contém os seguintes pseudo arquivos e
diretórios:

cmdline
Contém a linha de comando completa para o processo, a
menos que todo o processo tenha sido transferido para a
área de troca (swap), ou seja um processo zumbi. Nestes
casos o arquivo estará vazio; isto é um arquivo que
retornará 0 caracteres. Este arquivo é terminado com o
caracter nulo, e não com nova linha.

cwd É o link do diretório atual de trabalho do processo. Para
encontrar o cwd do processo 20, por exemplo, deve-se:
cd /proc/20/cwd; /bin/pwd

Note que o comando pwd está freqüentemente incorporado no
interpretador de comandos e pode não funcionar exatamente desta
forma neste contexto.

environ
Este arquivo contém o ambiente do processo. As entradas
são separadas por caracteres nulos, e deve haver um
caracter nulo ao final do arquivo. Para listar o
ambiente do processo 1, deve-se:
(cat /proc/1/environ; echo) | tr "\000" "\n"

(caso alguém queira saber porque fazer isso, veja o comando
lilo(8).)

exe um ponteiro para o binário que está sendo executado e
aparece como uma ligação simbólica. readlink(2) no
arquivo especial exe retorna sob o Linux 2.0 ou mais
recente a seguinte cadeia de caracteres no formato:

[dispositivo]:inode

Por exemplo, [0301]:1502 pode ser o inode 1502 no
dispositivo com identificação primária 03 (major) (IDE,
MFM, etc...) e secundária 01 (minor) (primeira partição
do primeiro dispositivo). Sob o Linux 2.2 a ligação
simbólica contém a caminho de busca atual do comando.

Ainda, a ligação simbólica pode ser referenciada
normalmente, ou seja ao tentar-se abrir "exe" , na
verdade será aberto o executável. Pode ainda executar o
comando /proc/[n��mero]/exe para executar uma cópia do
mesmo processo como [número].

find(1) com a opção -inum pode ser usado para localizar
um arquivo.

fd Este é um subdiretório contendo uma entrada para cada
arquivo aberto pelo processo, nomeado pelos seus
descritores e que tenham uma ligação simbólica com o
arquivo real (como nas entradas em exe). Zero é a entrada
padrão, 1 a saída padrão e 2 a saída padrão de erros,
etc...

Programas que utilizarão nomes de arquivos, mas não a
partir da entrada padrão, e que gravam arquivos, mas não
através da saída padrão, podem ser depurados através do
seguinte comando (assumindo-se -i como o indicador do
arquivo de entrada e -o como o indicador do arquivo de
saída:
foobar -i /proc/self/fd/0 -o /proc/self/fd/1 ...
tendo-se então um filtro de trabalho. Note que isso não
irá funcionar para programas que fazem buscas em seus
arquivos, pois os arquivos no diretório fd não podem ser
pesquisados.

/proc/self/fd/N é aproximadamente o mesmo que /dev/fd/N
em alguns sistemas UNIX e similares a UNIX. Diversos
scripts MAKEDEV do Linux ligam simbolicamente /dev/fd
para /proc/self/fd, na verdade.

maps Um arquivo contendo o mapa atual de regiões da memória e
suas permissões de acesso.

O formato é:
endereço perms desl. disp inode
00000000-0002f000 r-x-- 00000400 03:03 1401
0002f000-00032000 rwx-p 0002f400 03:03 1401
00032000-0005b000 rwx-p 00000000 00:00 0
60000000-60098000 rwx-p 00000400 03:03 215
60098000-600c7000 rwx-p 00000000 00:00 0
bfffa000-c0000000 rwx-p 00000000 00:00 0

onde endereço é o endereço do espaço de memória que o processo
ocupa, e perms é o conjunto de permissões:
r = leitura
w = gravação
x = execução
s = compartilhada
p = privada (copia da gravação)

deslocamento é o deslocamento no arquivo, disp é o dispositivo
(primária:secundária)(major:minor), e inode refere-se ao inode
do dispositivo. Zero indica que o inode está associado à uma
região da memória, como o caso estaria com bss.

Nos kerneis 2.2 há um campo adicional fornecendo um caminho de
busca quando aplicável.

mem Este não é igual ao dispositivo mem (1,1), apesar de ter
o mesmo número de dispositivos. O dispositivo /dev/mem é
a memória física antes da conversão de endereços, mas o
arquivo mem aqui descrito é a memória acessada pelo
processo. Ela não pode ser mapeada por mmap(2)’ed
atualmente, e não poderá até que uma mmap(2) geral seja
adicionada ao kernel (o que pode ocorrer em breve).

mmap Diretório dos mapas gerados por mmap(2) os quais são
ligações simbólicas como exe, fd/*, etc. Note que estes
mapas incluem um subconjunto destas informações, então
/proc/*/mmap podem ser considerados obsoletos.

"0" é normalmente libc.so.4.

/proc/*/mmap foi removido do kernel do Linux na versão
1.1.40 (e realmente estava obsoleto)

root Unix e Linux suportam a idéia de um raiz de sistema de
arquivos por processo, definidos pela chamada ao sistema
chroot(2) . Root aponta o raiz do sistema de arquivos, e
comporta-se como exe, fd/*, etc...

stat Informações sobre o status do processo. Isso é fornecido
por ps(1).

Os campos, em ordem, com as suas propriedades específicas
em scanf(3) são:

pid %d Identificação do processo.

comm %s
O nome do arquivo do executável entre parênteses.
É visível mesmo que o processo esteja na área de
troca.

state %c
Um caracter da cadeia "RSDZT" onde R é em
execução, S é dormindo em uma espera por
interrupção, D aguardando em uma espera que não
pode ser interrompida ou em área de troca, Z é um
zumbi e T significa paralisado (em um sinal) ou
rastreado.

ppid %d
O PID do processo pai.

pgrp %d
O ID do grupo do processo.

session %d
O ID da sessão do processo.

tty %d O tty que o processo usa.

tpgid %d
A ID do grupo do processo que atualmente detém o
tty no qual o processo está conectado.

flags %u
Os indicadores do processo. Atualmente, cada
indicador tem o bit matemático configurado,
porque crt0.s verifica a emulação de co-
processador matemático, e isso não é incluído na
saída. Isso é provavelmente um erro, e nem todos
os processos são compiladores C. O bit matemático
é um decimal 4 e o bit de rastreamento é um
decimal 10.

minflt %u
O número de pequenos erros do processo, aqueles
que não requerem a carga de páginas de memória a
partir do disco.

cminflt %u
O número de erros menores do processo e de seus
processos filhos.

majflt %u
O número de erros maiores do processo, aqueles
que requerem a carga de páginas de memória a
partir do disco.

cmajflt %u
O número de erros maiores do processo e de seus
processo filhos.

utime %d
O número de ciclos do processador que o processo
tem previsto em modo usuário.

stime %d
O número de ciclos do processador que o processo
tem previsto em modo kernel.

cutime %d
O número de ciclos do processador que o processo
e seus filhos têm previstos em modo usuário.

cstime %d
O número de ciclos do processador que o processo
e seus filhos têm previstos em modo kernel.

counter %d
O número máximo de ciclos do processador do
próximo período de processamento destinado ao
processo, ou o tempo restante no período atual,
caso o processo esteja ocupando o processador.

priority %d
O valor padrão acrescido de 15. O valor nunca é
negativo no kernel.

timeout %u
O tempo em ciclos do processador do próximo
período de espera.

itrealvalue %u
O tempo (em ciclos do processador) antes que o
próximo SIGALRM seja enviado para o processo
relativo a um intervalo de tempo.

starttime %d Tempo, em ciclos do processador, que o
processo iniciou após o
sistema ser iniciado.

vsize %u
Tamanho da memória virtual.

rss %u Tamanho do conjunto residente: número de páginas
que o processo tem na memória real, menos 3 para
uso administrativo. Estas são as páginas que
contêm texto, dados ou espaço da pilha, não
incluindo páginas que foram carregadas de acordo
com a demanda ou que foram para a área de troca.

rlim %u
Limite em bytes do rss do processo (normalmente
2,147,483,647).

startcode %u
O endereço acima do qual o texto do programa
deve ser executado.

endcode %u
O endereço abaixo do qual o texto do programa
deve ser executado.

startstack %u
O endereço de início da pilha.

kstkesp %u
O valor atual de esp (ponteiro da pilha com 32
bits), conforme encontrado na pilha de páginas do
kernel para o processo.

kstkeip %u
EIP atual (ponteiro da instrução com 32 bits).

signal %d
O mapa de bits dos sinais pendentes (normalmente
zero).

blocked %d
O mapa de bits dos sinais bloqueados (normalmente
0, 2 para ambientes de trabalho).

sigignore %d
O mapa de bits dos sinais ignorados.

sigcatch %d
O mapa de bits de sinais recebidos.

wchan %u
Este é o canal no qual o processo fica esperando.
Este é o endereço da chamada ao sistema, e pode
ser analisada em uma lista de nomes, caso se
necessite de um nome textual (caso se tenha um
/etc/psdatabase atualizado, então tente ps -l
para ver o campo WCHAN em ação).

cpuinfo
Esta é uma coleção de itens dependentes da CPU e da arquitetura
do sistema, sendo que cada uma destas tem uma lista diferente.
As únicas duas entradas comuns são cpu a qual é a CPU atual em
uso e BogoMIPS uma constante do sistema que é calculada durante
a inicialização do sistema.

devices
Lista dos números primários (majors) e grupos de dispositivos.
Isso pode ser usado pelos scripts MAKEDEV para checagem de
consistência com o kernel.

dma Lista dos canais DMA ISA (acesso direto à memória) registrados
em uso.

filesystems
lista dos sistemas de arquivos que foram compilados com o
kernel. Pode ser usado por mount(1) para pesquisar através de
diferentes sistemas de arquivos quando nenhum é especificado.

interrupts
É usado para gravar o número de interrupções por cada IRQ nas
arquiteturas i386. Muito simples de ler-se, feito em formato
ASCII.

ioports
Lista das portas de Entrada-Saída registradas que estão em uso.

kcore Este arquivo representa a memória física do sistema e está
armazenada no formato de arquivo core. Com este pseudo arquivo,
e o binário do kernel com as funções de mensagens incorporadas
(/usr/src/linux/tools/zSystem), pode-se usar o GDB para examinar
o estado atual de qualquer estrutura de dados do kernel.

O tamanho total do arquivo é o tamanho da memória física (RAM)
mais 4 Kb.

kmsg Este arquivo pode ser usado ao invés da chamada ao sistema
syslog(2) para registrar mensagens do kernel. Um processo deve
ter privilégios de superusuário para ler este arquivo e somente
um processo pode fazer isso. Esse arquivo não deve ser lido se
um processo syslog está sendo executado o qual usa a chamada ao
sistema syslog(2) para registrar as mensagens do kernel.

Informações deste arquivos são recuperadas com o programa
dmesg(8)

ksyms Contém as definições dos símbolos exportados pelo kernel usados
pelas ferramentas de m��dulos(X) para dinamicamente ligar e
vincular módulos carregáveis.

loadavg
A média de carga do sistema fornecida pela média do número de
serviços na fila de execução há mais de 1, 5 e 15 minutos. É o
mesmo que a média dada pelo programa uptime(1) e outros.

locks Este arquivo exibe os arquivos travados.

malloc Este arquivo somente está presente se CONFIGDEBUGMALLOC for
definido durante a compilação.

meminfo
É usada pelo comando free(1) para informar a quantidade de
memória livre e utilizada (tanto a memória física como a de
troca) assim como a memória compartilhada e os buffers usados
pelo kernel.

Tem o mesmo formato que o comando free(1), exceto pelo fato de
estar em bytes ao invés de Kb.

modules
Uma lista dos módulos carregados pelo sistema.

net Vários pseudo arquivos, que fornecem o status de alguma parte da
camada de rede. Estes arquivos contêm estruturas em formato
ASCII e podem ser lidas por exemplo pelo cat. De qualquer forma,
as ferramentas do netstat(8) possibilitam um acesso muito mais
adequado a estes arquivos.

arp Ele contém uma imagem em formato ASCII da tabela ARP do
kernel usada na resolução de endereços. Irá apresentar
dinamicamente as entradas ARP pré-programadas e recebidas
dinamicamente. O formato é:
IP address HW type Flags HW address
10.11.100.129 0x1 0x6 00:20:8A:00:0C:5A
10.11.100.5 0x1 0x2 00:C0:EA:00:00:4E
44.131.10.6 0x3 0x2 GW4PTS

Onde ’IP address’ é o endereço Ipv4 da máquina, o ’HW type’ é o
tipo de hardware no endereço conforme a RFC 826. Os indicadores
são internos à estrutura ARP(conforme definido em
/usr/include/linux/if_arp.h) e o

dev Os pseudo arquivos dev contêm informações sobre a
situação dos dispositivos de rede. Ele dá o número de
pacotes recebidos e enviados, o número de erros e
colisões e outras estatísticas básicas. Eles são usados
pelo programa ifconfig(8) para apresentar relatórios do
status do dispositivo. O formato é:
Inter-| Receive | Transmit
face |packets errs drop fifo frame|packets errs drop fifo colls carrier
lo: 0 0 0 0 0 2353 0 0 0 0 0
eth0: 644324 1 0 0 1 563770 0 0 0 581 0

ipx Nenhuma informação.

ipx_route
Nenhuma informação.

rarp Este arquivo usa o mesmo formato do arquivo arp e contém
a base de dados de mapeamento reverso usado para prover
os serviços de pesquisa de endereços reversos do rarp(8)
. Caso RARP não esteja configurado no kernel este
arquivo não estará presente.

raw Mantém uma imagem RAW (crua) da tabela de conexões.
Muita desta informação não tem outra finalidade senão a
depuração. O valor ’sl’ é a área do kernel para a
conexão, e ’local address’ é o endereço local e o par de
números de protocolo. "St" é o status interno da conexão.
"tx_queue" e "rx_queue" são as filas de dados de entrada
e saída em termos de uso de memória do kernel. Os campos
"tr", "tm->when" e "rexmits" não são usados por RAW. O
campo uid contém a identificação do criador da conexão.

route Nenhuma informação, mas parece similar ao route(8)

snmp Este arquivo contém dados em formato ASCII necessários
para o gerenciamento de IP, ICMP, TCP e UDP por um agente
snmp. As of writing the TCP mib is incomplete. It is
hoped to have it completed by 1.2.0.

tcp Mantém uma imagem da tabela de conexões TCP. Muitas
informações são utilizadas exclusivamente para depuração.
O valor ’sl’ é a área do kernel para a conexão, e ’local
address’ é o endereço local e o par de números de
protocolo. O "endereço remoto" é o par endereço remoto e
o número da porta (se conectado). "St" é o status interno
da conexão. "tx_queue" e "rx_queue" são as filas de
entrada de dados e de saída em termos de uso de memória
do kernel. Os campos "tr", "tm->when" e "rexmits" hold
internal information of the kernel socket state and are
only useful debugging. O campo uid contém a identificação
do criador da conexão.

udp Mantém uma imagem da tabela de conexões UDP. Muitas
informações são utilizadas exclusivamente para depuração.
O valor ’sl’ é a área do kernel para a conexão, e ’local
address’ é o endereço local e o par de números de
protocolo. O "endereço remoto" é o par endereço remoto e
o número da porta (se conectado). "St" é o status interno
da conexão. "tx_queue" e "rx_queue" são as filas de dados
de entrada e saída em termos de uso de memória do
kernel. Os campos "tr", "tm->when" e "rexmits" não são
usados pelo UDP. O campo uid contém a identificação do
criador da conexão. O formato é:
1: 01642C89:0201 0C642C89:03FF 01 00000000:00000001 01:000071BA 00000000 0
1: 00000000:0801 00000000:0000 0A 00000000:00000000 00:00000000 6F000100 0
1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0

unix Lista de conexões com domínios Unix presentes no sistema
e seus status. O formato é:
Num RefCount Protocol Flags Type St Path
0: 00000002 00000000 00000000 0001 03
1: 00000001 00000000 00010000 0001 01 /dev/printer

Onde ’Num’ é a área do kernel, ’RefCount’ é o número de usuários
da conexão, ’Protocol’ é atualmente sempre zero, ’Flags’
representam os indicadores internos do kernel com o status da
conexão. Tipo é sempre igual a 1 (datagramas de conexões a
domínios Unix ainda não são suportadas). ’St’ é o estado interno
da conexão e Path é o caminho (caso exista) da conexão.

pci Lista de todos os dispositivos PCI encontrados pelo kernel
durante sua inicialização e configuração.

scsi Um diretório com pseudo arquivo scsi de nível médio scsi, e
vários diretórios de arquivos de controle de baixo nível para
dispositivos SCSI. Contém um arquivo para cada dispositivo SCSI
do sistema, cada um com o status de alguma parte do subsistema
de E/S SCSI. Estes arquivos contêm estruturas ASCII que podem
ser lidas pelo comando cat.

Pode-se ainda gravar alguns arquivos para reconfigurar o
subsistema ou ativar ou desativar algumas funcionalidades.

scsi Uma lista de todos os dispositivos SCSI conhecidos pelo
kernel. A lista é similar a uma apresentada durante a
inicialização do sistema. SCSI atualmente suporta
somente o comando singledevice que permite ao
superusuário adicionar dispositivos sem desligar o
sistema à lista de dispositivos conhecidos.

Um comando echo �’scsi singledevice 1 0 5 0�’ >
/proc/scsi/scsi provocará que scsi1 pesquise no canal
SCSI 0 por um dispositivo de ID 5 LUN 0. Caso haja algum
neste endereço ou o endereço seja inválido, será
retornado um erro.

drivername
drivername pode atualmente ser: NCR53c7xx, aha152x,
aha1542, aha1740, aic7xxx, buslogic, eata_dma, eata_pio,
fdomain, in2000, pas16, qlogic, scsi_debug, seagate,
t128, u15-24f, ultrastore ou wd7000. Estes diretórios
mostram todos os arquivos de controle que registraram
pelo menos um HBA SCSI. Cada diretório contém um arquivo
registrado por dispositivo. Cada arquivo é nomeado após a
indicação do número dado pela inicialização.

Estes arquivos contêm a configuração do dispositivo e do
arquivo de controle estatísticas, etc.

A gravação nestes arquivos permite a execução de
diferentes tarefas. Por exemplo com os comandos de
superusuário latency e nolatency pode-se ligar ou
desligar o comando de medição de latência no arquivo de
controle eata_dma. Com os comandos lockup e unlock pode-
se controlar as pesquisas de controle de barramento
simuladas pelo arquivo de controle de dispositivo
scsi_debug .

self Este diretório referencia-se ao processo de acesso ao sistema de
arquivos /proc, e é idêntico ao diretório /proc nomeado pela
identificação do mesmo processo.

stat estatísticas do kernel e do sistema

cpu 3357 0 4313 1362393
O tempo dos ciclos do processador (em centésimos de
segundo) que o sistema despende em modo usuário, modo
usuário de baixa prioridade (nice), modo sistema e
tarefas disponíveis, respectivamente. O último valor deve
ser 100 vezes a segunda entrada no pseudo arquivo uptime.

disk 0 0 0 0
As entradas para quatro discos não estão implementadas
ainda. Não estamos seguros sequer que serão, uma vez que
as estatísticas do kernel em outras máquinas normalmente
monitora tanto a taxa de transferência quanto E/S por
segundo e este somente permite um campo por dispositivo.

page 5741 1808
O número de páginas que entraram no sistema e o número de
páginas que sairam (do disco).

swap 1 0
O número de páginas de troca que foram recebidas e
enviadas de/para a área de troca.

intr 1462898
O número de interrupções recebidas a partir da
inicialização do sistema.

ctxt 115315
O número de mudanças de contexto que o sistema realizou.

btime 769041601
Tempo de inicialização, em segundos desde 1 de Janeiro de
1970.

sys Este diretório, presente desde a versão 1.3.57, contém um número
de arquivos e subdiretórios correspondente às variáveis do
kernel. Estas variáveis podem ser lidas e algumas vezes
modificadas usando-se o sistema de arquivos proc, e usando a
chamada ao sistema sysctl(2). Atualmente estão presentes os
subdiretórios kernel, net, vm e cada um contém diversos arquivos
e subdiretórios.

kernel Contém os arquivos domainname, file-max, file-nr,
hostname, inode-max, inode-nr, osrelease, ostype, panic,
real-root-dev, securelevel, version. com funções
bastante claras para o nome.

O arquivo somente para leitura file-nr fornece o número de
arquivos atualmente abertos.

O arquivo file-max fornece o número máximo de arquivos abertos
que o kernel pode administrar. Caso 1024 não seja suficiente,
pode-se tentar o comando
echo 4096 > /proc/sys/kernel/file-max

Similarmente, os arquivos inode-nr e inode-max indicam o número
atual e o número máximo de inodes.

Os arquivos ostype, osrelease, e version fornecem informações
retiradas de /proc/version.

O arquivo panic fornece acesso para leitura e gravação da
variável do kernel panic_timeout. Caso seja igual a zero, o
kernel irá testar esta variável sucessivamente; caso seja
diferente de zero indica que o kernel deve se auto reinicializar
após o número de segundos indicado.

O arquivo securelevel parece sem significado no momento - o
superusuário tem todos os recursos do sistema.

uptime Este arquivo contém dois números: o tempo de atividade do
sistema em segundos e o tempo gasto com o processamento de
processos em segundos.

version
Identifica a versão do kernel que está sendo executada. Por
exemplo:
Linux versão 1.09 (quinlan@phaze) #1 Dom Nov 19 01:51:54 EDT 1998.

VEJA TAMBÉM

       cat(1), find(1), free(1), mount(1), ps(1), tr(1), uptime(1),
       readlink(2), mmap(2), chroot(2), syslog(2), hier(7), arp(8), dmesg(8),
       netstat(8), route(8), ifconfig(8), procinfo(8) e muito mais

EM CONFORMIDADE COM

       Este texto está em razoável conformidade com o kernel 1.3.11. Por favor
       atualize caso necessário.

       Última atualuzação no Linux 1.3.11.

DICAS

       Note que muitas cadeias de caracteres (por exemplo o ambiente e a linha
       de comando) estão no formato interno, com subcampos separados por bytes
       contendo o caracter nulo. Pode-se tornar as informações mais claras
       caso se utilize od -c ou tr "\000" "\n" para acessá-las.

       Esta página de manual não é completa e possivelmente contenha alguns
       erros, e precisa ser atualizada freqüentemente.

PROBLEMAS

       O sistema de arquivos /proc pode gerar problemas de segurança em
       processos executados com chroot(2).  Por exemplo, se /proc é montado na
       hierarquia chroot, um chdir(2) para /proc/1/root retornará para o raiz
       original do sistema de arquivos. Isso pode ser considerada uma
       facilidade ao invés de um erro, uma vez que o Linux não suporta a
       chamada fchroot(2).

TRADUZIDO POR LDP-BR em 21/08/2000.

       André L. Fassone Canova <lonelywofl@blv.com.br> (tradução) Carlos
       Augusto Horylka <horylka@conectiva.com.br> (revisão)

                                  22/07/1996                           PROC(5)