Attributes
This section contains an alphabetical list of the attributes used by Solaris Bandwidth Manager. It gives the attribute syntax, possible values, and a short definition of the attribute's purpose.
This section does not include attributes that are not specific to Solaris Bandwidth Manager such as top or common name (cn).
Table 6-3 shows the possible syntaxes for attributes, with their definitions.
Table 6-3 Attribute Syntax definitions|
Attribute syntax |
Syntax Definition |
|---|---|
|
bin |
Stands for binary. |
|
ces |
Stands for case exact string. A case-sensitive alphanumeric string. |
|
cis |
Stands for case ignore string. A non-case-sensitive alphanumeric string. |
|
dn |
A distinguished name |
|
int |
An integer |
|
protected |
A value that has been encrypted using crypt(1) |
|
tel |
A telephone number |
|
utctime |
UTC time |
baClConfRef
Used in baConf
Description: Provides a pointer to a generic configuration.
baConfState
Used in baConf
Description: Indicates whether the configuration described by the entry is a valid one, or if it is currently being modified. This attribute can have only one of the following values: invalid, valid. When a configuration is saved to the directory, this attribute is set to invalid, any previous version of the configuration is deleted, the new one is saved, and the attribute is set back to valid.
baIfActivate
Used in baIf
Description: Indicates the status of an interface controlled by Solaris Bandwidth Manager. This attribute can have only one of the following values: enabled, stats, tos ordisabled. The meaning of these values is described in "Interface Definition".
baIfMulticast
Used in baIf
Description: Specifies how multicast packets are forwarded. This attribute can have only one of the following values: none, all or direct. The meaning of these values is described in "IP-Transparent Mode". This attribute is not required if Solaris Bandwidth Manager is working in IP transparent mode.
baIfName
Used in baIf
Description: Specifies the device name of the interface described by the entry. Suffixed with _in or _out to indicate the direction of traffic handled.
baIfNetwork
Used in baIf
Description: Specifies the name of the device used to communicate with the network. This attribute is required if Solaris Bandwidth Manager is working in IP transparent mode.
baIfNonIP
Used in baIf
Description: Specifies how non-IP packets are forwarded. This attribute can have only one of the following values: ipqos or direct. The meaning of these values is described in "IP-Transparent Mode". This attribute is not required if Solaris Bandwidth Manager is working in IP transparent mode.
baIfRate
Used in baIf
Description: Indicates the operating bandwidth rate associated with the interface described by the entry. Enter in bits per second.
baIfRtrAddr
Used in baIf
Description: Gives the list of IP addresses or the hostname of the router. If you specify several IP addresses, they must be separated by commas. This attribute is required if Solaris Bandwidth Manager is working in IP transparent mode.
baIfRtrMac
Used in baIf
Description: Specifies the MAC address of the router described by the entry. Can be either a hexadecimal address or a hostname listed in the ethers table. This attribute is required if Solaris Bandwidth Manager is working in IP transparent mode.
baTimeout
Used in baConf
Description: Specifies a timeout on the configuration. Expressed in seconds.
ceilingRate
Used in LSaction
Description: Indicates the maximum bandwidth allocated across a link. The value of this attribute can be expressed in bytes per second (bps) or as a percentage of bandwidth. If expressed in bytes per second the syntax is 1:x, if expressed as a percentage the syntax is 2:x, where x is the value in bps or a percentage.
destinationGroup
Used in IProuteCondition
Description: Provides a pointer to an entry of type baGroup.
destinationIPHost
Used in IProuteCondition
Description: Specifies the name of the destination host in an entry describing an IP route condition.
destinationNetwork
Used in IProuteCondition
Description: Specifies the name of the destination network in an entry describing an IP route condition.
destinationPortNumberRanges
Used in IPserviceCondition
Description: Specifies the port or range of ports to which the condition described by the entry applies.
flowEvent
Used in LSaction
Description: Indicates that "flow added" events are generated when a new flow is detected in the class. The value is a string used by the directory M-bean when searching for a quality of service.
groupMember
Used in baGroup
Description: Provides the address of a host or subnet to include in a group described by a baGroup entry.
guaranteedRate
Used in LSaction
Description: Indicates the guaranteed bandwidth across a link. The value of this attribute can be expressed in bytes per second (bps) or as a percentage of bandwidth. If expressed in bytes per second the syntax is 1:x, if expressed as a percentage the syntax is 2:x, where x is the value in bps or a percentage.
interfaceName
Used in interfaceCondition
Description: Specifies the name of the interface to which the condition described by the entry applies. The syntax is device:direction, where device is expressed in local terms, for example hme0, eth0 and direction is INCOMING, OUTGOING or BOTH.
networkMask
Used in baConf
Description: Specifies the subnet mask of the subnet group described by the entry. The subnet mask is specified in dot format, or by the name of a subnet mask defined in the hosts file or the networks file. You cannot use the + style of specifying a netmask. When this attribute is not present, the group described by the entry is a host group. This attribute is mandatory to describe a subnet group.
parent
Used in LSaction
Description: The name of a class's parent class.
policyActionList
Used in policy
Description: Provides references to a set of policyAction objects. The actions described by the policyAction entries are performed when all the conditions defined by the policy entry have been satisfied.
policyActionName
Used in policyAction
Description: The user friendly name of the policy action described by the entry.
policyConditionList
Used in policy
Description: Provides references to a set of policyCondition objects. The policy described by the entry is applicable when this set of conditions is satisfied.
policyConditionName
Used in policyCondition
Description: The user friendly name of the policy condition described by the entry. This attribute is not a naming attribute, and therefore cannot be used in the RDN of an entry.
policyEnabled
Used in policy
Description: Indicates whether the policy described by the entry is currently enabled. This attribute can have only one of the following values: TRUE or FALSE.
policyKeywords
Used in policy
Description: Provides a list of keywords that can be used in a search for the policy entry.
policyName
Used in policy
Description: The user friendly name of the policy described by the entry. This attribute is not a naming attribute, and therefore cannot be used in the RDN of an entry.
policyRef
Used in policyAux
Description: Provides a reference to a policy. This attribute is used to associate a policy with other types of entries, for example a remote user entry.
policyUsage
Used in policy
Description: Provides guidelines for using the policy described by the entry.
portNumberPairs
Used in IPserviceCondition
Description: Indicates pairs of source and destination ports, with the following syntax: source:destination.
previous
Used in LSaction
Description: Specifies the name of the class that was verified before the current one. If the previous class was root, this is blank.
protocolNumber
Used in IPserviceCondition
Description: Provides the name of the protocol described in the condition. This attribute can have only one value and can be either ANY or the name of any protocol defined in the /etc/protocols file..
queueName
Used in LSaction
Description: Specifies the classname of the queue to which the actions described by the entry apply.
queuePriority
Used in LSaction
Description: As part of the actions described by the entry, it indicates the priority assigned to the flow.
receivedDSByteCheck
Used in DScondition
Description: Specifies a condition for traffic based on the contents of the differentiated services (DS) byte of the received packet's IP header. The format is a string of the form xxxxxxxx:xxxxxxxx, where x is 0 or 1. The left substring is a Mask, and the right substring a Match. The DS byte of the received packet's IP header is ANDed with Mask, and the result is compared against Match. Therefore, the condition can be expressed as follows:
(receivedPacketTOSbyte & Mask == Match)?
where & indicates the bitwise AND operation, and == the bitwise compare operation.
The combination of Mask and Match makes it possible to define DS byte-based profiles where certain bits in the DS byte may be ignored for the purpose of comparison.
sourceGroupRef
Used in IProuteCondition
Description: Provides a pointer to an entry of type baGroup.
sourceIPHost
Used in IProuteCondition
Description: Specifies the name of the source host in an entry describing an IP route condition.
sourceNetwork
Used in IProuteCondition
Description: Specifies the name of the source network in an entry describing an IP route condition.
sourcePortNumberRanges
Used in IPserviceCondition
Description: Specifies the port or range of ports to which the condition described by the entry applies.
tosWrite
Used in LSaction
Description: As part of the actions described by the entry, specifies the type of service provided. The value of this attribute is an integer between 0 and 255.
URLgroupMember
Used in baURLgroup
Description: Provides a pointer to a baURLgroup entry.
URLmatch
Used in URLcondition
Description: Specifies a URL used to construct a filter for the URL condition described by the entry. This URL can contain wildcards.
- © 2010, Oracle Corporation and/or its affiliates