ggcov-webdb - On-line na nuvem

PROGRAMA:

NOME

ggcov-webdb - gera banco de dados intermediário para interface web ggcov

SINOPSE

ggcov-webdb [[-r] anuário|lima] ...

DESCRIÇÃO

Ggcov-webdb gera um banco de dados intermediário e uma árvore de arquivos de origem de um desenvolvimento
diretório, na forma de um tarball. Os arquivos neste tarball são usados ​​posteriormente pelo
ggcov Páginas PHP para apresentar dados de cobertura de teste para navegadores WWW.

Os dados de cobertura de teste são produzidos por programas C e C++ compilados com gcc -fprofile-arcos
-teste-cobertura. Então a combinação de ggcov-webdb e ggcov As páginas PHP são basicamente um
Substituição WWW para o gcov programa que vem com gcc.

A abordagem de banco de dados intermediário é usada para lidar com o caso comum em que o desenvolvimento
a máquina e a máquina do servidor web são separadas. O banco de dados contém dados de cobertura em
um formulário indexado, independente de plataforma e compatível com PHP. Como o formato do banco de dados é
independente da plataforma, as páginas PHP podem ser implantadas em servidores web de diferentes
arquitetura para as máquinas de desenvolvimento. Na verdade o ggcov páginas da web suportam qualquer web
servidor que atenda aos seguintes critérios:

· suporta PHP versão 4.3 ou posterior, e

· fornece o dba extensão com o db4 provedor (que ggcov usa para ler o
banco de dados intermediário) e

· fornece o gd extensão (que ggcov usa para gerar os gráficos de barras no
Página de resumo).

O sourceforge.net O servidor web do projeto é um exemplo desse tipo de servidor.

Ggcov-webdb produz um tarball compactado contendo o próprio banco de dados intermediário e
cópias de todos os arquivos de origem mencionados no banco de dados. Isso é tudo
informação que o ggcov páginas da web precisam, em um pacote que seja conveniente para copiar
a máquina de desenvolvimento para o servidor web. Normalmente esse tarball seria extraído em um
subdiretório de /var/ggcov/testes/ no servidor web.

Argumentos são usados ​​para especificar como encontrar arquivos de dados de cobertura. Os argumentos podem
combinações de:

anuário
O diretório é verificado em busca de arquivos de origem, que são tratados como se tivessem sido
especificado na linha de comando (exceto que os arquivos de dados de cobertura ausentes são silenciosamente
ignorado). Se o -r sinalizador está em vigor, os subdiretórios são verificados recursivamente.
Vários diretórios podem ser especificados e verificados na ordem fornecida.

executável
O arquivo executável é verificado em busca de registros de depuração que contenham o arquivo de origem
nomes, e cada arquivo de origem que existe é tratado como se tivesse sido especificado em
a linha de comando (exceto que os arquivos de dados de cobertura ausentes são ignorados silenciosamente).
Todas as bibliotecas compartilhadas das quais o executável depende também são verificadas. Múltiplo
os executáveis ​​podem ser especificados e verificados na ordem fornecida. Este recurso é
disponível apenas em algumas plataformas (por exemplo, i386-linux).

arquivo fonte
É algum arquivo regular que termina em uma das extensões de arquivo .c, . Cc, .cxx, .cpp, ou
.C. Os arquivos de origem são combinados com seus arquivos de dados de cobertura correspondentes (.gcno e
.gcda arquivos, ou .bb, .bbg e .dá arquivos com compiladores mais antigos) e arquivos de objeto por
procurando por um arquivo com o mesmo nome de base e a extensão apropriada primeiro em
o mesmo diretório do arquivo de origem e, em seguida, em todos os diretórios especificados em
a linha de comando (na ordem em que foram especificados).

OPÇÕES

-f teste.tgz, --arquivo de saída=teste.tgz
Gere saída para nome do arquivo teste.tgz em vez do padrão ggcov.webdb.tgz. O
nome de arquivo especial - pode ser usado para gerar saída para stdout.

-o dir, --diretório-objeto=dir
Adicione o diretório dir para o caminho de pesquisa para arquivos de objeto e arquivos de dados de cobertura.

-r, --recursivo
Quando um diretório é especificado na linha de comando, pesquise os arquivos de dados de cobertura
recursivamente em todos os diretórios filhos.

-X símbolos, --suppress-ifdef =símbolos
Não inclua nas estatísticas ou resumos, o código dentro das diretivas do pré-processador C
que dependem de qualquer um dos símbolos. Um ou mais símbolos podem ser fornecidos,
separados por vírgulas ou espaços em branco. Ggcov-webdb compreende o seguinte subconjunto de
o conjunto de comandos do pré-processador C:

· #E se SÍMBOLO
· #E se definido (SÍMBOLO)
· #ifdef SÍMBOLO
· #ifndef SÍMBOLO
· #else
· #fim se

Por exemplo, nos -X DEBUG irá suprimir o fprintf () ligue neste código:

int sem sinal
my_function (unsigned int x)
{
x + = 42;
#ifdef DEBUGAR
fprintf (stderr, "minha_função: x =% u \ n", x);
#fim se
retorna x;
}

Esta opção é útil para suprimir o código de infraestrutura de teste, código de depuração ou
outro código que é compilado no executável de teste de cobertura, mas cuja cobertura
não é significativo.

-Y palavras, --suppress-comment =palavras
Não inclua em estatísticas ou resumos, código em linhas que também contenham um
comentário de linha única compreendendo apenas um dos palavras. Um ou mais símbolos
pode ser fornecido, separado por vírgulas ou espaços em branco. Por exemplo, especificando -Y
IGNORME irá suprimir o afirmar() neste código:

int sem sinal
my_function (unsigned int x)
{
x + = 42;
afirmar (x> = 42); / * IGNOREME * /
retorna x;
}

Esta opção é útil para suprimir o código de infraestrutura de teste, código de depuração ou
outro código que é compilado no executável de teste de cobertura, mas cuja cobertura
não é significativo.

-Z palavra inicial, palavra final, ...

--suppress-comment-between =palavra inicial, palavra final, ...
Não inclua em estatísticas ou resumos, código em linhas entre aqueles que contêm um
comentário de linha única compreendendo apenas palavra de início e o próximo comentário de linha única
compreendendo apenas palavra final. Dois ou mais símbolos podem ser dados, em pares, separados por
vírgulas ou espaços em branco. Por exemplo, -Z STARTIGNORE, ENDIGNORE irá suprimir o
função inteira neste código:

/ * STARTIGNORE * /
int sem sinal
my_function (unsigned int x)
{
x + = 42;
retorna x;
}
//ENDIGNORE

Esta opção é útil para suprimir o código de infraestrutura de teste, código de depuração ou
outro código que é compilado no executável de teste de cobertura, mas cuja cobertura
não é significativo.

EXEMPLOS

Gere banco de dados intermediário para todas as fontes disponíveis no executável a.out (em
apenas algumas plataformas) e instale como teste Foo no local de testes padrão.

mkdir /var/ggcov/testes/foo
ggcov-webdb -f - a.out |
(CD /var/ggcov/testes/foo ; alcatrão -xzf - )

Gere banco de dados intermediário para todas as fontes C no diretório atual.

ggcov-webdb * .c

Gere banco de dados intermediário para toda a fonte C em um diretório onde o objeto
arquivos e arquivos de dados de cobertura de teste estão em diretórios diferentes:

ggcov-webdb / foo / obj / / foo / cov-data / / foo / src /

Use ggcov-webdb online usando serviços onworks.net