tnum.c 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. /* tnum: tracked (or tristate) numbers
  2. *
  3. * A tnum tracks knowledge about the bits of a value. Each bit can be either
  4. * known (0 or 1), or unknown (x). Arithmetic operations on tnums will
  5. * propagate the unknown bits such that the tnum result represents all the
  6. * possible results for possible values of the operands.
  7. */
  8. #include <linux/kernel.h>
  9. #include <linux/tnum.h>
  10. #define TNUM(_v, _m) (struct tnum){.value = _v, .mask = _m}
  11. /* A completely unknown value */
  12. const struct tnum tnum_unknown = { .value = 0, .mask = -1 };
  13. struct tnum tnum_const(u64 value)
  14. {
  15. return TNUM(value, 0);
  16. }
  17. struct tnum tnum_lshift(struct tnum a, u8 shift)
  18. {
  19. return TNUM(a.value << shift, a.mask << shift);
  20. }
  21. struct tnum tnum_rshift(struct tnum a, u8 shift)
  22. {
  23. return TNUM(a.value >> shift, a.mask >> shift);
  24. }
  25. struct tnum tnum_add(struct tnum a, struct tnum b)
  26. {
  27. u64 sm, sv, sigma, chi, mu;
  28. sm = a.mask + b.mask;
  29. sv = a.value + b.value;
  30. sigma = sm + sv;
  31. chi = sigma ^ sv;
  32. mu = chi | a.mask | b.mask;
  33. return TNUM(sv & ~mu, mu);
  34. }
  35. struct tnum tnum_sub(struct tnum a, struct tnum b)
  36. {
  37. u64 dv, alpha, beta, chi, mu;
  38. dv = a.value - b.value;
  39. alpha = dv + a.mask;
  40. beta = dv - b.mask;
  41. chi = alpha ^ beta;
  42. mu = chi | a.mask | b.mask;
  43. return TNUM(dv & ~mu, mu);
  44. }
  45. struct tnum tnum_and(struct tnum a, struct tnum b)
  46. {
  47. u64 alpha, beta, v;
  48. alpha = a.value | a.mask;
  49. beta = b.value | b.mask;
  50. v = a.value & b.value;
  51. return TNUM(v, alpha & beta & ~v);
  52. }
  53. struct tnum tnum_or(struct tnum a, struct tnum b)
  54. {
  55. u64 v, mu;
  56. v = a.value | b.value;
  57. mu = a.mask | b.mask;
  58. return TNUM(v, mu & ~v);
  59. }
  60. struct tnum tnum_xor(struct tnum a, struct tnum b)
  61. {
  62. u64 v, mu;
  63. v = a.value ^ b.value;
  64. mu = a.mask | b.mask;
  65. return TNUM(v & ~mu, mu);
  66. }
  67. /* half-multiply add: acc += (unknown * mask * value).
  68. * An intermediate step in the multiply algorithm.
  69. */
  70. static struct tnum hma(struct tnum acc, u64 value, u64 mask)
  71. {
  72. while (mask) {
  73. if (mask & 1)
  74. acc = tnum_add(acc, TNUM(0, value));
  75. mask >>= 1;
  76. value <<= 1;
  77. }
  78. return acc;
  79. }
  80. struct tnum tnum_mul(struct tnum a, struct tnum b)
  81. {
  82. struct tnum acc;
  83. u64 pi;
  84. pi = a.value * b.value;
  85. acc = hma(TNUM(pi, 0), a.mask, b.mask | b.value);
  86. return hma(acc, b.mask, a.value);
  87. }
  88. /* Note that if a and b disagree - i.e. one has a 'known 1' where the other has
  89. * a 'known 0' - this will return a 'known 1' for that bit.
  90. */
  91. struct tnum tnum_intersect(struct tnum a, struct tnum b)
  92. {
  93. u64 v, mu;
  94. v = a.value | b.value;
  95. mu = a.mask & b.mask;
  96. return TNUM(v & ~mu, mu);
  97. }
  98. struct tnum tnum_cast(struct tnum a, u8 size)
  99. {
  100. a.value &= (1ULL << (size * 8)) - 1;
  101. a.mask &= (1ULL << (size * 8)) - 1;
  102. return a;
  103. }
  104. bool tnum_is_aligned(struct tnum a, u64 size)
  105. {
  106. if (!size)
  107. return true;
  108. return !((a.value | a.mask) & (size - 1));
  109. }
  110. bool tnum_in(struct tnum a, struct tnum b)
  111. {
  112. if (b.mask & ~a.mask)
  113. return false;
  114. b.value &= ~a.mask;
  115. return a.value == b.value;
  116. }
  117. int tnum_strn(char *str, size_t size, struct tnum a)
  118. {
  119. return snprintf(str, size, "(%#llx; %#llx)", a.value, a.mask);
  120. }
  121. EXPORT_SYMBOL_GPL(tnum_strn);
  122. int tnum_sbin(char *str, size_t size, struct tnum a)
  123. {
  124. size_t n;
  125. for (n = 64; n; n--) {
  126. if (n < size) {
  127. if (a.mask & 1)
  128. str[n - 1] = 'x';
  129. else if (a.value & 1)
  130. str[n - 1] = '1';
  131. else
  132. str[n - 1] = '0';
  133. }
  134. a.mask >>= 1;
  135. a.value >>= 1;
  136. }
  137. str[min(size - 1, (size_t)64)] = 0;
  138. return 64;
  139. }