Tux Command-Line Parameters

9/8/2008

O cliente tux fornece grande parte da funcionalidade tux. Você pode executar o cliente tux em autônomo modo ou em conjunto com o servidor Windows Embedded CE 6.0 Test Kit (CETK).

Syntax

tux [-b] [-e] [-s file_name | -d test_dll] [-c parameters] [-r seed] 
[-x test_case] [-l | -lv] [-t address] [-n] [-h] [-k address] [-m] 
[-o] [-f file_name] [-a] [-z timeout]

Parameters

• -b
  Quebras após cada Tux DLL carrega.

• -e
  Desativa manipulação de exceção.

• -s nome do arquivo
  Especifica o arquivo do conjunto tux para carregar e executar.

• **-d ** test_dll
  Especifica o Tux DLL para carregar e executar.

• -c Parâmetros
  Linha de comando para transmitir para o Tux DLL.

• -r Propagação
  Especifica o aleatório inicial inteiro propagação.

• **-x ** test_case
  Especifica qual testar casos para executar. Você pode especificar uma maiúsculas e minúsculas testar único ou um intervalo de testar casos, como mostra o seguinte linha de comando.

  tux - x 10, 12, 15-20

• -l
  Lista os casos testar na Tux DLL especificado pelo **-d ** parâmetro.

• -LV
  Com maior verbosidade, lista os casos testar na Tux DLL especificado pelo **-d ** parâmetro.

• -t endereço
  Especifica o nome do computador a execução de servidor CETK. Use-t Sem argumentos para especificar um local servidor.

• -n
  Executa testes no modo kernel.

• -h
  Exibe a lista de parâmetros linha de comando para tux.

A seguinte tabela mostra os parâmetros tux habilitado quando Kato.dll estiver presente.

• -k endereço
  Especifica o nome do computador a execução de servidor CETK. Use-k Sem argumentos para especificar um local servidor.

• -m
  Registra todas as saída Kato como XML.

• **-o **
  Registra todas as saída Kato o depurador.

• -f nome do arquivo
  Registra todos os arquivo output to Output Kato nome do arquivo.

• -Um
  Acrescenta dados ao arquivo de saída. Use este parâmetro com o -f parâmetro.

A seguinte tabela mostra um parâmetro tux que é habilitado quando Toolhelp.dll estiver presente.

• -z tempo limite
  Cancela um executar existente do Tux DLL especificado pelo **-d ** parâmetro.

  Se você especificar -z Sem argumentos, tux sai após a atual maiúsculas e minúsculas testar nas extremidades Tux DLL especificadas.

  Se você especificar um valor de tempo limite, aguarda tux como tempo como o número especificado de segundos para a maiúsculas e minúsculas testar para finalizar. Se o maiúsculas e minúsculas testar Não Termina após o tempo de espera especificado, tux será encerrada.

  De exemplo, se for tux execução a Gdiapi.dll módulo testar e você executar o comando tux -d gdiapi.dll - z05Tux, aguarda 5 segundos para o atual testar maiúsculas e minúsculas in Gdiapi.dll final e, em seguida, sai. Observe que não há nenhum espaço entre a -z sinalizador e o número tempo limite.

Esses parâmetros são discutidos mais abaixo.

• -b
  Esse parâmetro geralmente é útil para depuração um testar tux DLL. Alguns depuradores exigem que um módulo testar fisicamente ser carregados na memória antes uma ponto de interrupção pode ser definida no módulo que testar. Porque o cliente tux dinamicamente carrega testar módulos em tempo de execução, pode ser difícil definir um válido ponto de interrupção no seu módulo testar. O -b parâmetro força o cliente tux para interromper ao depurador depois que o módulo testar tiver sido totalmente carregado, mas antes todas as mensagens foram enviadas para seu ShellProc função. Esse comportamento oferece uma oportunidade para definir uma ponto de interrupção em seu módulo testar e, em seguida, continuar execução.

• -e
  Esse parâmetro desativa o manipulação de exceção usar como padrão compilado para o cliente tux. Por padrão, o cliente tux intercepta todas as exceções que ocorrer durante execução no seu módulo, relatórios-los voltar para você e, em seguida, continua execução com o próximo testar. O -e parâmetro é útil quando depuração um módulo testar tux.

