mapper.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579
  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. * @out2: second output vector for leaf items (if @recurse_to_leaf)
  257. */
  258. static int crush_choose(const struct crush_map *map,
  259. struct crush_bucket *bucket,
  260. const __u32 *weight,
  261. int x, int numrep, int type,
  262. int *out, int outpos,
  263. int firstn, int recurse_to_leaf,
  264. int *out2)
  265. {
  266. int rep;
  267. unsigned int ftotal, flocal;
  268. int retry_descent, retry_bucket, skip_rep;
  269. struct crush_bucket *in = bucket;
  270. int r;
  271. int i;
  272. int item = 0;
  273. int itemtype;
  274. int collide, reject;
  275. dprintk("CHOOSE%s bucket %d x %d outpos %d numrep %d\n", recurse_to_leaf ? "_LEAF" : "",
  276. bucket->id, x, outpos, numrep);
  277. for (rep = outpos; rep < numrep; rep++) {
  278. /* keep trying until we get a non-out, non-colliding item */
  279. ftotal = 0;
  280. skip_rep = 0;
  281. do {
  282. retry_descent = 0;
  283. in = bucket; /* initial bucket */
  284. /* choose through intervening buckets */
  285. flocal = 0;
  286. do {
  287. collide = 0;
  288. retry_bucket = 0;
  289. r = rep;
  290. if (in->alg == CRUSH_BUCKET_UNIFORM) {
  291. /* be careful */
  292. if (firstn || (__u32)numrep >= in->size)
  293. /* r' = r + f_total */
  294. r += ftotal;
  295. else if (in->size % numrep == 0)
  296. /* r'=r+(n+1)*f_local */
  297. r += (numrep+1) *
  298. (flocal+ftotal);
  299. else
  300. /* r' = r + n*f_local */
  301. r += numrep * (flocal+ftotal);
  302. } else {
  303. if (firstn)
  304. /* r' = r + f_total */
  305. r += ftotal;
  306. else
  307. /* r' = r + n*f_local */
  308. r += numrep * (flocal+ftotal);
  309. }
  310. /* bucket choose */
  311. if (in->size == 0) {
  312. reject = 1;
  313. goto reject;
  314. }
  315. if (map->choose_local_fallback_tries > 0 &&
  316. flocal >= (in->size>>1) &&
  317. flocal > map->choose_local_fallback_tries)
  318. item = bucket_perm_choose(in, x, r);
  319. else
  320. item = crush_bucket_choose(in, x, r);
  321. if (item >= map->max_devices) {
  322. dprintk(" bad item %d\n", item);
  323. skip_rep = 1;
  324. break;
  325. }
  326. /* desired type? */
  327. if (item < 0)
  328. itemtype = map->buckets[-1-item]->type;
  329. else
  330. itemtype = 0;
  331. dprintk(" item %d type %d\n", item, itemtype);
  332. /* keep going? */
  333. if (itemtype != type) {
  334. if (item >= 0 ||
  335. (-1-item) >= map->max_buckets) {
  336. dprintk(" bad item type %d\n", type);
  337. skip_rep = 1;
  338. break;
  339. }
  340. in = map->buckets[-1-item];
  341. retry_bucket = 1;
  342. continue;
  343. }
  344. /* collision? */
  345. for (i = 0; i < outpos; i++) {
  346. if (out[i] == item) {
  347. collide = 1;
  348. break;
  349. }
  350. }
  351. reject = 0;
  352. if (recurse_to_leaf) {
  353. if (item < 0) {
  354. if (crush_choose(map,
  355. map->buckets[-1-item],
  356. weight,
  357. x, outpos+1, 0,
  358. out2, outpos,
  359. firstn, 0,
  360. NULL) <= outpos)
  361. /* didn't get leaf */
  362. reject = 1;
  363. } else {
  364. /* we already have a leaf! */
  365. out2[outpos] = item;
  366. }
  367. }
  368. if (!reject) {
  369. /* out? */
  370. if (itemtype == 0)
  371. reject = is_out(map, weight,
  372. item, x);
  373. else
  374. reject = 0;
  375. }
  376. reject:
  377. if (reject || collide) {
  378. ftotal++;
  379. flocal++;
  380. if (collide && flocal <= map->choose_local_tries)
  381. /* retry locally a few times */
  382. retry_bucket = 1;
  383. else if (map->choose_local_fallback_tries > 0 &&
  384. flocal <= in->size + map->choose_local_fallback_tries)
  385. /* exhaustive bucket search */
  386. retry_bucket = 1;
  387. else if (ftotal <= map->choose_total_tries)
  388. /* then retry descent */
  389. retry_descent = 1;
  390. else
  391. /* else give up */
  392. skip_rep = 1;
  393. dprintk(" reject %d collide %d "
  394. "ftotal %u flocal %u\n",
  395. reject, collide, ftotal,
  396. flocal);
  397. }
  398. } while (retry_bucket);
  399. } while (retry_descent);
  400. if (skip_rep) {
  401. dprintk("skip rep\n");
  402. continue;
  403. }
  404. dprintk("CHOOSE got %d\n", item);
  405. out[outpos] = item;
  406. outpos++;
  407. }
  408. dprintk("CHOOSE returns %d\n", outpos);
  409. return outpos;
  410. }
  411. /**
  412. * crush_do_rule - calculate a mapping with the given input and rule
  413. * @map: the crush_map
  414. * @ruleno: the rule id
  415. * @x: hash input
  416. * @result: pointer to result vector
  417. * @result_max: maximum result size
  418. */
  419. int crush_do_rule(const struct crush_map *map,
  420. int ruleno, int x, int *result, int result_max,
  421. const __u32 *weight)
  422. {
  423. int result_len;
  424. int a[CRUSH_MAX_SET];
  425. int b[CRUSH_MAX_SET];
  426. int c[CRUSH_MAX_SET];
  427. int recurse_to_leaf;
  428. int *w;
  429. int wsize = 0;
  430. int *o;
  431. int osize;
  432. int *tmp;
  433. struct crush_rule *rule;
  434. __u32 step;
  435. int i, j;
  436. int numrep;
  437. int firstn;
  438. if ((__u32)ruleno >= map->max_rules) {
  439. dprintk(" bad ruleno %d\n", ruleno);
  440. return 0;
  441. }
  442. rule = map->rules[ruleno];
  443. result_len = 0;
  444. w = a;
  445. o = b;
  446. for (step = 0; step < rule->len; step++) {
  447. struct crush_rule_step *curstep = &rule->steps[step];
  448. firstn = 0;
  449. switch (curstep->op) {
  450. case CRUSH_RULE_TAKE:
  451. w[0] = curstep->arg1;
  452. wsize = 1;
  453. break;
  454. case CRUSH_RULE_CHOOSE_LEAF_FIRSTN:
  455. case CRUSH_RULE_CHOOSE_FIRSTN:
  456. firstn = 1;
  457. /* fall through */
  458. case CRUSH_RULE_CHOOSE_LEAF_INDEP:
  459. case CRUSH_RULE_CHOOSE_INDEP:
  460. if (wsize == 0)
  461. break;
  462. recurse_to_leaf =
  463. curstep->op ==
  464. CRUSH_RULE_CHOOSE_LEAF_FIRSTN ||
  465. curstep->op ==
  466. CRUSH_RULE_CHOOSE_LEAF_INDEP;
  467. /* reset output */
  468. osize = 0;
  469. for (i = 0; i < wsize; i++) {
  470. /*
  471. * see CRUSH_N, CRUSH_N_MINUS macros.
  472. * basically, numrep <= 0 means relative to
  473. * the provided result_max
  474. */
  475. numrep = curstep->arg1;
  476. if (numrep <= 0) {
  477. numrep += result_max;
  478. if (numrep <= 0)
  479. continue;
  480. }
  481. j = 0;
  482. osize += crush_choose(map,
  483. map->buckets[-1-w[i]],
  484. weight,
  485. x, numrep,
  486. curstep->arg2,
  487. o+osize, j,
  488. firstn,
  489. recurse_to_leaf, c+osize);
  490. }
  491. if (recurse_to_leaf)
  492. /* copy final _leaf_ values to output set */
  493. memcpy(o, c, osize*sizeof(*o));
  494. /* swap t and w arrays */
  495. tmp = o;
  496. o = w;
  497. w = tmp;
  498. wsize = osize;
  499. break;
  500. case CRUSH_RULE_EMIT:
  501. for (i = 0; i < wsize && result_len < result_max; i++) {
  502. result[result_len] = w[i];
  503. result_len++;
  504. }
  505. wsize = 0;
  506. break;
  507. default:
  508. dprintk(" unknown op %d at step %d\n",
  509. curstep->op, step);
  510. break;
  511. }
  512. }
  513. return result_len;
  514. }