Gentoo Logo

Documentazione per apache-module.eclass

Indice:

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:

Codice 3.1: esempio

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

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

Codice 3.2: esempio

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:

Codice 3.3: esempio

<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)



Stampa

Aggiornato il 23 marzo 2008

Oggetto: Documentazione auto-generata per apache-module.eclass

apache-devs@gentoo.org
Autore

Davide Cendron
Traduzione

Donate to support our development efforts.

Copyright 2001-2014 Gentoo Foundation, Inc. Questions, Comments? Contact us.