ADC CLI Commands

quic-profile

The following operations can be performed on “quic-profile”:

rm add unset show set

rm quic profile

Remove a QUIC profile on the Citrix ADC

Synopsis

rm quic profile

Arguments

name Name for the QUIC profile. Must begin with an ASCII alphanumeric or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@),equals sign (=), and hyphen (-) characters. Cannot be changed after the profile is created.

Example

rm quic profile

add quic profile

Create a new QUIC profile on the Citrix ADC.

Synopsis

add quic profile \[-ackDelayExponent <positive\_integer>] \[-activeConnectionIDlimit <positive\_integer>] \[-activeConnectionMigration \( ENABLED | DISABLED )] \[-congestionCtrlAlgorithm ] \[-initialMaxData <positive\_integer>] \[-initialMaxStreamDataBidiLocal <positive\_integer>] \[-initialMaxStreamDataBidiRemote <positive\_integer>] \[-initialMaxStreamDataUni <positive\_integer>] \[-initialMaxStreamsBidi <positive\_integer>] \[-initialMaxStreamsUni <positive\_integer>] \[-maxAckDelay <positive\_integer>] \[-maxIdleTimeout <positive\_integer>] \[-maxUDPDatagramsPerBurst <positive\_integer>] \[-maxUDPPayloadSize <positive\_integer>] \[-newTokenValidityPeriod <positive\_integer>] \[-retryTokenValidityPeriod <positive\_integer>] \[-statelessAddressValidation \( ENABLED | DISABLED )]

Arguments

name Name for the QUIC profile. Must begin with an ASCII alphanumeric or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@),equals sign (=), and hyphen (-) characters. Cannot be changed after the profile is created.

ackDelayExponent An integer value advertised by the Citrix ADC to the remote QUIC endpoint, indicating an exponent that the remote QUIC endpoint should use, to decode the ACK Delay field in QUIC ACK frames sent by the Citrix ADC. Default value: 3 Minimum value: 0 Maximum value: 20

activeConnectionIDlimit An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum number of QUIC connection IDs from the remote QUIC endpoint, that the Citrix ADC is willing to store. Default value: 3 Minimum value: 2 Maximum value: 8

activeConnectionMigration Specify whether the Citrix ADC should allow the remote QUIC endpoint to perform active QUIC connection migration.

Possible values: ENABLED, DISABLED Default value: ENABLED

congestionCtrlAlgorithm Specify the congestion control algorithm to be used for QUIC connections. The default congestion control algorithm is CUBIC.

Possible values: Default, NewReno, CUBIC, BBR Default value: Default

initialMaxData An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial value, in bytes, for the maximum amount of data that can be sent on a QUIC connection. Default value: 1048576 Minimum value: 8192 Maximum value: 67108864

initialMaxStreamDataBidiLocal An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the Citrix ADC. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamDataBidiRemote An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the remote QUIC endpoint. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamDataUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for unidirectional streams initiated by the remote QUIC endpoint. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamsBidi An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of bidirectional streams the remote QUIC endpoint may initiate. Default value: 100 Minimum value: 1 Maximum value: 500

initialMaxStreamsUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of unidirectional streams the remote QUIC endpoint may initiate. Default value: 10 Minimum value: 1 Maximum value: 500

maxAckDelay An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum amount of time, in milliseconds, by which the Citrix ADC will delay sending acknowledgments. Default value: 20 Minimum value: 10 Maximum value: 2000

maxIdleTimeout An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum idle timeout, in seconds, for a QUIC connection. A QUIC connection will be silently discarded by the Citrix ADC if it remains idle for longer than the minimum of the idle timeout values advertised by the Citrix ADC and the remote QUIC endpoint, and three times the current Probe Timeout (PTO). Default value: 180 Minimum value: 1 Maximum value: 3600

maxUDPDatagramsPerBurst An integer value, specifying the maximum number of UDP datagrams that can be transmitted by the Citrix ADC in a single transmission burst on a QUIC connection. Default value: 8 Minimum value: 1 Maximum value: 256

maxUDPPayloadSize An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the size of the largest UDP datagram payload, in bytes, that the Citrix ADC is willing to receive on a QUIC connection. Default value: 1472 Minimum value: 1252 Maximum value: 9188

newTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC NEW_TOKEN frames sent by the Citrix ADC. Default value: 300 Minimum value: 1 Maximum value: 3600

retryTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC Retry packets sent by the Citrix ADC. Default value: 10 Minimum value: 1 Maximum value: 120

statelessAddressValidation Specify whether the Citrix ADC should perform stateless address validation for QUIC clients, by sending tokens in QUIC Retry packets during QUIC connection establishment, and by sending tokens in QUIC NEW_TOKEN frames after QUIC connection establishment.

Possible values: ENABLED, DISABLED Default value: ENABLED

Example

add quic profile

unset quic profile

Use this command to remove quic profile settings.Refer to the set quic profile command for meanings of the arguments.

Synopsis

unset quic profile [-ackDelayExponent] [-activeConnectionIDlimit] [-activeConnectionMigration] [-congestionCtrlAlgorithm] [-initialMaxData] [-initialMaxStreamDataBidiLocal] [-initialMaxStreamDataBidiRemote] [-initialMaxStreamDataUni] [-initialMaxStreamsBidi] [-initialMaxStreamsUni] [-maxAckDelay] [-maxIdleTimeout] [-maxUDPDatagramsPerBurst] [-maxUDPPayloadSize] [-newTokenValidityPeriod] [-retryTokenValidityPeriod] [-statelessAddressValidation]

show quic profile

Display the parameter values of all the configured QUIC profiles in the system. To display the parameter values of a particular QUIC profile, specify its name.

Synopsis

show quic profile []

Arguments

name Name for the QUIC profile. Must begin with an ASCII alphanumeric or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@),equals sign (=), and hyphen (-) characters. Cannot be changed after the profile is created.

Output

ackDelayExponent An integer value advertised by the Citrix ADC to the remote QUIC endpoint, indicating an exponent that the remote QUIC endpoint should use, to decode the ACK Delay field in QUIC ACK frames sent by the Citrix ADC.

activeConnectionIDlimit An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum number of QUIC connection IDs from the remote QUIC endpoint, that the Citrix ADC is willing to store.

activeConnectionMigration Specify whether the Citrix ADC should allow the remote QUIC endpoint to perform active QUIC connection migration.

congestionCtrlAlgorithm Specify the congestion control algorithm to be used for QUIC connections. The default congestion control algorithm is CUBIC.

initialMaxData An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial value, in bytes, for the maximum amount of data that can be sent on a QUIC connection.

initialMaxStreamDataBidiLocal An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the Citrix ADC.

initialMaxStreamDataBidiRemote An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the remote QUIC endpoint.

initialMaxStreamDataUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for unidirectional streams initiated by the remote QUIC endpoint.

initialMaxStreamsBidi An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of bidirectional streams the remote QUIC endpoint may initiate.

initialMaxStreamsUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of unidirectional streams the remote QUIC endpoint may initiate.

maxAckDelay An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum amount of time, in milliseconds, by which the Citrix ADC will delay sending acknowledgments.

maxIdleTimeout An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum idle timeout, in seconds, for a QUIC connection. A QUIC connection will be silently discarded by the Citrix ADC if it remains idle for longer than the minimum of the idle timeout values advertised by the Citrix ADC and the remote QUIC endpoint, and three times the current Probe Timeout (PTO).

maxUDPDatagramsPerBurst An integer value, specifying the maximum number of UDP datagrams that can be transmitted by the Citrix ADC in a single transmission burst on a QUIC connection.

maxUDPPayloadSize An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the size of the largest UDP datagram payload, in bytes, that the Citrix ADC is willing to receive on a QUIC connection.

newTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC NEW_TOKEN frames sent by the Citrix ADC.

retryTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC Retry packets sent by the Citrix ADC.

statelessAddressValidation Specify whether the Citrix ADC should perform stateless address validation for QUIC clients, by sending tokens in QUIC Retry packets during QUIC connection establishment, and by sending tokens in QUIC NEW_TOKEN frames after QUIC connection establishment.

refCnt Number of entities using this profile

builtin Flag to determine if the QUIC profile is built-in or not

feature The feature to be checked while applying this config

stateflag State flag

devno count

Example

show quic profile [profile name]

set quic profile

Modify QUIC profile parameter values of the specified QUIC profile.

Synopsis