• -s nome do arquivo
  Este parâmetro permite que o cliente tux para carregar um arquivo do conjunto testar. Um arquivo do conjunto testar é um script de testar módulos DLL e testar casos para executar em cada módulo testar. Se você usar esse parâmetro durante execução de servidor CETK com o -t parâmetro, o script carrega mas não executar até direcionado para fazer isso, o servidor. Se você usar esse parâmetro em autônomo modo sem o -t parâmetro, o cliente tux carregará o script e o executa imediatamente. Windows Embedded CE, arquivos do conjunto podem residir no Windows Embedded CE-com dispositivo entre a conexão CESH remotamente. Tux primeiro tenta localizar os arquivos no seu desenvolvimento estação de trabalho. Se tux não conseguir localizar os arquivos no estação de trabalho de desenvolvimento, tux procura o Windows Embedded CE com dispositivo para os arquivos. Se você desejar para forçar tux para pesquisa de arquivos somente no dispositivo de destino, você pode prefixo o caminho com cesh:. O seguinte linha de comando mostra a sintaxe para essa opção.

  cesh:test.tux -s tux

  Você também pode especificar caminhos relativo para o Diretório CESH no dispositivo de destino, conforme o seguinte linha de comando.

  cesh -s tux:\suites\test.tux

• -d ** test_dll
  Este parâmetro permite que o cliente tux para carregar um ou mais módulos testar usar como padrão. Você pode usar esse parâmetro mais de uma vez para um determinado linha de comando para carregar múltiplo tux testar módulos. Se você usar esse parâmetro durante execução de servidor CETK com o-t** parâmetro, o carregar módulos testar, mas não executar até direcionado para fazer isso, o servidor. Se você usar esse parâmetro em autônomo modo com não -t parâmetro, o cliente tux carrega os módulos testar e começa imediatamente para executar os testes especificados para cada módulo testar. Para obter mais informações, consulte as descrições para o –x e –l Parâmetros.

• -c param_str
  Este parâmetro permite que você transmitir um parâmetro seqüência de caracteres para testar o tux DLL próprio. O seqüência de caracteres parâmetro que é transmitir associado com o DLL recentemente especificado com o **-d ** parâmetro. Este comportamento permite que você especificar parâmetros diferentes para cada testar tux DLL. Se o seqüência de caracteres que você especificar contém espaços ou outros caracteres especiais e, em seguida, você deve colocar o seqüência de caracteres com quotation Marks.

• -r Propagação
  Este parâmetro permite que você especificar um aleatório inicial propagação. A propagação você transmitir está associado com o DLL recentemente especificado com o **-d ** parâmetro. Este comportamento permite que você especificar um aleatório diferente propagação para cada Tux DLL.

• **-x ** test_case
  Este parâmetro permite que você especificar uma maiúsculas e minúsculas testar ou um intervalo de testar casos para executar. Você deve especificar o apropriado identificador para cada maiúsculas e minúsculas testar, que podem ser obtidas usando o –l parâmetro. Os valores são transmitir associado com o DLL especificado mais recentemente na linha de comando com o **-d ** parâmetro. Este comportamento permite testar diferentes especificar casos para testar cada tux DLL. Você pode especificar esse parâmetro múltiplo horas para um único DLL, conforme o seguinte linha de comando.

  tux - x 10 –x15-20

  Você também pode combinar os intervalos em um parâmetro único, conforme o seguinte linha de comando.

  tux - x 10, 15-20

  Se você usar esse parâmetro durante execução de servidor CETK com o-t parâmetro, as ocorrências testar especificadas são selecionadas mas não executar até direcionado para fazer isso, o servidor. Se você usar esse parâmetro em autônomo modo com não -t parâmetro e, em seguida, carregar o cliente tux os módulos testar e começa imediatamente a execução de testes especificados para cada módulo DLL testar. Se nenhum –x parâmetro for especificado para um determinado DLL, o comportamento usar como padrão é para executar todos os testes quando o cliente tux é executado em autônomo modo.

• -l
  Esse parâmetro faz com que o cliente tux para exibir o conteúdo de testar tux todas as DLLs especificadas com o –d parâmetro. A listagem também mostra os identificadores associado com cada maiúsculas e minúsculas testar. Você pode usar esses identificadores com o –x parâmetro. Quando você usa o –l parâmetro, todos os argumentos Other Than –d são ignorados. Este parâmetro fornece informações e não executar quaisquer ocorrências testar.

• -n
  Esse parâmetro faz testes para ser executar no modo kernel usando ktux.dll. Este sinalizador requer o usuário ter privilégio suficiente para carregar de kernel.

  Observação

  Processos execução em modo kernel não pode ser finalizada pelo controle de destino, portanto, o KP Comando no controle de destino não poderão para finalizar o processo.

