Hai scritto qualche funzione utile in più file C e vuoi riunirle in una libreria da usare in altri programmi, senza copiare ogni volta i sorgenti. Oppure devi capire cosa c'è dentro un file libqualcosa.a trovato in /usr/lib. In entrambi i casi serve ar.
Cos'è
ar (archiver) è un programma che riunisce più file in un unico archivio. Il suo uso principale è creare le librerie statiche, i file con estensione .a: un archivio di file oggetto (.o) che il linker sa leggere e da cui prende solo i pezzi che servono. Fa parte del pacchetto binutils (sudo apt install binutils, spesso già presente).
Un archivio ar assomiglia a un tar, ma è pensato per le librerie: oltre ai file contiene un indice dei simboli, che permette al linker di trovare in fretta quale membro definisce quale funzione.
Cosa fa
Con ar si possono creare un archivio, aggiungere o sostituire membri, cancellarli, elencarli ed estrarli. A differenza delle librerie condivise (.so), il codice di una libreria statica viene copiato dentro l'eseguibile al momento del collegamento: il programma finale non ne dipende più a runtime.
Come si usa
$ ar [operazione][modificatori] archivio [file...]La sintassi è insolita: la prima "parola" è un gruppo di lettere senza trattino, con una operazione (r inserisci, t elenca, x estrai, d cancella, p stampa) e dei modificatori (c crea senza messaggi, s scrive l'indice, v verboso). Gli esempi usano tre file C di prova (somma.c, prodotto.c, doppio.c) già compilati in .o, e un main.c che usa le prime due. Gli output sono reali, su Ubuntu 24.04 (binutils 2.42).
Esempio 1: creare una libreria ed elencarne il contenuto
$ ar rcs libmat.a somma.o prodotto.o
$ ar t libmat.a
somma.o
prodotto.o
$ ar tv libmat.a
rw-r--r-- 0/0 1232 Jan 1 01:00 1970 somma.o
rw-r--r-- 0/0 1240 Jan 1 01:00 1970 prodotto.orcs è la combinazione classica: r inserisce i file (sostituendo quelli con lo stesso nome), c crea l'archivio senza il messaggio creating, s aggiorna l'indice. t elenca i membri, e tv aggiunge permessi, proprietario, dimensione e data. Qui la data è sempre "1 gennaio 1970" e il proprietario 0/0: su Ubuntu ar lavora per default in modalità deterministica, che azzera questi dati perché due compilazioni degli stessi file diano lo stesso archivio. Nel test, un u (aggiorna solo se più recente) è stato ignorato con un avviso che lo dice.
Esempio 2: usare la libreria in un programma
$ gcc -o main main.o -L. -lmat
$ ./main
5 6-L. dice al linker di cercare anche nella cartella corrente, -lmat di usare libmat.a (si toglie il prefisso lib e l'estensione). Il programma stampa 5 e 6, cioè somma e prodotto di 2 e 3. Di norma, con -lmat il linker preferisce la versione condivisa .so se esiste, altrimenti usa la .a: in questo test c'era solo la statica.
Esempio 3: l'indice dei simboli
$ nm -s libmat.a | sed -n '/Archive index/,/^$/p'
Archive index:
somma in somma.o
prodotto in prodotto.o
Il modificatore s crea l'indice che dice, per ogni simbolo, in quale membro si trova; si legge con nm -s (dettagli nell'articolo su nm). Se si usa ar senza s su un'installazione che non lo aggiunge da sola, l'indice può mancare e il linker non trova i simboli. Nel mio test anche ar r senza s lo ha prodotto comunque, ma la scelta più sicura resta usare sempre rcs. Il comando ranlib serve a rigenerare l'indice di un archivio esistente.
Esempio 4: aggiungere, sostituire, cancellare, estrarre
$ ar r libmat.a doppio.o
$ ar t libmat.a
somma.o
prodotto.o
doppio.o
$ ar r libmat.a somma.o # somma.o ricompilato con un'altra versione
$ gcc -o main main.o -L. -lmat; ./main
105 6
$ ar d libmat.a doppio.o
$ ar t libmat.a
somma.o
prodotto.o
$ mkdir est; cd est; ar x ../libmat.a; ls
prodotto.o somma.o
$ ar p ../libmat.a prodotto.o | head -c 4 | od -c | head -1
0000000 177 E L Fr aggiunge un membro nuovo o sostituisce quello con lo stesso nome: dopo aver ricompilato somma.c con una modifica (+100) e rieseguito ar r, il programma ricollegato stampa 105 invece di 5. d cancella un membro, x estrae tutti i file (o solo quelli indicati) nella cartella corrente, e p stampa il contenuto di un membro sullo standard output: qui i primi byte mostrano la firma ELF dei file oggetto.
Esempio 5: attenzione all'aggiunta con q
$ ar q dup.a somma.o
ar: creating dup.a
$ ar q dup.a somma.o
$ ar t dup.a
somma.o
somma.oq (quick append) aggiunge in coda senza controllare se esiste già un membro con lo stesso nome, e senza aggiornare l'indice: si ottengono duplicati. Per le normali operazioni conviene r, che sostituisce.
Esempio 6: uso negli script
#!/bin/bash
# Crea una libreria statica da zero a partire da file oggetto e ne mostra il contenuto
[ $# -ge 2 ] || { echo "Uso: $0 libreria.a oggetto.o..." >&2; exit 2; }
command -v ar >/dev/null || { echo "ar non trovato (binutils)" >&2; exit 3; }
lib=$1; shift
for f in "$@"; do
[ -f "$f" ] || { echo "$f: file inesistente" >&2; exit 1; }
case $f in *.o) ;; *) echo "$f: non e' un file .o" >&2; exit 1 ;; esac
done
tmp=$(mktemp "${lib}.XXXXXX") || exit 1
trap 'rm -f "$tmp"' EXIT
rm -f "$tmp"
ar rcs "$tmp" "$@" || exit 1
mv "$tmp" "$lib"
trap - EXIT
echo "$lib: $(ar t "$lib" | wc -l) membri, $(nm -s "$lib" | grep -c ' in ') simboli"Lo script ricostruisce sempre la libreria da zero (così non restano membri vecchi), la scrive prima in un file temporaneo e poi la sposta al posto di quella vecchia, e alla fine stampa il numero di membri e di simboli. Controlla che i file esistano e finiscano in .o. Esce con 0 se va tutto bene, 1 se un file manca o non è un .o, 2 senza argomenti e 3 se ar non c'è. Nei miei test con due file oggetto ha stampato libnew.a: 2 membri, 2 simboli e non ha lasciato file temporanei; con un file inesistente e con main.c si è fermato con codice 1, senza toccare la libreria esistente. Non verifica che i .o siano davvero file oggetto validi: se non lo sono, lo segnala ar.
Opzioni utili
r: inserisce o sostituisce membri.q: aggiunge in coda (senza controllare i duplicati).t/tv: elenca i membri, con dettagli.x: estrae (tutti o quelli indicati).p: stampa il contenuto di un membro.d: cancella membri dall'archivio.c: crea l'archivio senza messaggi.s: scrive o aggiorna l'indice dei simboli.v: modalità verbosa.D/U: modalità deterministica (data e proprietario azzerati) o con i dati reali dei file.a membro/b membro: conrom, posiziona dopo o prima di un certo membro. Non l'ho provato.
Attenzione a
- La sintassi è senza trattino.
ar rcs lib.a a.oè corretto: l'ordine è operazione e modificatori, poi archivio, poi file. Scambiare archivio e file di input può sovrascrivere un file per errore. - Il nome deve seguire la convenzione. Per usarla con
-lnomela libreria deve chiamarsilibnome.a. - L'indice dei simboli. Una libreria senza indice può causare errori di collegamento. Usa
s(oranlib) quando la crei o la modifichi. - Il membro si identifica dal nome.
arnon ricorda i percorsi: due file con lo stesso nome in cartelle diverse si sostituiscono a vicenda conr. - Dati azzerati di default. Su Ubuntu data e proprietario dei membri risultano azzerati:
ar tvnon dice quando il file è stato compilato. - Messaggi su stderr. Il messaggio
creatinge gli errori vanno su stderr. Se l'archivio non esiste,ar tesce con codice 9; su un file che non è un archivio con codice 1. Un file inesistente passato aar rdà errore con codice 1; nel mio testar r x.a nonce.onon ha lasciato alcunx.a. - Una libreria statica va ricostruita per aggiornare. Se modifichi un sorgente, devi ricompilare il
.o, aggiornare l'archivio conare ricollegare i programmi che la usano: nel programma già collegato il codice è una copia.
Riepilogo
| Comando | Cosa fa |
|---|---|
ar rcs libx.a a.o b.o | Crea (o aggiorna) la libreria con indice |
ar t libx.a | Elenca i membri |
ar tv libx.a | Elenca i membri con dettagli |
ar r libx.a c.o | Aggiunge o sostituisce un membro |
ar d libx.a c.o | Cancella un membro |
ar x libx.a [membro] | Estrae i file |
ar p libx.a membro | Stampa il contenuto di un membro |
gcc -o prog main.o -L. -lx | Collega il programma con libx.a |