Expat, versione 2.1.0

Questo è Expat, una libreria C per l'analisi di XML, scritta da James Clark. Expat è un parser XML orientato allo stream. Ciò significa che è necessario registrare handler presso il parser prima di iniziare l'analisi. Questi handler vengono chiamati quando il parser rileva le strutture associate nel documento in fase di analisi. Un tag di apertura è un esempio del tipo di strutture per le quali è possibile registrare handler.

Gli utenti Windows dovrebbero usare il pacchetto expat_win32bin, che include sia librerie ed eseguibili precompilati, sia il codice sorgente per gli sviluppatori.

Expat è software libero. Puoi copiarlo, distribuirlo e modificarlo secondo i termini della Licenza contenuta nel file COPYING distribuito con questo pacchetto. Questa licenza è la stessa della licenza MIT/X Consortium.

Le versioni di Expat con numero di versione minore dispari (il numero centrale nella versione sopra riportata) sono release di sviluppo e vanno considerate come software beta. Le release con numero di versione minore pari sono pensate per essere software di livello produttivo.

Se stai compilando Expat da un checkout del repository CVS, devi eseguire uno script che genera lo script configure usando gli strumenti GNU autoconf e libtool. Per farlo, devi avere autoconf 2.58 o successivo. Esegui lo script in questo modo:

    ./buildconf.sh

Dopo aver fatto questo, segui le stesse istruzioni previste per la compilazione da una distribuzione sorgente.

Per compilare Expat da una distribuzione sorgente, devi prima eseguire lo script di configurazione shell nella directory di livello superiore della distribuzione:

    ./configure

Ci sono molte opzioni che puoi fornire a configure (che puoi scoprire eseguendo configure con l'opzione --help). Ma quella di maggiore interesse è quella che imposta la directory di installazione. Di default, lo script configure imposterà le cose per installare libexpat in /usr/local/lib, expat.h in /usr/local/include e xmlwf in /usr/local/bin. Se, ad esempio, preferisci installare in /home/me/mystuff/lib, /home/me/mystuff/include e /home/me/mystuff/bin, puoi comunicarlo a configure con:

    ./configure --prefix=/home/me/mystuff

Un'altra opzione interessante è abilitare il supporto agli interi a 64 bit per i numeri di riga e colonna e l'indice complessivo dei byte:

    ./configure CPPFLAGS=-DXML_LARGE_SIZE

Tuttavia, una tale modifica rappresenterebbe una modifica incompatibile (breaking change) all'ABI e pertanto non è raccomandata per l'uso generale - ad es. come parte di una distribuzione Linux - ma piuttosto per build con requisiti speciali.

Dopo aver eseguito lo script configure, il comando "make" compilerà i componenti e "make install" li installerà nella loro posizione appropriata. Dai un'occhiata al "Makefile" per scoprire ulteriori opzioni di "make". Nota che devi avere il permesso di scrittura nelle directory in cui i componenti verranno installati.

Se sei interessato a compilare Expat per fornire informazioni documentali in codifica UTF-16 invece della UTF-8 predefinita, segui queste istruzioni (dopo aver eseguito "make distclean"):

    1. Per l'output UTF-16 come unsigned short (e le stringhe di versione/errore
       come char), esegui:

           ./configure CPPFLAGS=-DXML_UNICODE

       Per l'output UTF-16 come wchar_t (incluse le stringhe di versione/errore),
       esegui:

           ./configure CFLAGS="-g -O2 -fshort-wchar" \
                       CPPFLAGS=-DXML_UNICODE_WCHAR_T

    2. Modifica il MakeFile, cambiando:

           LIBRARY = libexpat.la

       in:

           LIBRARY = libexpatw.la

       (Nota la "w" aggiuntiva nel nome della libreria.)

    3. Esegui "make buildlib" (che compila solo la libreria).
       Oppure, per saltare il punto 2, esegui "make buildlib LIBRARY=libexpatw.la".

    4. Esegui "make installlib" (che installa solo la libreria).
       Oppure, se il punto 2 è stato omesso, esegui "make installlib LIBRARY=libexpatw.la".

L'uso di DESTDIR o INSTALL_ROOT è abilitato, con INSTALL_ROOT come valore predefinito per DESTDIR, e il resto del make file utilizza solo DESTDIR. Funziona come segue: $ make install DESTDIR=/path/to/image sovrascrive il DESTDIR impostato nel makefile, mentre entrambi $ INSTALL_ROOT=/path/to/image make install $ make install INSTALL_ROOT=/path/to/image usano DESTDIR=$(INSTALL_ROOT), anche se DESTDIR è eventualmente definito nell'ambiente, perché la priorità di impostazione delle variabili è

riga di comando
makefile
ambiente

Nota: questo vale solo per la libreria Expat stessa; la creazione di versioni UTF-16 di xmlwf e dei test non è attualmente supportata.

Nota per gli utenti Solaris: il comando "ar" si trova di solito in "/usr/ccs/bin", che non è nel PATH predefinito. Dovrai aggiungerlo al tuo percorso per il comando "make", e probabilmente anche passare a GNU make (il "make" che si trova in /usr/ccs/bin non sembra funzionare correttamente -- a quanto pare non comprende le direttive .PHONY). Se stai usando ksh o bash, usa questo comando per compilare:

    PATH=/usr/ccs/bin:$PATH make

Quando usi Expat con un progetto che utilizza autoconf per la configurazione, puoi usare la macro di rilevamento in conftools/expat.m4 per determinare come includere Expat. Vedi i commenti all'inizio di quel file per ulteriori informazioni.

Un manuale di riferimento è disponibile nel file doc/reference.html in questa distribuzione.

La homepage di questo progetto è http://www.libexpat.org/. Lì ci sono link che ti portano alla pagina delle segnalazioni di bug. Se hai bisogno di segnalare un bug quando non hai accesso a un browser, puoi anche inviare una segnalazione via email a [email protected].

La discussione relativa alla direzione del futuro sviluppo di Expat si svolge su [email protected]. Gli archivi di questa lista e di altre liste relative a Expat sono disponibili all'indirizzo:

    http://mail.libexpat.org/mailman/listinfo

expat_2_1_0_CVE-2024-28757

Più Popolari