C/C++ Libs

February 12, 2024

ThiagoLA92

🍫🍫🍫

Durante a faculdade eu aprendi C
- Abri Visual Studio
- Escrevi código em C
- Executei
Recentemente eu usei C++ no projeto Godot
- Segui instrução do Godot para configurar o VSCode
- Escrevi código em C++
- Executei

Em ambos os casos eu nunca aprendi direito sobre bibliotecas... Notei claramente quando segui as instruções de projeto para Build from Source e não sabia mais o que fazer com os arquivos .a e .so gerados.

Desenho de um rosto rindo que nem idiota

Eu sabia que poderia compilar C/C++ com GCC ou Clang, mas meu conhecimento se resumia a compilar projetos 100% meus.

gcc main.c -o main

Bem, vamos entender cada um dois formatos primeiro.

`.a` (archive)

Se trata de uma biblioteca estática (static library), ou seja, podemos ver como um conjunto de funções/variáveis que seram anexadas ao seu executável durante a etapa de compilação (na etapa do linker).

Ótimo quando você quer que seu programa tenha toda a lógica.

`.so` (shared object)

Se trata de uma biblioteca compartilhada (shared library), ou seja, podemos ver como um executável que será utilizado por qualquer programa que precise dele (ainda é preciso avisar ao linker da existencia da biblioteca).

Ótimo pois ocupa menos espaço do computador da pessoa com a mesma lógica.

GCC 4 Steps

Eu já mencionei linker duas vezes, para entender o que ele é precisamos olhar para cada etapa do GCC.

Um resumo seria:

Preprocessor
- Responsável por fazer pré processamentos, o mais popular é a substituição de #include pelo código dentro dos headers (.h).
- A saída dessa etapa é conhecida como translation unit (ainda é código C).
Compiler
- Responsável por converter o código C para código assembly.
Assembler
- Responsável por converter o código assembly para um object code, ele é formado de código de máquina (código especifico para rodar naquela máquina) e "referências" a serem encontradas.
  - Por exemplo, você pode referênciar a função void do_it() mas ela não estar neste arquivo .c.
Linker
- Responsável por encontrar as referências de um arquivo e linkar elas, a saída é justamente o executável final.

Project from Zero

Começamos com uma estrutura bem vazia de projeto:

project/
└── src/
    ├── main.c
    └── ...

Apens possuimos código nosso, então tudo que precisamos fazer para criar o executável é

gcc src/main.c -o main

Algum momento do nosso projeto decidimos usar bibliotecas de terceiro e não queremos misturar ela com o nosso código então resolvemos sempre separar os arquivos dela em outros diretórios.

O primeiro tipo de arquivo que bibliotecas trazem junto são os headers, utilizados justamente para o compilador conseguir determinar o que exatamente tem que buscar nas bibliotecas.

project/
├── include/
│   └── header.h
└── src/
    ├── main.c
    └── ...

Podemos adicionar um diretório onde se buscar headers com o argumento -I seguido pelo diretório (não é separado por espaço):

gcc src/main.c -o main -Iinclude

Agora podemos adicionar #include <header.h> sem o compilador reclamar que header.h não foi encontrado.

Se tentarmos chamar uma função que está no header.h ainda teremos erro pois não temos a função, apenas a assinatura dela. Nós precisamos do código da função, que pode estar em um .so ou .a.

warning

Saiba se sua biblioteca é C++ ou C para saber se deve usar gcc ou g++.
Se ambos tipos de bibliotecas existirem o linker vai priorizar procurar o .so.

`.a`

Novamente não vamos querer misturar este arquivo com os do nosso projeto, então vamos deixar a biblioteca na pasta lib.

project/
├── include/
│   └── header.h
├── lib/
│   └── libname.a
└── src/
    ├── main.c
    └── ...

Podemos passar ao compilador diretório onde as nossas bibliotecas se encontram com o argumento -L seguido pelo diretório (não é separado por espaço):

gcc src/main.c -o main -Iinclude -Llib

Precisamos especificar as que desajamos usar e isso é feito com o argumento -l seguido pelo nome base da biblitoeca (não é separado por espaço):

gcc src/main.c -o main -Iinclude -Llib -lname

note

-lname vai buscar pela biblioteca libname.a, este é um atalho para referênciar bibliotecas.
-l:libname.a pode ser usado em casos que o nome da biblioteca não segue estes padrões ou precise forçar o uso da static.

info

Muitos pacotes de bibliotecas em Linux providenciam o .a quando baixamos a versão -dev delas. Por exemplo:

sudo apt install libxcb-xinput-dev

No meu caso, agora posso encontrar o libxcb-xinput.a em /usr/lib/x86_64-linux-gnu/.

`.so`

Segue basicamente a mesma lógica do .a, deixar a biblioteca no diretório lib.

project/
├── include/
│   └── header.h
├── lib/
│   └── libname.so
└── src/
    ├── main.c
    └── ...

Passar ao compilador diretório onde as nossas bibliotecas se encontram com o argumento -L seguido pelo diretório (não é separado por espaço):

gcc src/main.c -o main -Iinclude -Llib

No caso de bibliotecas compartilhadas este diretório pode possuir centenas de bibliotecas, então faz sentido você ter que especificar as que você quer usar. Novamente usamos o argumento -l seguido pelo nome base da biblitoeca (não é separado por espaço):

gcc src/main.c -o main -Iinclude -Llib -lname

note

-lname vai buscar pela biblioteca libname.so, este é um atalho para referênciar bibliotecas.
-l:libname.so pode ser usado em casos que o nome da biblioteca não segue estes padrões.

Durante a execução do código o sistema operacional vai buscar a biblioteca em lugares predefinidos (linux busca em lugares como /usr/lib).

Mas se nossa biblioteca não for estar em um destes lugares predefinidos? Ainda é possível adicionar lugares onde se buscar durante a execução.

Podemos passar argumentos ao linker com -Wl seguido pelos argumentos que ele deve receber, no caso -Rlib (argumentos separados por virgula):

gcc src/main.c -o main -Iinclude -Llib -lname -Wl,-Rlib

Nosso executável agora vai sempre tentar buscar a biblioteca na pasta lib que estiver no mesmo diretório que ele.

warning

Bibliotecas compartilhadas podem depender de outras bibliotecas compartilhadas. Nestes casos o linker irá utilizar a mesma lógica vista acima para buscar as dependências.

Caso precise saber das dependências da sua biblioteca, pode utilizar:

ldd libname.so

.a (archive)​

.so (shared object)​

GCC 4 Steps​

Project from Zero​

.a​

.so​

References​