******************************************************************************
*********************************** KHOMP ************************************
****************************** [ K3L - Linux ] *******************************
******************************************************************************

[*] INFORMAÇÕES GERAIS

Para efetuar a instalação da biblioteca, basta seguir os procedimentos
descritos no arquivo 'INSTALL.txt'.

Aplicativos desenvolvidos para versões anteriores da API precisarão de
ligeiras modificações para funcionar com esta nova versão. A documentação
da API traz maiores detalhes sobre como é a compatibilidade com versões
anteriores e sobre estas alterações.

[*] ARQUIVOS E DIRETÓRIOS

A hierarquia é padronizada da seguinte maneira:

/usr/sbin          -- Programas utilitários (kpload, k3lconfig);
/usr/lib           -- Bibliotecas compartilhadas da K3L;
/usr/include       -- Arquivos de cabeçalhos (headers) da K3L;
/usr/doc/khomp     -- Documentação da API e das placas;
/var/log/khomp1.6  -- Diretório de logs;
/etc/khomp/        -- Arquivos de firmware e configurações.

[*] REQUISITOS MÍNIMOS

A K3L exige um sistema operacional com as seguintes configurações mínimas:

  * glibc 2.3.6 ou superior;
  * kernel 2.6.8 ou superior.

Adicionalmente, para utilização do configurador (k3lconfig), são necessárias
as seguintes dependências:

  * dialog versão 1.0-20050306 ou superior.

[*] OTIMIZAÇÃO e DESEMPENHO

Algumas particularidade nas configurações do sistema podem melhorar o
desempenho da biblioteca e das placas Khomp com carga elevada. Entre elas:

  - Kernel mais recente, de preferência 2.6.13 ou superior;

  - Uso do escalonador de disco CFQ, que pode ser selecionado através
    do parâmetro de kernel "elevator=cfq".

[*] UTILIZANDO A BIBLIOTECA

Para usar a biblioteca com o GCC, é interessante observar os
seguintes itens:

 - Para compilar, é necessário utilizar '-ldl' e '-lk3l' como parâmetros
   para o compilador. Caso a aplicação apresente erro ao acessar alguma
   estrutura, utilizar a opção '-fpack-struct' para realinhamento.

 - A K3L é feita para ser utilizadas com aplicativos C++, porém ela pode 
   ser utilizada por aplicativos C através do compilador 'g++', da
   seguinte forma:

       g++ código.c -o programa -ldl -lk3l

  - Para depurar utilizando o GDB, deve-se executar o seguinte comando:

       handle SIG32 pass noprint nostop
