Documentazione per apache-module.eclass

1.  NOME

apache-module.eclass - Fornisce un insieme generale di funzioni per i moduli apache

2.  DESCRIZIONE

Questa eclass gestisce i moduli apache in modo ottimale.

Per far uso di questa eclass basta chiamare una delle funzioni need/want_apache descritte in depend.apache.eclass. Assicurarsi di usare la chiamata need/want_apache dopo aver definito le variabili DEPEND e RDEPEND. Notare inoltre che si può fare affidamento sull'automatismo RDEPEND=DEPEND che portage fa se si usa questa eclass.

Vedere il Bug 107127 per maggiori informazioni.

3.  ESEMPIO

Questo è un semplice esempio di un ebuild per mod_foo:

APACHE2_MOD_CONF="42_mod_foo"
APACHE2_MOD_DEFINE="FOO"
need_apache2

Un esempio più complicato per un modulo con locazioni non standard:

APXS2_S="${S}/apache22/src"
APACHE2_MOD_FILE="${APXS2_S}/${PN}.so"
APACHE2_MOD_CONF="42_${PN}"
APACHE2_MOD_DEFINE="FOO"
DOCFILES="docs/*.html"
need_apache2_2

Una configurazione base di un modulo che carica solamente il modulo in apache:

<IfDefine FOO>
LoadModule foo_module modules/mod_foo.so
</IfDefine>

4.  FUNZIONI

apache-module_src_compile

L'azione predefinita è chiamare ${APXS} con il valore di ${APXS2_ARGS}. Se un modulo richiede un'impostazione di compilazione differente da questa, usare ${APXS} nella propria routine src_compile.

apache-module_src_install

Installa i file nelle directory di apache. Il modulo è installato da una directory scelta come sopra (apache_cd_dir). In aggiunta, questa funzione può anche impostare i permessi d'esecuzione sui file elencati in ${APACHE2_EXECFILES}. Il nome del file di configurazione è elencato in ${APACHE2_MOD_CONF} senza l'estensione .conf, per cui se la propria configurazione è 55_mod_foo.conf, APACHE2_MOD_CONF dovrà essere 55_mod_foo. ${DOCFILES} contiene l'elenco dei file che si vogliono rendere disponibili come documentazione.

apache-module_pkg_postinst

Stampa a video le informazioni riguardo al modulo installato e come abilitarlo.

5.  VARIABILI

APXS2_S

Percorso alla directory temporanea di compilazione. (Viene impostata al valore predefinito `${S}/src' se esiste, altrimenti a `${S}')

APXS2_ARGS

Argomenti da passare allo strumento apxs. (Viene impostata al valore predefinito `-c ${PN}.c')

APACHE2_EXECFILES

Elenco di file che verranno installati in ${APACHE_MODULE_DIR} a fianco di ${APACHE2_MOD_FILE}. In aggiunta, questa funzione imposta inoltre i permessi di esecuzioni su tali file.

APACHE2_MOD_CONF

File di configurazione del modulo installato da src_install (senza il suffisso .conf e relativo a ${FILESDIR}).

APACHE2_MOD_DEFINE

Nome di un define (es. FOO) da usare in una espressione condizionale per il caricamento del modulo installato/del suo file di configurazione, definizioni multiple dovrebbero essere separate da spazi.

APACHE2_MOD_FILE

Nome del modulo che src_install installa, senza il suffisso .so. (Viene impostato al valore predefinito `${APXS2_S}/.libs/${PN}.so')

APACHE2_VHOST_CONF

File di configurazione del Virtual host installato da src_install (senza il suffisso .conf e relativo a ${FILESDIR}).

DOCFILES

Se la funzione src_install() esportata è in uso, e ${DOCFILES} è non-zero, vengono eseguite delle funzioni sed per suddividere la documentazione html (se c'è) dalla documentazione normale, e viene eseguito dodoc o dohtml

6.  MANTENITORI

apache-devs@gentoo.org

7.  RIPORTARE BUG

Si prega di riportare eventuali bug tramite http://bugs.gentoo.org/

8.  FILE

/usr/portage/eclass/apache-module.eclass

9.  VEDERE ANCHE

ebuild (5)

I contenuti di questo documento sono rilasciati sotto la licenza Creative Commons - Attribution / Share Alike.