net rate-shaping drop-policy
net rate-shaping drop-policy(1) BIG-IP TMSH Manual net rate-shaping drop-policy(1)
NAME
drop-policy - Configures a custom drop policy for use in rate shaping.
MODULE
net rate-shaping
SYNTAX
Configure the drop-policy component within the net rate-shaping module using the syntax in the following
sections.
CREATE/MODIFY
create drop-policy [name]
modify drop-policy [name]
options:
app-service [[string] | none]
average-packet-size [integer]
description [string]
fred-max-active [integer]
fred-max-drop [integer]
fred-min-drop [integer]
inverse-weight [integer]
max-probability [integer]
max-threshold [integer]
min-threshold [integer]
red-hard-limit [integer]
type [fred | red | tail]
edit drop-policy [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
DISPLAY
list drop-policy
list drop-policy [ [ [name] | [glob] | [regex] ] ... ]
show running-config drop-policy
show running-config drop-policy [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
DELETE
delete drop-policy [all | [name] ]
DESCRIPTION
A drop policy tells the system when and how to drop packets when the traffic handling queue is full, if
required. The system comes with three pre-configured drop policies: fred, red, and tail.
You can use the drop-policy component to create a custom drop policy, and then associate it with a class using
the drop-policy option of the class component. For more information, see net rate-shaping class.
You can also associate a custom drop policy with a shaping policy using the drop-policy option of the shaping-
policy component. For more information, see net rate-shaping shaping-policy.
EXAMPLES
create drop-policy my_dp
Creates a custom drop policy named my_dp.
list drop-policy all-properties
Displays all of the properties of all of the drop policies.
OPTIONS
app-service
Specifies the name of the application service to which the object belongs. The default value is none.
Note: If the strict-updates option is enabled on the application service that owns the object, you cannot
modify or delete the object. Only the application service can modify or delete the object.
average-packet-size
Specifies the average MTU (maximum transmission unit) size in the range of 0 to 10000 bytes. The default
value is 0 (zero).
description
User defined description.
fred-max-active
Specifies the maximum number of flows that can be active for each queue. The range is 0 to 10000. The
default value is 0 (zero),which disables active flow limitation.
fred-max-drop
Specifies a hard drop limit in the range of 0 to 400. The default value is 0 (zero). Setting this to a
small value does not change the hard drop limit, but a higher number increases the limit.
fred-min-drop
Specifies a hard no drop limit in the range of 0 to 100. The default value is 0 (zero). Setting this to a
large value prevents packets from being dropped.
glob Displays the items that match the glob expression. See help glob for a description of glob expression
syntax.
inverse-weight
Specifies the weight used to calculate the average queue length. Valid values are 0, 64, 128, 256, 512,
and 1024. The default value is 0 (zero).
max-probability
Specifies the maximum percentage probability in the range of 0 to 100 according to which packets are
dropped when the average queue length is between the minimum and maximum thresholds. The default value is
0 (zero).
max-threshold
Specifies the queue length above which the system drops packets. The default value is 0 (zero).
min-threshold
Specifies the queue length below which the system does not drop packets. The default value is 0 (zero).
name Specifies a unique name for the component. This option is required for the commands create, delete, and
modify.
red-hard-limit
Specifies the maximum queue size in bytes. Additional packets are dropped. The default value is 0 (zero).
This option applies only when the value of the type option is red.
regex
Displays the items that match the regular expression. The regular expression must be preceded by an at
sign (@[regular expression]) to indicate that the identifier is a regular expression. See help regex for
a description of regular expression syntax.
type Specifies the type of drop policy. The default value is tail.
The options are:
fred Specifies that the system uses Flow-based Random Early Detection to decide whether to drop packets
based on the aggressiveness of each flow.
red Specifies that the system uses Random Early Detection to determine whether to drop packets to
maintain the average queue length within the specified range.
tail Specifies that the system drops all incoming packets when the queue is full. This is the simplest
drop policy.
Note that although you could create a drop policy based on tail, that is already the default value
of the drop-policy option in both the shaping-policy and class components.
SEE ALSO
create, delete, edit, glob, list, modify, net rate-shaping class, net rate-shaping queue, net rate-shaping
shaping-policy, regex, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose
other than the purchaser's personal use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008-2010, 2012-2013, 2016. All rights reserved.
BIG-IP 2016-03-14 net rate-shaping drop-policy(1)