set quic profile \[-ackDelayExponent <positive\_integer>] \[-activeConnectionIDlimit <positive\_integer>] \[-activeConnectionMigration \( ENABLED | DISABLED )] \[-congestionCtrlAlgorithm ] \[-initialMaxData <positive\_integer>] \[-initialMaxStreamDataBidiLocal <positive\_integer>] \[-initialMaxStreamDataBidiRemote <positive\_integer>] \[-initialMaxStreamDataUni <positive\_integer>] \[-initialMaxStreamsBidi <positive\_integer>] \[-initialMaxStreamsUni <positive\_integer>] \[-maxAckDelay <positive\_integer>] \[-maxIdleTimeout <positive\_integer>] \[-maxUDPDatagramsPerBurst <positive\_integer>] \[-maxUDPPayloadSize <positive\_integer>] \[-newTokenValidityPeriod <positive\_integer>] \[-retryTokenValidityPeriod <positive\_integer>] \[-statelessAddressValidation \( ENABLED | DISABLED )]

Arguments

name Name for the QUIC profile. Must begin with an ASCII alphanumeric or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@),equals sign (=), and hyphen (-) characters. Cannot be changed after the profile is created.

ackDelayExponent An integer value advertised by the Citrix ADC to the remote QUIC endpoint, indicating an exponent that the remote QUIC endpoint should use, to decode the ACK Delay field in QUIC ACK frames sent by the Citrix ADC. Default value: 3 Minimum value: 0 Maximum value: 20

activeConnectionIDlimit An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum number of QUIC connection IDs from the remote QUIC endpoint, that the Citrix ADC is willing to store. Default value: 3 Minimum value: 2 Maximum value: 8

activeConnectionMigration Specify whether the Citrix ADC should allow the remote QUIC endpoint to perform active QUIC connection migration.

Possible values: ENABLED, DISABLED Default value: ENABLED

congestionCtrlAlgorithm Specify the congestion control algorithm to be used for QUIC connections. The default congestion control algorithm is CUBIC.

Possible values: Default, NewReno, CUBIC, BBR Default value: Default

initialMaxData An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial value, in bytes, for the maximum amount of data that can be sent on a QUIC connection. Default value: 1048576 Minimum value: 8192 Maximum value: 67108864

initialMaxStreamDataBidiLocal An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the Citrix ADC. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamDataBidiRemote An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for bidirectional QUIC streams initiated by the remote QUIC endpoint. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamDataUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial flow control limit, in bytes, for unidirectional streams initiated by the remote QUIC endpoint. Default value: 262144 Minimum value: 8192 Maximum value: 8388608

initialMaxStreamsBidi An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of bidirectional streams the remote QUIC endpoint may initiate. Default value: 100 Minimum value: 1 Maximum value: 500

initialMaxStreamsUni An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the initial maximum number of unidirectional streams the remote QUIC endpoint may initiate. Default value: 10 Minimum value: 1 Maximum value: 500

maxAckDelay An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum amount of time, in milliseconds, by which the Citrix ADC will delay sending acknowledgments. Default value: 20 Minimum value: 10 Maximum value: 2000

maxIdleTimeout An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the maximum idle timeout, in seconds, for a QUIC connection. A QUIC connection will be silently discarded by the Citrix ADC if it remains idle for longer than the minimum of the idle timeout values advertised by the Citrix ADC and the remote QUIC endpoint, and three times the current Probe Timeout (PTO). Default value: 180 Minimum value: 1 Maximum value: 3600

maxUDPDatagramsPerBurst An integer value, specifying the maximum number of UDP datagrams that can be transmitted by the Citrix ADC in a single transmission burst on a QUIC connection. Default value: 8 Minimum value: 1 Maximum value: 256

maxUDPPayloadSize An integer value advertised by the Citrix ADC to the remote QUIC endpoint, specifying the size of the largest UDP datagram payload, in bytes, that the Citrix ADC is willing to receive on a QUIC connection. Default value: 1472 Minimum value: 1252 Maximum value: 9188

newTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC NEW_TOKEN frames sent by the Citrix ADC. Default value: 300 Minimum value: 1 Maximum value: 3600

retryTokenValidityPeriod An integer value, specifying the validity period, in seconds, of address validation tokens issued through QUIC Retry packets sent by the Citrix ADC. Default value: 10 Minimum value: 1 Maximum value: 120

statelessAddressValidation Specify whether the Citrix ADC should perform stateless address validation for QUIC clients, by sending tokens in QUIC Retry packets during QUIC connection establishment, and by sending tokens in QUIC NEW_TOKEN frames after QUIC connection establishment.

Possible values: ENABLED, DISABLED Default value: ENABLED

Example

set quic profile -statelessAddressValidation DISABLED -maxIdleTimeout 120

quic-profile