mapper.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586
  1. #ifdef __KERNEL__
  2. # include <linux/string.h>
  3. # include <linux/slab.h>
  4. # include <linux/bug.h>
  5. # include <linux/kernel.h>
  6. # ifndef dprintk
  7. # define dprintk(args...)
  8. # endif
  9. #else
  10. # include <string.h>
  11. # include <stdio.h>
  12. # include <stdlib.h>
  13. # include <assert.h>
  14. # define BUG_ON(x) assert(!(x))
  15. # define dprintk(args...) /* printf(args) */
  16. # define kmalloc(x, f) malloc(x)
  17. # define kfree(x) free(x)
  18. #endif
  19. #include <linux/crush/crush.h>
  20. #include <linux/crush/hash.h>
  21. #include <linux/crush/mapper.h>
  22. /*
  23. * Implement the core CRUSH mapping algorithm.
  24. */
  25. /**
  26. * crush_find_rule - find a crush_rule id for a given ruleset, type, and size.
  27. * @map: the crush_map
  28. * @ruleset: the storage ruleset id (user defined)
  29. * @type: storage ruleset type (user defined)
  30. * @size: output set size
  31. */
  32. int crush_find_rule(const struct crush_map *map, int ruleset, int type, int size)
  33. {
  34. __u32 i;
  35. for (i = 0; i < map->max_rules; i++) {
  36. if (map->rules[i] &&
  37. map->rules[i]->mask.ruleset == ruleset &&
  38. map->rules[i]->mask.type == type &&
  39. map->rules[i]->mask.min_size <= size &&
  40. map->rules[i]->mask.max_size >= size)
  41. return i;
  42. }
  43. return -1;
  44. }
  45. /*
  46. * bucket choose methods
  47. *
  48. * For each bucket algorithm, we have a "choose" method that, given a
  49. * crush input @x and replica position (usually, position in output set) @r,
  50. * will produce an item in the bucket.
  51. */
  52. /*
  53. * Choose based on a random permutation of the bucket.
  54. *
  55. * We used to use some prime number arithmetic to do this, but it
  56. * wasn't very random, and had some other bad behaviors. Instead, we
  57. * calculate an actual random permutation of the bucket members.
  58. * Since this is expensive, we optimize for the r=0 case, which
  59. * captures the vast majority of calls.
  60. */
  61. static int bucket_perm_choose(struct crush_bucket *bucket,
  62. int x, int r)
  63. {
  64. unsigned int pr = r % bucket->size;
  65. unsigned int i, s;
  66. /* start a new permutation if @x has changed */
  67. if (bucket->perm_x != (__u32)x || bucket->perm_n == 0) {
  68. dprintk("bucket %d new x=%d\n", bucket->id, x);
  69. bucket->perm_x = x;
  70. /* optimize common r=0 case */
  71. if (pr == 0) {
  72. s = crush_hash32_3(bucket->hash, x, bucket->id, 0) %
  73. bucket->size;
  74. bucket->perm[0] = s;
  75. bucket->perm_n = 0xffff; /* magic value, see below */
  76. goto out;
  77. }
  78. for (i = 0; i < bucket->size; i++)
  79. bucket->perm[i] = i;
  80. bucket->perm_n = 0;
  81. } else if (bucket->perm_n == 0xffff) {
  82. /* clean up after the r=0 case above */
  83. for (i = 1; i < bucket->size; i++)
  84. bucket->perm[i] = i;
  85. bucket->perm[bucket->perm[0]] = 0;
  86. bucket->perm_n = 1;
  87. }
  88. /* calculate permutation up to pr */
  89. for (i = 0; i < bucket->perm_n; i++)
  90. dprintk(" perm_choose have %d: %d\n", i, bucket->perm[i]);
  91. while (bucket->perm_n <= pr) {
  92. unsigned int p = bucket->perm_n;
  93. /* no point in swapping the final entry */
  94. if (p < bucket->size - 1) {
  95. i = crush_hash32_3(bucket->hash, x, bucket->id, p) %
  96. (bucket->size - p);
  97. if (i) {
  98. unsigned int t = bucket->perm[p + i];
  99. bucket->perm[p + i] = bucket->perm[p];
  100. bucket->perm[p] = t;
  101. }
  102. dprintk(" perm_choose swap %d with %d\n", p, p+i);
  103. }
  104. bucket->perm_n++;
  105. }
  106. for (i = 0; i < bucket->size; i++)
  107. dprintk(" perm_choose %d: %d\n", i, bucket->perm[i]);
  108. s = bucket->perm[pr];
  109. out:
  110. dprintk(" perm_choose %d sz=%d x=%d r=%d (%d) s=%d\n", bucket->id,
  111. bucket->size, x, r, pr, s);
  112. return bucket->items[s];
  113. }
  114. /* uniform */
  115. static int bucket_uniform_choose(struct crush_bucket_uniform *bucket,
  116. int x, int r)
  117. {
  118. return bucket_perm_choose(&bucket->h, x, r);
  119. }
  120. /* list */
  121. static int bucket_list_choose(struct crush_bucket_list *bucket,
  122. int x, int r)
  123. {
  124. int i;
  125. for (i = bucket->h.size-1; i >= 0; i--) {
  126. __u64 w = crush_hash32_4(bucket->h.hash,x, bucket->h.items[i],
  127. r, bucket->h.id);
  128. w &= 0xffff;
  129. dprintk("list_choose i=%d x=%d r=%d item %d weight %x "
  130. "sw %x rand %llx",
  131. i, x, r, bucket->h.items[i], bucket->item_weights[i],
  132. bucket->sum_weights[i], w);
  133. w *= bucket->sum_weights[i];
  134. w = w >> 16;
  135. /*dprintk(" scaled %llx\n", w);*/
  136. if (w < bucket->item_weights[i])
  137. return bucket->h.items[i];
  138. }
  139. dprintk("bad list sums for bucket %d\n", bucket->h.id);
  140. return bucket->h.items[0];
  141. }
  142. /* (binary) tree */
  143. static int height(int n)
  144. {
  145. int h = 0;
  146. while ((n & 1) == 0) {
  147. h++;
  148. n = n >> 1;
  149. }
  150. return h;
  151. }
  152. static int left(int x)
  153. {
  154. int h = height(x);
  155. return x - (1 << (h-1));
  156. }
  157. static int right(int x)
  158. {
  159. int h = height(x);
  160. return x + (1 << (h-1));
  161. }
  162. static int terminal(int x)
  163. {
  164. return x & 1;
  165. }
  166. static int bucket_tree_choose(struct crush_bucket_tree *bucket,
  167. int x, int r)
  168. {
  169. int n, l;
  170. __u32 w;
  171. __u64 t;
  172. /* start at root */
  173. n = bucket->num_nodes >> 1;
  174. while (!terminal(n)) {
  175. /* pick point in [0, w) */
  176. w = bucket->node_weights[n];
  177. t = (__u64)crush_hash32_4(bucket->h.hash, x, n, r,
  178. bucket->h.id) * (__u64)w;
  179. t = t >> 32;
  180. /* descend to the left or right? */
  181. l = left(n);
  182. if (t < bucket->node_weights[l])
  183. n = l;
  184. else
  185. n = right(n);
  186. }
  187. return bucket->h.items[n >> 1];
  188. }
  189. /* straw */
  190. static int bucket_straw_choose(struct crush_bucket_straw *bucket,
  191. int x, int r)
  192. {
  193. __u32 i;
  194. int high = 0;
  195. __u64 high_draw = 0;
  196. __u64 draw;
  197. for (i = 0; i < bucket->h.size; i++) {
  198. draw = crush_hash32_3(bucket->h.hash, x, bucket->h.items[i], r);
  199. draw &= 0xffff;
  200. draw *= bucket->straws[i];
  201. if (i == 0 || draw > high_draw) {
  202. high = i;
  203. high_draw = draw;
  204. }
  205. }
  206. return bucket->h.items[high];
  207. }
  208. static int crush_bucket_choose(struct crush_bucket *in, int x, int r)
  209. {
  210. dprintk(" crush_bucket_choose %d x=%d r=%d\n", in->id, x, r);
  211. BUG_ON(in->size == 0);
  212. switch (in->alg) {
  213. case CRUSH_BUCKET_UNIFORM:
  214. return bucket_uniform_choose((struct crush_bucket_uniform *)in,
  215. x, r);
  216. case CRUSH_BUCKET_LIST:
  217. return bucket_list_choose((struct crush_bucket_list *)in,
  218. x, r);
  219. case CRUSH_BUCKET_TREE:
  220. return bucket_tree_choose((struct crush_bucket_tree *)in,
  221. x, r);
  222. case CRUSH_BUCKET_STRAW:
  223. return bucket_straw_choose((struct crush_bucket_straw *)in,
  224. x, r);
  225. default:
  226. dprintk("unknown bucket %d alg %d\n", in->id, in->alg);
  227. return in->items[0];
  228. }
  229. }
  230. /*
  231. * true if device is marked "out" (failed, fully offloaded)
  232. * of the cluster
  233. */
  234. static int is_out(const struct crush_map *map, const __u32 *weight, int item, int x)
  235. {
  236. if (weight[item] >= 0x10000)
  237. return 0;
  238. if (weight[item] == 0)
  239. return 1;
  240. if ((crush_hash32_2(CRUSH_HASH_RJENKINS1, x, item) & 0xffff)
  241. < weight[item])
  242. return 0;
  243. return 1;
  244. }
  245. /**
  246. * crush_choose - choose numrep distinct items of given type
  247. * @map: the crush_map
  248. * @bucket: the bucket we are choose an item from
  249. * @x: crush input value
  250. * @numrep: the number of items to choose
  251. * @type: the type of item to choose
  252. * @out: pointer to output vector
  253. * @outpos: our position in that vector
  254. * @firstn: true if choosing "first n" items, false if choosing "indep"
  255. * @recurse_to_leaf: true if we want one device under each item of given type
  256. * @descend_once: true if we should only try one descent before giving up
  257. * @out2: second output vector for leaf items (if @recurse_to_leaf)
  258. */
  259. static int crush_choose(const struct crush_map *map,
  260. struct crush_bucket *bucket,
  261. const __u32 *weight,
  262. int x, int numrep, int type,
  263. int *out, int outpos,
  264. int firstn, int recurse_to_leaf,
  265. int descend_once, int *out2)
  266. {
  267. int rep;
  268. unsigned int ftotal, flocal;
  269. int retry_descent, retry_bucket, skip_rep;
  270. struct crush_bucket *in = bucket;
  271. int r;
  272. int i;
  273. int item = 0;
  274. int itemtype;
  275. int collide, reject;
  276. dprintk("CHOOSE%s bucket %d x %d outpos %d numrep %d\n", recurse_to_leaf ? "_LEAF" : "",
  277. bucket->id, x, outpos, numrep);
  278. for (rep = outpos; rep < numrep; rep++) {
  279. /* keep trying until we get a non-out, non-colliding item */
  280. ftotal = 0;
  281. skip_rep = 0;
  282. do {
  283. retry_descent = 0;
  284. in = bucket; /* initial bucket */
  285. /* choose through intervening buckets */
  286. flocal = 0;
  287. do {
  288. collide = 0;
  289. retry_bucket = 0;
  290. r = rep;
  291. if (in->alg == CRUSH_BUCKET_UNIFORM) {
  292. /* be careful */
  293. if (firstn || (__u32)numrep >= in->size)
  294. /* r' = r + f_total */
  295. r += ftotal;
  296. else if (in->size % numrep == 0)
  297. /* r'=r+(n+1)*f_local */
  298. r += (numrep+1) *
  299. (flocal+ftotal);
  300. else
  301. /* r' = r + n*f_local */
  302. r += numrep * (flocal+ftotal);
  303. } else {
  304. if (firstn)
  305. /* r' = r + f_total */
  306. r += ftotal;
  307. else
  308. /* r' = r + n*f_local */
  309. r += numrep * (flocal+ftotal);
  310. }
  311. /* bucket choose */
  312. if (in->size == 0) {
  313. reject = 1;
  314. goto reject;
  315. }
  316. if (map->choose_local_fallback_tries > 0 &&
  317. flocal >= (in->size>>1) &&
  318. flocal > map->choose_local_fallback_tries)
  319. item = bucket_perm_choose(in, x, r);
  320. else
  321. item = crush_bucket_choose(in, x, r);
  322. if (item >= map->max_devices) {
  323. dprintk(" bad item %d\n", item);
  324. skip_rep = 1;
  325. break;
  326. }
  327. /* desired type? */
  328. if (item < 0)
  329. itemtype = map->buckets[-1-item]->type;
  330. else
  331. itemtype = 0;
  332. dprintk(" item %d type %d\n", item, itemtype);
  333. /* keep going? */
  334. if (itemtype != type) {
  335. if (item >= 0 ||
  336. (-1-item) >= map->max_buckets) {
  337. dprintk(" bad item type %d\n", type);
  338. skip_rep = 1;
  339. break;
  340. }
  341. in = map->buckets[-1-item];
  342. retry_bucket = 1;
  343. continue;
  344. }
  345. /* collision? */
  346. for (i = 0; i < outpos; i++) {
  347. if (out[i] == item) {
  348. collide = 1;
  349. break;
  350. }
  351. }
  352. reject = 0;
  353. if (!collide && recurse_to_leaf) {
  354. if (item < 0) {
  355. if (crush_choose(map,
  356. map->buckets[-1-item],
  357. weight,
  358. x, outpos+1, 0,
  359. out2, outpos,
  360. firstn, 0,
  361. map->chooseleaf_descend_once,
  362. NULL) <= outpos)
  363. /* didn't get leaf */
  364. reject = 1;
  365. } else {
  366. /* we already have a leaf! */
  367. out2[outpos] = item;
  368. }
  369. }
  370. if (!reject) {
  371. /* out? */
  372. if (itemtype == 0)
  373. reject = is_out(map, weight,
  374. item, x);
  375. else
  376. reject = 0;
  377. }
  378. reject:
  379. if (reject || collide) {
  380. ftotal++;
  381. flocal++;
  382. if (reject && descend_once)
  383. /* let outer call try again */
  384. skip_rep = 1;
  385. else if (collide && flocal <= map->choose_local_tries)
  386. /* retry locally a few times */
  387. retry_bucket = 1;
  388. else if (map->choose_local_fallback_tries > 0 &&
  389. flocal <= in->size + map->choose_local_fallback_tries)
  390. /* exhaustive bucket search */
  391. retry_bucket = 1;
  392. else if (ftotal <= map->choose_total_tries)
  393. /* then retry descent */
  394. retry_descent = 1;
  395. else
  396. /* else give up */
  397. skip_rep = 1;
  398. dprintk(" reject %d collide %d "
  399. "ftotal %u flocal %u\n",
  400. reject, collide, ftotal,
  401. flocal);
  402. }
  403. } while (retry_bucket);
  404. } while (retry_descent);
  405. if (skip_rep) {
  406. dprintk("skip rep\n");
  407. continue;
  408. }
  409. dprintk("CHOOSE got %d\n", item);
  410. out[outpos] = item;
  411. outpos++;
  412. }
  413. dprintk("CHOOSE returns %d\n", outpos);
  414. return outpos;
  415. }
  416. /**
  417. * crush_do_rule - calculate a mapping with the given input and rule
  418. * @map: the crush_map
  419. * @ruleno: the rule id
  420. * @x: hash input
  421. * @result: pointer to result vector
  422. * @result_max: maximum result size
  423. */
  424. int crush_do_rule(const struct crush_map *map,
  425. int ruleno, int x, int *result, int result_max,
  426. const __u32 *weight)
  427. {
  428. int result_len;
  429. int a[CRUSH_MAX_SET];
  430. int b[CRUSH_MAX_SET];
  431. int c[CRUSH_MAX_SET];
  432. int recurse_to_leaf;
  433. int *w;
  434. int wsize = 0;
  435. int *o;
  436. int osize;
  437. int *tmp;
  438. struct crush_rule *rule;
  439. __u32 step;
  440. int i, j;
  441. int numrep;
  442. int firstn;
  443. const int descend_once = 0;
  444. if ((__u32)ruleno >= map->max_rules) {
  445. dprintk(" bad ruleno %d\n", ruleno);
  446. return 0;
  447. }
  448. rule = map->rules[ruleno];
  449. result_len = 0;
  450. w = a;
  451. o = b;
  452. for (step = 0; step < rule->len; step++) {
  453. struct crush_rule_step *curstep = &rule->steps[step];
  454. firstn = 0;
  455. switch (curstep->op) {
  456. case CRUSH_RULE_TAKE:
  457. w[0] = curstep->arg1;
  458. wsize = 1;
  459. break;
  460. case CRUSH_RULE_CHOOSE_LEAF_FIRSTN:
  461. case CRUSH_RULE_CHOOSE_FIRSTN:
  462. firstn = 1;
  463. /* fall through */
  464. case CRUSH_RULE_CHOOSE_LEAF_INDEP:
  465. case CRUSH_RULE_CHOOSE_INDEP:
  466. if (wsize == 0)
  467. break;
  468. recurse_to_leaf =
  469. curstep->op ==
  470. CRUSH_RULE_CHOOSE_LEAF_FIRSTN ||
  471. curstep->op ==
  472. CRUSH_RULE_CHOOSE_LEAF_INDEP;
  473. /* reset output */
  474. osize = 0;
  475. for (i = 0; i < wsize; i++) {
  476. /*
  477. * see CRUSH_N, CRUSH_N_MINUS macros.
  478. * basically, numrep <= 0 means relative to
  479. * the provided result_max
  480. */
  481. numrep = curstep->arg1;
  482. if (numrep <= 0) {
  483. numrep += result_max;
  484. if (numrep <= 0)
  485. continue;
  486. }
  487. j = 0;
  488. osize += crush_choose(map,
  489. map->buckets[-1-w[i]],
  490. weight,
  491. x, numrep,
  492. curstep->arg2,
  493. o+osize, j,
  494. firstn,
  495. recurse_to_leaf,
  496. descend_once, c+osize);
  497. }
  498. if (recurse_to_leaf)
  499. /* copy final _leaf_ values to output set */
  500. memcpy(o, c, osize*sizeof(*o));
  501. /* swap t and w arrays */
  502. tmp = o;
  503. o = w;
  504. w = tmp;
  505. wsize = osize;
  506. break;
  507. case CRUSH_RULE_EMIT:
  508. for (i = 0; i < wsize && result_len < result_max; i++) {
  509. result[result_len] = w[i];
  510. result_len++;
  511. }
  512. wsize = 0;
  513. break;
  514. default:
  515. dprintk(" unknown op %d at step %d\n",
  516. curstep->op, step);
  517. break;
  518. }
  519. }
  520. return result_len;
  521. }