Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

1 Chave do item

1.1 Parâmetros flexíveis e não flexíveis

Um parâmetro flexível é um parâmetro que aceita argumentos. Por exemplo, em 'vfs.fs.size[*]' o asterístico ('*') indica um parâmetro flexível. O '*' é um texto que será passado como argumento. Exemplos:

  • vfs.fs.size[/]
  • vfs.fs.size[/opt]

1.2 Formato da chave

O formato de chave de item, incluindo os parâmetros, precisa seguir uma regra de formação. As ilustrações a seguir descrevem a sintaxe suportada. Os elementos e caracteres permitidos em cada ponto podem ser determinados ao seguir as setas - se o bloco puder ser alcançado pela linha, então será permitido, senão não.

A construção de uma chave válida começa ao especificar o nome da chave, em seguida escolhe-se se ela terá ou não parâmetros - como representado pelas duas linhas que podem ser seguidas.

Nome da chave

O nome da chave é limitado a um conjunto de caracteres, que se seguem. Os caracteres permitidos são:

0-9a-zA-Z_-.

Que incluem:

  • todos os números;
  • todas as letras minúsculas;
  • todas as letras maiúsculas;
  • sublinhado;
  • traço;
  • ponto.

Parâmetros de chave

Uma chave pode possuir vários parâmetros, todos eles separados por vírgulas.

Um parâmetro poderá ter um texto entre aspas, um texto sem aspas ou um array.

Um parâmetro também poderá ser vazio, neste caso será atribuido o valor padrão. Neste caso a quantidade de vírgulas apropriada deverá ser informada para que qualquer parâmetro posterior possa ser utilizado. Por exemplo, a chave icmpping[,,200,,500] especifica o intervalo entre os pings individuais para 200 milissegundos, um tempo máximo de espera (timeout) de 500 milissegundos, e todos os demais parâmetros com seus valores padrões.

Parâmetro - entre aspas

Se o parâmetro da chave estiver entre aspas, qualquer caracter Unicode poderá ser informado, inclusive as aspas duplas precisando apenas que estejam escapadas.

Parâmetro - sem aspas

Se o parâmetro da chave da não estiver entre aspas qualquer caracter Unicode será permitido, exceto vírgula e colchete direito (]).

Parâmetro - array

Se o parâmetro da chave for um array, ele deverá estar entre colchetes e seus parâmetros internos deverão obedecer a mesma regra dos parâmetros de chave.

Parameter - quoted string

If the key parameter is a quoted string, any Unicode character is allowed.

If the key parameter string contains comma, this parameter has to be quoted.

If the key parameter string contains quotation mark, this parameter has to be quoted and each quotation mark which is a part of the parameter string has to be escaped with a backsplash (\) character.

To quote item key parameters, use double quotes only. Single quotes are not supported.

Parameter - unquoted string

If the key parameter is an unquoted string, any Unicode character is allowed except comma and right square bracket (]). Unquoted parameter cannot start with left square bracket ([).

Parameter - array

If the key parameter is an array, it is again enclosed in square brackets, where individual parameters come in line with the rules and syntax of specifying multiple parameters.

Multi-level parameter arrays, e.g. [a,[b,[c,d]],e], are not allowed.