Product Documentation

dns policylabel

Sep 12, 2016

The following operations can be performed on "dns policylabel":

add dns policylabel

Add a dns policy label.

Synopsys

add dns policylabel <labelName> <transform>

Arguments

labelName

Name of the dns policy label.

transform

The type of transformations allowed by the policies bound to the label.

Possible values: dns_req, dns_res

Example

add dns policylabel trans_dns dns_req

rm dns policylabel

Remove a dns policy label.

Synopsys

rm dns policylabel <labelName>

Arguments

labelName

Name of the dns policy label.

Example

rm dns policylabel trans_dns

bind dns policylabel

Bind the dns policy to one of the labels.

Synopsys

bind dns policylabel <labelName> <policyName> <priority> [<gotoPriorityExpression>] [-invoke (<labelType> <labelName>) ]

Arguments

labelName

Name of the label to invoke if the current policy rule evaluates to TRUE.

policyName

The dns policy name.

priority

Priority with which the policy is to be bound.

Minimum value: 1

Maximum value: 2147483647

gotoPriorityExpression

Expression specifying the priority of the next policy which will get evaluated if the current policy rule evaluates to TRUE.

o If gotoPriorityExpression is not present or if it is equal to END then the policy bank evaluation ends here

o Else if the gotoPriorityExpression is equal to NEXT then the next policy in the priority order is evaluated.

o Else gotoPriorityExpression is evaluated. The result of gotoPriorityExpression (which has to be a number) is processed as follows:

- An UNDEF event is triggered if

. gotoPriorityExpression cannot be evaluated

. gotoPriorityExpression evaluates to number which is smaller than the maximum priority in the policy bank but is not same as any policy's priority

. gotoPriorityExpression evaluates to a priority that is smaller than the current policy's priority

- If the gotoPriorityExpression evaluates to the priority of the current policy then the next policy in the priority order is evaluated.

- If the gotoPriorityExpression evaluates to the priority of a policy further ahead in the list then that policy will be evaluated next.

invoke

Invoke flag.

labelType

Type of policy label invocation.

Possible values: policylabel

Example

 i) bind dns policylabel trans_dns pol_1 1 2 -invoke reqvserver CURRENT  ii) bind rewrite policylabel trans_http_url pol_2 2

unbind dns policylabel

Unbind entities from dns label.

Synopsys

unbind dns policylabel <labelName> <policyName> [-priority <positive_integer>]

Arguments

labelName

Name of the dns policy label.

policyName

The dns policy name.

priority

Priority of the NOPOLICY to be unbound.

Minimum value: 1

Maximum value: 2147483647

Example

unbind dns policylabel trans_dns pol_1

show dns policylabel

Display policy label or policies bound to dns policylabel.

Synopsys

show dns policylabel [<labelName>]

Arguments

labelName

Name of the dns policy label.

Outputs

stateflag

transform

The type of transformations allowed by the policies bound to the label.

numpol

Number of polices bound to label.

hits

Number of times policy label was invoked.

policyName

The dns policy name.

priority

Specifies the priority of the policy.

gotoPriorityExpression

Expression specifying the priority of the next policy which will get evaluated if the current policy rule evaluates to TRUE.

invoke

Invoke flag.

labelType

Type of policy label invocation.

labelName

Name of the label to invoke if the current policy rule evaluates to TRUE.

flowType

Flowtype of the bound dns policy.

description

Description of the policylabel

isDefault

A value of true is returned if it is a default dns policylabel.

flags

devno

count

Example

 i) show dns policylabel trans_dns  ii) show dns policylabel

stat dns policylabel

Display statistics of dns policylabel(s).

Synopsys

stat dns policylabel [<labelName>] [-detail] [-fullValues] [-ntimes <positive_integer>] [-logFile <input_filename>] [-clearstats ( basic | full )]

Arguments

labelName

The name of the dns policy label for which statistics will be displayed. If not given statistics are shown for all dns policylabels.

detail

Specifies detailed output (including more statistics). The output can be quite voluminous. Without this argument, the output will show only a summary.

fullValues

Specifies that numbers and strings should be displayed in their full form. Without this option, long strings are shortened and large numbers are abbreviated

ntimes

The number of times, in intervals of seven seconds, the statistics should be displayed.

Default value: 1

Minimum value: 0

logFile

The name of the log file to be used as input.

clearstats

Clear the statsistics / counters

Possible values: basic, full

Outputs

count

devno

stateflag

Outputs

Policy Label Hits (Hits)

Number of times policy label was invoked.

Related Commands

rename dns policylabel

Rename a dns policy label.

Synopsys

rename dns policylabel <labelName>@ <newName>@

Arguments

labelName

The name of the dns policylabel.

newName

The new name of the dns policylabel.

Example

rename dns policylabel oldname newname