renukaselvar/libunwind_cve-2015-3239_afterpatchLibreria C multi-architettura per lo stack unwinding, la generazione di backtrace e la gestione delle eccezioni, utilizzata per debugging, profiling e analisi binaria su Linux, FreeBSD e HP-UX.
-- mode: Outline --
Questa è la versione 1.0 della libreria unwind. Questa libreria supporta diverse combinazioni architettura/sistema operativo:
Linux/x86-64: Funziona bene. Linux/x86: Funziona bene. Linux/ARM: Funziona bene. Linux/IA-64: Completamente testato e supportato. Linux/PARISC: Funziona bene, ma la libreria C manca di unwind-info. HP-UX/IA-64: Funziona per lo più ma noto per avere alcune limitazioni serie. Linux/AArch64: Appena aggiunto. Linux/PPC64: Appena aggiunto. Linux/SuperH: Appena aggiunto. FreeBSD/i386: Appena aggiunto. FreeBSD/x86-64: Appena aggiunto (l'architettura FreeBSD è nota come amd64).
In generale, questa libreria può essere compilata e installata con i seguenti comandi:
$ autoreconf -i # Necessario solo per la build da git. Dipende da libtool.
$ ./configure
$ make
$ make install prefix=PREFIX
dove PREFIX è il prefisso di installazione. Per impostazione predefinita, viene utilizzato un prefisso di /usr/local, in modo che libunwind.a venga installato in /usr/local/lib e unwind.h venga installato in /usr/local/include. Per i test, potrebbe essere utile utilizzare un prefisso di /usr/local.
** Versione 8 e successive
A partire dalla versione 8, il nome preferito per il compilatore Intel IA-64 è "icc" (stesso nome che su x86). Pertanto, la riga di configure dovrebbe essere simile a questa:
$ ./configure CC=icc CFLAGS="-g -O3 -ip" CXX=icc CCAS=gcc CCASFLAGS=-g \
LDFLAGS="-L$PWD/src/.libs"
Per il momento, libunwind deve essere compilato con GCC su HP-UX.
libunwind dovrebbe essere configurato e installato su HP-UX in questo modo:
$ ./configure CFLAGS="-g -O2 -mlp64" CXXFLAGS="-g -O2 -mlp64"
Avvertenza: Lo srotolamento di binari a 32 bit (ILP32) non è supportato al momento.
** Soluzione per versioni precedenti di GCC
GCC v3.0 e GCC v3.2 includono una versione difettosa di sys/types.h. La soluzione è eseguire i seguenti comandi prima di eseguire "configure":
$ mkdir $top_dir/include/sys
$ cp /usr/include/sys/types.h $top_dir/include/sys
GCC v3.3.2 o successivi sono stati corretti e non richiedono questa soluzione.
Per la build per power64 è necessario utilizzare:
$ ./configure CFLAGS="-g -O2 -m64" CXXFLAGS="-g -O2 -m64"
Se il tuo power supporta i registri altivec: $ ./configure CFLAGS="-g -O2 -m64 -maltivec" CXXFLAGS="-g -O2 -m64 -maltivec"
Per verificare se il tuo processore supporta i registri vettoriali (altivec): cat /proc/cpuinfo | grep altivec e dovrebbe avere qualcosa di simile a: cpu : PPC970, altivec supported
Se libunwind sembra non funzionare (il backtrace fallisce), prova a compilarlo con -O0, senza ottimizzazioni. Ci sono alcuni problemi del compilatore a seconda della versione del tuo gcc.
Si applicano le istruzioni generali per la build. Per compilare ed eseguire diversi test, è necessaria la libreria libexecinfo disponibile nei ports come devel/libexecinfo.
Lo sviluppo del port è stato effettuato su FreeBSD 8.0-STABLE. La libreria è stata compilata con il compilatore di sistema che è una versione modificata di gcc 4.2.1, così come con gcc 4.4.3.
Dopo aver compilato la libreria, puoi eseguire un insieme di test di regressione con:
$ make check
** Risultati previsti su IA-64 Linux
A meno che tu non abbia una libreria C e un compilatore molto recenti installati, è attualmente previsto che i seguenti test falliscano su IA-64 Linux:
Gtest-init (dovrebbe passare a partire da glibc-2.3.x/gcc-3.4)
Ltest-init (dovrebbe passare a partire da glibc-2.3.x/gcc-3.4)
test-ptrace (dovrebbe passare a partire da glibc-2.3.x/gcc-3.4)
run-ia64-test-dyn1 (dovrebbe passare a partire da glibc-2.3.x)
Ciò non significa che libunwind non possa essere utilizzato con compilatori più vecchi o librerie C, significa solo che per alcuni casi limite, lo srotolamento fallirà. Poiché sono casi limite, è improbabile che le applicazioni li inneschino.
Nota: Se ottieni molti errori in Gia64-test-nat e Lia64-test-nat, è quasi certamente un segno di un assemblatore vecchio. L'assemblatore GNU solitamente codificava in modo errato gli offset relativi al puntatore dello stack precedente. Questo bug è stato corretto il 21-Set-2004, quindi qualsiasi assemblatore successivo sarà a posto.
** Risultati previsti su x86 Linux
I seguenti test dovrebbero fallire su x86 Linux:
Gtest-resume-sig (non riesce a ottenere SIGUSR2)
Ltest-resume-sig (ugualmente)
Gtest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
Ltest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
test-setjmp (longjmp() non ancora implementato)
run-check-namespace (nessun _Ux86_getcontext ancora)
test-ptrace
** Risultati previsti su x86-64 Linux
I seguenti test dovrebbero fallire su x86-64 Linux:
Gtest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
Ltest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
Gtest-init (vedi http://gcc.gnu.org/bugzilla/show_bug.cgi?id=18743)
Ltest-init (ugualmente)
test-async-sig (crash a causa di unwind-info errato?)
test-setjmp (longjmp() non ancora implementato)
run-check-namespace (nessun _Ux86_64_getcontext ancora)
run-ptrace-mapper (??? da investigare)
run-ptrace-misc (vedi http://gcc.gnu.org/bugzilla/show_bug.cgi?id=18748
e http://gcc.gnu.org/bugzilla/show_bug.cgi?id=18749)
** Risultati previsti su PARISC Linux
Avvertenza: GCC v3.4 o successivo è necessario su PA-RISC Linux. Versioni precedenti del compilatore non riuscivano a generare l'intestazione del programma per la gestione delle eccezioni (GNU_EH_FRAME) necessaria per lo srotolamento.
I seguenti test dovrebbero fallire su x86-64 Linux:
Gtest-bt (backtrace troncato a kill() a causa di mancanza di unwind-info)
Ltest-bt (ugualmente)
Gtest-resume-sig (Gresume.c:my_rt_sigreturn() è sbagliato in qualche modo)
Ltest-resume-sig (ugualmente)
Gtest-init (ugualmente)
Ltest-init (ugualmente)
Gtest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
Ltest-dyn1 (nessun supporto per informazioni di srotolamento dinamico ancora)
test-setjmp (longjmp() non ancora implementato)
run-check-namespace (la toolchain non supporta ancora HIDDEN)
** Risultati previsti su HP-UX
"make check" non è attualmente supportato per HP-UX. Puoi provare a eseguirlo, ma la maggior parte dei test fallirà (e alcuni potrebbero non terminare). Gli unici programmi di test noti per funzionare al momento sono:
tests/bt
tests/Gperf-simple
tests/test-proc-info
tests/test-static-link
tests/Gtest-init
tests/Ltest-init
tests/Gtest-resume-sig
tests/Ltest-resume-sig
** Risultati previsti su PPC64 Linux
"make check" dovrebbe essere eseguito con non più di 10 test su 24 falliti.
Questa distribuzione include alcuni semplici test di prestazioni che danno un'idea del costo base di varie operazioni di libunwind. Dopo aver compilato la libreria, puoi eseguire questi test con i seguenti comandi:
$ cd tests $ make perf
Per favore, indirizza tutte le domande riguardanti questa libreria a:
Puoi farlo inviando una mail a [email protected] con un corpo di:
subscribe libunwind-devel
oppure puoi iscriverti e gestire la tua iscrizione tramite l'interfaccia web all'indirizzo:
https://savannah.nongnu.org/mail/?group=libunwind