apxs - Online na nuvem

PROGRAMA:

NOME

apxs - ferramenta APache eXtenSion

SINOPSE

apxs -g [-S nome=valor ] -n nome do mod

apxs -q [-v ] [-S nome=valor ] pergunta ...

apxs -c [-S nome=valor ] [-o dsofile ] [-I incdir ] [-D nome=valor ] [-L libdir ] [
-l nome da biblioteca ] [-wc,sinalizadores de compilador ] [-Bem,sinalizadores de linker ] arquivos ...

apxs -i [-S nome=valor ] [-n nome do mod ] [-a ] [-A ] arquivo dso ...

apxs -e [-S nome=valor ] [-n nome do mod ] [-a ] [-A ] arquivo dso ...

RESUMO

apxs é uma ferramenta para construir e instalar módulos de extensão para o Apache HyperText
Servidor de protocolo de transferência (HTTP). Isso é obtido através da construção de um objeto compartilhado dinâmico
(DSO) de uma ou mais fontes ou objetos arquivos que então pode ser carregado no Apache
servidor em tempo de execução por meio da diretiva LoadModule de mod_so.

Portanto, para usar este mecanismo de extensão, sua plataforma deve suportar o recurso DSO e seu
O binário Apache httpd deve ser construído com o módulo mod_so. A ferramenta apxs automaticamente
reclama se este não for o caso. Você pode verificar isso executando manualmente o
comando

$ httpd-l

