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

[*] INFORMAES GERAIS

Para efetuar a instalao da biblioteca, basta seguir os procedimentos
descritos no arquivo 'INSTALL.txt'.

Aplicativos desenvolvidos para verses anteriores da API precisaro de
ligeiras modificaes para funcionar com esta nova verso. A documentao
da API traz maiores detalhes sobre como  a compatibilidade com verses
anteriores e sobre estas alteraes.

[*] ARQUIVOS E DIRETRIOS

A hierarquia  padronizada da seguinte maneira:

/usr/sbin          -- Programas utilitrios (kpload, k3lconfig);
/usr/lib           -- Bibliotecas compartilhadas da K3L;
/usr/include       -- Arquivos de cabealhos (headers) da K3L;
/usr/doc/khomp     -- Documentao da API e das placas;
/var/log/khomp1.6  -- Diretrio de logs;
/etc/khomp/        -- Arquivos de firmware e configuraes.

[*] REQUISITOS MNIMOS

A K3L exige um sistema operacional com as seguintes configuraes mnimas:

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

Adicionalmente, para utilizao do configurador (k3lconfig), so necessrias
as seguintes dependncias:

  * dialog verso 1.0-20050306 ou superior.

[*] OTIMIZAO e DESEMPENHO

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

  - Kernel mais recente, de preferncia 2.6.13 ou superior;

  - Uso do escalonador de disco CFQ, que pode ser selecionado atravs
    do parmetro de kernel "elevator=cfq".

[*] UTILIZANDO A BIBLIOTECA

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

 - Para compilar,  necessrio utilizar '-ldl' e '-lk3l' como parmetros
   para o compilador. Caso a aplicao apresente erro ao acessar alguma
   estrutura, utilizar a opo '-fpack-struct' para realinhamento.

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

       g++ cdigo.c -o programa -ldl -lk3l

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

       handle SIG32 pass noprint nostop
