Modificando opções

As opções podem ser definidas em um script de D com #pragma D seguido pela opção de seqüência e o nome da opção. Se a opção tiver um valor, o nome dela deve ser seguido por um sinal de igual (=) e o valor da opção. Os exemplos seguintes são configurações de opção válidas:

#pragma D option nspec=4
#pragma D option grabanon
#pragma D option bufsize=2g
#pragma D option switchrate=10hz
#pragma D option aggrate=100us
#pragma D option bufresize=manual

O comando dtrace(1M) também aceita configurações de opção na linha de comando, como um argumento para a opção -x. Por exemplo:

# dtrace -x nspec=4 -x grabanon -x bufsize=2g \
    -x switchrate=10hz -x aggrate=100us -x bufresize=manual

Se uma opção inválida for especificada, o dtrace indica que o nome da opção é inválido e existe:

# dtrace -x wombats=25
dtrace: failed to set option -x wombats: Invalid option name
#

Semelhantemente, se um valor de opção não for válido para a opção fornecida, o dtrace indicará que o valor é inválido:

# dtrace -x bufsize=100wombats
dtrace: failed to set option -x bufsize: Invalid value for specified option
#

Se uma opção for definida mais de uma vez, as configurações subseqüentes sobrescrevem as configurações anteriores. Algumas opções, tais como grabanon, podem ser somente definidas. A presença de tal opção a define, e você não pode cancelar a sua definição mais tarde.

As opções que são definidas para uma ativação anônima serão honradas pelo consumidor do DTrace que declara o estado anônimo. Consulte o Capítulo 36Rastreio anônimo para obter informações sobre a ativação do rastreio anônimo.