O módulo mod_so deve fazer parte da lista exibida. Se esses requisitos forem
cumprido, você pode facilmente estender a funcionalidade do seu servidor Apache instalando o seu próprio
módulos com o mecanismo DSO com a ajuda desta ferramenta apxs:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I / path / to / apache / include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /caminho/para/apache/modules/mod_foo.so
chmod 755 /caminho/para/apache/modules/mod_foo.so
[ativando o módulo `foo 'em /path/to/apache/etc/httpd.conf]
$ apachectl reiniciar
/ caminho / para / apache / sbin / apachectl restart: httpd não está em execução, tentando iniciar
[Ter, 31 de março 11:27:55 1998] [depurar] mod_so.c(303): módulo carregado foo_module
/ caminho / para / apache / sbin / apachectl reiniciar: httpd iniciado
$_

Os argumentos arquivos pode ser qualquer arquivo de origem C (.c), um arquivo de objeto (.o) ou mesmo uma biblioteca
arquivo (.a). A ferramenta apxs reconhece automaticamente essas extensões e automaticamente
usou os arquivos de origem C para compilação enquanto apenas usava o objeto e os arquivos de arquivo para
a fase de ligação. Mas ao usar esses objetos pré-compilados, certifique-se de que eles estão compilados
para o código independente de posição (PIC) ser capaz de usá-los para um compartilhamento carregado dinamicamente
objeto. Por exemplo, com o GCC, você sempre precisa usar -fpic. Para outros compiladores C
consulte sua página de manual ou observe os sinalizadores que o apxs usa para compilar os arquivos de objeto.

Para obter mais detalhes sobre o suporte DSO no Apache, leia a documentação do mod_so ou talvez
até mesmo leia o arquivo de origem src / modules / standard / mod_so.c.

OPÇÕES

comum Opções
-n nome do mod
Isso define explicitamente o nome do módulo para o -i (instalar) e -g (modelo
geração). Use para especificar explicitamente o nome do módulo. Para a opção -g
isso é necessário, para a opção -i a ferramenta apxs tenta determinar o nome do
fonte ou (como um fallback) pelo menos adivinhando-o a partir do nome do arquivo.

pergunta Opções
-q Executa uma consulta para variáveis ​​e configurações de ambiente usadas para construir httpd. Quando
invocado sem pergunta parâmetros, ele imprime todas as variáveis ​​conhecidas e seus valores.
O parâmetro opcional -v formata a saída da lista. .PP Use isto para manualmente
determine as configurações usadas para construir o httpd que carregará seu módulo. Por exemplo
use INC = -I`apxs -q INCLUDEDIR` .PP dentro de seus próprios Makefiles se precisar do manual
acesso aos arquivos de cabeçalho C do Apache.

Configuração Opções
-S nome=valor
Esta opção altera as configurações do apxs descritas acima.

Modelo Geração Opções
-g Isso gera um subdiretório nome (consulte a opção -n) e há dois arquivos: Uma amostra
arquivo de origem do módulo denominado mod_nome.c que pode ser usado como um modelo para a criação
seus próprios módulos ou como um início rápido para brincar com o mecanismo apxs. E um
Makefile correspondente para uma construção e instalação ainda mais fácil deste módulo.

DSO Compilação Opções
-c Indica a operação de compilação. Ele primeiro compila os arquivos de origem C (.c)
of arquivos em arquivos de objetos correspondentes (.o) e, em seguida, cria um compartilhamento dinamicamente
objeto em dsofile vinculando esses arquivos de objeto mais os arquivos de objeto restantes (.o
e .a) de arquivos. Se nenhuma opção -o for especificada, o arquivo de saída será calculado a partir do
primeiro nome de arquivo em arquivos e, portanto, geralmente o padrão é mod_nome.tão.

-o dsofile
Especifica explicitamente o nome do arquivo do objeto compartilhado dinamicamente criado. Se não
especificado e o nome não pode ser adivinhado a partir do arquivos lista, o nome substituto
mod_unknown.so é usado.

-D nome=valor
Esta opção é passada diretamente para o (s) comando (s) de compilação. Use isso para
adicione suas próprias definições ao processo de construção.

-I incdir
Esta opção é passada diretamente para o (s) comando (s) de compilação. Use isso para
adicione seus próprios diretórios de inclusão para pesquisar no processo de construção.

-L libdir
Essa opção é passada diretamente para o comando do vinculador. Use isto para adicionar o seu
próprios diretórios de biblioteca para pesquisar o processo de construção.

-l nome da biblioteca
Essa opção é passada diretamente para o comando do vinculador. Use isto para adicionar o seu
próprias bibliotecas para pesquisar o processo de construção.

-Banheiro,sinalizadores de compilador
Esta opção passa sinalizadores de compilador como sinalizadores adicionais para libtool --mode = compile
comando. Use isso para adicionar opções específicas do compilador local.

-Wl,sinalizadores de linker
Esta opção passa sinalizadores de linker como sinalizadores adicionais para o link libtool --mode =
comando. Use isso para adicionar opções específicas do vinculador local.

-p Esta opção faz com que apxs se vincule às bibliotecas apr / apr-util. Isso é útil
ao compilar programas auxiliares que usam as bibliotecas apr / apr-util.

DSO Instalação e Configuração Opções
-i Isso indica a operação de instalação e instala um ou mais dinamicamente
objetos compartilhados no servidor módulos diretório.

-a Isso ativa o módulo adicionando automaticamente uma linha LoadModule correspondente
ao arquivo de configuração httpd.conf do Apache, ou habilitando-o se já existir.

-A O mesmo que a opção -a, mas a diretiva LoadModule criada é prefixada com um sinal de hash
(#), ou seja, o módulo está apenas preparado para ativação posterior, mas inicialmente desativado.

-e Isso indica a operação de edição, que pode ser usada com as opções -a e -A
similarmente à operação -i para editar o arquivo de configuração httpd.conf do Apache
sem tentar instalar o módulo.

EXEMPLOS

Suponha que você tenha um módulo Apache chamado mod_foo.c disponível que deve estender o do Apache
funcionalidade do servidor. Para fazer isso, você primeiro precisa compilar o código-fonte C em um
objeto compartilhado adequado para carregar no servidor Apache em tempo de execução através do seguinte
comando:

$ apxs -c mod_foo.c
/ caminho / para / libtool --mode = compilar gcc ... -c mod_foo.c
/ caminho / para / libtool --mode = link gcc ... -o mod_foo.la mod_foo.slo
$_

Então você tem que atualizar a configuração do Apache, certificando-se de que a diretiva LoadModule é
presente para carregar este objeto compartilhado. Para simplificar esta etapa, apxs fornece uma maneira automática
para instalar o objeto compartilhado em seu diretório "modules" e atualizar o arquivo httpd.conf
adequadamente. Isso pode ser conseguido executando:

$ apxs -i -a mod_foo.la
/path/to/instdso.sh mod_foo.la / path / to / apache / modules
/ path / to / libtool --mode = install cp mod_foo.la / path / to / apache / modules
...
chmod 755 /caminho/para/apache/modules/mod_foo.so
[ativando o módulo `foo 'em /path/to/apache/conf/httpd.conf]
$_

Desta forma, uma linha chamada

LoadModule foo_module modules / mod_foo.so

é adicionado ao arquivo de configuração se ainda não estiver presente. Se você quiser ter isso desativado
por padrão, use a opção -A, ou seja

$ apxs -i -A mod_foo.c

Para um teste rápido do mecanismo apxs, você pode criar um modelo de módulo Apache de amostra mais
um Makefile correspondente via:

$ apxs -g -n foo
Criando [DIR] foo
Criando [FILE] foo / Makefile
Criando [FILE] foo / modules.mk
Criando [FILE] foo / mod_foo.c
Criando [FILE] foo / .deps
$_

Então você pode compilar imediatamente este módulo de amostra em um objeto compartilhado e carregá-lo em
o servidor Apache:

$ cd foo
$ fazer tudo recarregar
apxs -c mod_foo.c
/ caminho / para / libtool --mode = compilar gcc ... -c mod_foo.c
/ caminho / para / libtool --mode = link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/path/to/instdso.sh mod_foo.la / path / to / apache / modules
/ path / to / libtool --mode = install cp mod_foo.la / path / to / apache / modules
...
chmod 755 /caminho/para/apache/modules/mod_foo.so
[ativando o módulo `foo 'em /path/to/apache/conf/httpd.conf]
reiniciar apachectl
/ caminho / para / apache / sbin / apachectl restart: httpd não está em execução, tentando iniciar
[Ter, 31 de março 11:27:55 1998] [depurar] mod_so.c(303): módulo carregado foo_module
/ caminho / para / apache / sbin / apachectl reiniciar: httpd iniciado
$_

Use apxs online usando serviços onworks.net