Áú»¢¶Ä²©

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.