MAJOR: sample: converts uint and sint in 64 bits signed integer
This patch removes the 32 bits unsigned integer and the 32 bit signed
integer. It replaces these types by a unique type 64 bit signed.
This makes easy the usage of integer and clarify signed and unsigned use.
With the previous version, signed and unsigned are used ones in place of
others, and sometimes the converter loose the sign. For example, divisions
are processed with "unsigned", if one entry is negative, the result is
wrong.
Note that the integer pattern matching and dotted version pattern matching
are already working with signed 64 bits integer values.
There is one user-visible change : the "uint()" and "sint()" sample fetch
functions which used to return a constant integer have been replaced with
a new more natural, unified "int()" function. These functions were only
introduced in the latest 1.6-dev2 so there's no impact on regular
deployments.
diff --git a/doc/configuration.txt b/doc/configuration.txt
index 7c90ff4..2782c20 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -11030,12 +11030,12 @@
The currently available list of transformation keywords include :
add(<value>)
- Adds <value> to the input value of type unsigned integer, and returns the
- result as an unsigned integer.
+ Adds <value> to the input value of type signed integer, and returns the
+ result as a signed integer.
and(<value>)
- Performs a bitwise "AND" between <value> and the input value of type unsigned
- integer, and returns the result as an unsigned integer.
+ Performs a bitwise "AND" between <value> and the input value of type signed
+ integer, and returns the result as an signed integer.
base64
Converts a binary input sample to a base64 string. It is used to log or
@@ -11043,7 +11043,7 @@
an SSL ID can be copied in a header).
bool
- Returns a boolean TRUE if the input value of type unsigned integer is
+ Returns a boolean TRUE if the input value of type signed integer is
non-null, otherwise returns FALSE. Used in conjunction with and(), it can be
used to report true/false for bit testing on input values (eg: verify the
presence of a flag).
@@ -11054,8 +11054,8 @@
optionnaly truncated at the given length.
cpl
- Takes the input value of type unsigned integer, applies a twos-complement
- (flips all bits) and returns the result as an unsigned integer.
+ Takes the input value of type signed integer, applies a ones-complement
+ (flips all bits) and returns the result as an signed integer.
crc32([<avalanche>])
Hashes a binary input sample into an unsigned 32-bit quantity using the CRC32
@@ -11090,9 +11090,9 @@
converter only exists when haproxy was built with debugging enabled.
div(<value>)
- Divides the input value of type unsigned integer by <value>, and returns the
- result as an unsigned integer. If <value> is null, the largest unsigned
- integer is returned (typically 2^32-1).
+ Divides the input value of type signed integer by <value>, and returns the
+ result as an signed integer. If <value> is null, the largest unsigned
+ integer is returned (typically 2^63-1).
djb2([<avalanche>])
Hashes a binary input sample into an unsigned 32-bit quantity using the DJB2
@@ -11106,7 +11106,7 @@
"hash-type" directive.
even
- Returns a boolean TRUE if the input value of type unsigned integer is even
+ Returns a boolean TRUE if the input value of type signed integer is even
otherwise returns FALSE. It is functionally equivalent to "not,and(1),bool".
field(<index>,<delimiters>)
@@ -11285,33 +11285,33 @@
`------------------------------------ leading spaces ignored
mod(<value>)
- Divides the input value of type unsigned integer by <value>, and returns the
- remainder as an unsigned integer. If <value> is null, then zero is returned.
+ Divides the input value of type signed integer by <value>, and returns the
+ remainder as an signed integer. If <value> is null, then zero is returned.
mul(<value>)
- Multiplies the input value of type unsigned integer by <value>, and returns
- the product as an unsigned integer. In case of overflow, the higher bits are
+ Multiplies the input value of type signed integer by <value>, and returns
+ the product as an signed integer. In case of overflow, the higher bits are
lost, leading to seemingly strange values.
neg
- Takes the input value of type unsigned integer, computes the opposite value,
- and returns the remainder as an unsigned integer. 0 is identity. This
- operator is provided for reversed subtracts : in order to subtract the input
- from a constant, simply perform a "neg,add(value)".
+ Takes the input value of type signed integer, computes the opposite value,
+ and returns the remainder as an signed integer. 0 is identity. This operator
+ is provided for reversed subtracts : in order to subtract the input from a
+ constant, simply perform a "neg,add(value)".
not
- Returns a boolean FALSE if the input value of type unsigned integer is
+ Returns a boolean FALSE if the input value of type signed integer is
non-null, otherwise returns TRUE. Used in conjunction with and(), it can be
used to report true/false for bit testing on input values (eg: verify the
absence of a flag).
odd
- Returns a boolean TRUE if the input value of type unsigned integer is odd
+ Returns a boolean TRUE if the input value of type signed integer is odd
otherwise returns FALSE. It is functionally equivalent to "and(1),bool".
or(<value>)
- Performs a bitwise "OR" between <value> and the input value of type unsigned
- integer, and returns the result as an unsigned integer.
+ Performs a bitwise "OR" between <value> and the input value of type signed
+ integer, and returns the result as an signed integer.
regsub(<regex>,<subst>[,<flags>])
Applies a regex-based substitution to the input string. It does the same
@@ -11375,8 +11375,8 @@
contain characters 'a-z', 'A-Z', '0-9' and '_'.
sub(<value>)
- Subtracts <value> from the input value of type unsigned integer, and returns
- the result as an unsigned integer. Note: in order to subtract the input from
+ Subtracts <value> from the input value of type signed integer, and returns
+ the result as an signed integer. Note: in order to subtract the input from
a constant, simply perform a "neg,add(value)".
table_bytes_in_rate(<table>)
@@ -11558,7 +11558,7 @@
xor(<value>)
Performs a bitwise "XOR" (exclusive OR) between <value> and the input value
- of type unsigned integer, and returns the result as an unsigned integer.
+ of type signed integer, and returns the result as an signed integer.
7.3.2. Fetching samples from internal states
@@ -11709,6 +11709,9 @@
tcp-request content accept if ! too_fast
tcp-request content accept if WAIT_END
+int(<integer>) : signed integer
+ Returns a signed integer.
+
ipv4(<ipv4>) : ipv4
Returns an ipv4.
@@ -11753,9 +11756,6 @@
needed to take some routing decisions for example, or just for debugging
purposes. This random must not be used for security purposes.
-sint(<sint>) : signed integer
- Returns a signed integer.
-
srv_conn([<backend>/]<server>) : integer
Returns an integer value corresponding to the number of currently established
connections on the designated server, possibly including the connection being
@@ -11806,9 +11806,6 @@
stick-table or in the designated stick-table. See also src_conn_cnt and
table_avl for other entry counting methods.
-uint(<uint>) : unsigned integer
- Returns an unsigned integer.
-
var(<var-name>) : undefined
Returns a variable with the stored type. If the variable is not set, the
sample fetch fails. The name of the variable starts by an indication about its