• -t endereço
  Este parâmetro especifica a localidade do servidor de CETK. O endereço parâmetro pode ser uma nome do computador ou IP um endereço. Se você não usar a opção -t parâmetro, tux assume autônomo modo. Você deve especificar ambos o -s parâmetro para carregar e executar um conjunto testar ou a **-d ** parâmetro para carregar e executar um módulo testar. Se nenhum endereço for fornecido com o -t parâmetro, o cliente tux usa o endereço IP de estação de trabalho de desenvolvimento.

• -h
  Este parâmetro gera uma lista de parâmetros tux.

• -k endereço
  Este parâmetro especifica a localidade do servidor de CETK. O endereço parâmetro pode ser uma nome do computador ou IP um endereço. Se nenhum endereço for fornecido com o -t parâmetro, o cliente tux usa o endereço IP de estação de trabalho de desenvolvimento. Este parâmetro envia todas as saída Kato para o servidor CETK. Essa saída é in addition to a saída para um arquivo e o depurador, se você especificar a -f e **-o ** Parâmetros.

• -m
  Este parâmetro envia todas as saída para um arquivo XML.

• **-o **
  Este parâmetro envia todas as saída Kato para o depurador. Essa saída é in addition to a saída para o servidor CETK e um arquivo, se você especificar a -k e -f Parâmetros.

• -f nome do arquivo
  Este parâmetro salva todas as saída Kato para um arquivo. Essa saída é in addition to a saída para o servidor CETK e o depurador, se você especificar a -k e **-o ** Parâmetros. O comportamento usar como padrão é para substituir qualquer arquivo existente com o mesmo nome. Para substituir usar como padrão os comportamento e anexar informações para o arquivo, use o -Um parâmetro along with o -f parâmetro. Para Windows Embedded CE, você pode prefixar o nome arquivo com cesh: Se você desejar para criar o arquivo na Release Directory File System (Relfsd) de um dispositivo destino através de conexão CESH. O seguinte linha de comando mostra essa técnica.

  cesh:Test.txt -f teste.dll -d tux

  Você também pode especificar caminhos relativo para o Diretório CESH no dispositivo de destino, conforme mostrado pelo seguinte linha de comando.

  cesh -f teste.dll -d tux:\logs\test.txt

  Se cesh: não é especificado, o arquivo é criado no dispositivo de destino.

• -Um
  Este parâmetro pode ser usado com o -f parâmetro para anexar dados para um arquivo log rather than substituindo o arquivo de log existente.

• -z tempo limite
  Este parâmetro pára uma execução Tux DLL. Este parâmetro tem um efeito somente se toolhelp.dll está presente. Use o **-d ** parâmetro para especificar o Tux DLL para parar.

  Se você especificar -z Sem argumentos, tux sai após a atual maiúsculas e minúsculas testar nas extremidades Tux DLL especificadas.

  Se você especificar um valor de tempo limite, aguarda tux como tempo como o número especificado de segundos para a maiúsculas e minúsculas testar para finalizar. Se o maiúsculas e minúsculas testar Não Termina após o tempo de espera especificado, tux será encerrada.

  De exemplo, se for tux execução a Gdiapi.dll módulo testar e você executar o comando tux -d gdiapi.dll - z05Tux, aguarda 5 segundos para o atual testar maiúsculas e minúsculas in Gdiapi.dll final e, em seguida, sai. Colocar o número tempo limite imediatamente após o -z sinalizador, com nenhum espaço entre elas.

Remarks

O -n parâmetro inicia a biblioteca especificada no processo de kernel via o intermediário ktux.dll.

O -k, **-m,-o **, -f, e -Um parâmetros estão disponível somente se Kato.dll estiver presente. Kato.dll o mecanismo de registro Kato é usado por mais tux testar módulos. Tux não requer Kato, mas Kato é o mecanismo log recomendado se você desejar incluir log em seus módulos testar. Para obter mais informações, consulte Kato Logging Engine.

Um espaço não é exigido entre um parâmetro de linha de comando e seu argumento. Para o seguinte exemplo, duas linhas de comando equivalente.

tuxdemo.dll -t tux

Você deve especificar cada parâmetro de linha de comando separadamente. Para o seguinte exemplo, linha de comando é válido.

tux -b -e

No entanto, a seguinte linha de comando é inválido.

–Be tux

See Also

Other Resources

Tux Architecture