lib/sorter/govern.c

   1 /*
   2  *      UCW Library -- Universal Sorter: Governing Routines
   3  *
   4  *      (c) 2007 Martin Mares <mj@ucw.cz>
   5  *
   6  *      This software may be freely distributed and used according to the terms
   7  *      of the GNU Lesser General Public License.
   8  */
   9
  10 #include "lib/lib.h"
  11 #include "lib/fastbuf.h"
  12 #include "lib/mempool.h"
  13 #include "lib/stkstring.h"
  14 #include "lib/sorter/common.h"
  15
  16 #include <string.h>
  17 #include <sys/time.h>
  18 #include <time.h>
  19
  20 #define F_BSIZE(b) stk_fsize(sbuck_size(b))
  21
  22 static void
  23 sorter_start_timer(struct sort_context *ctx)
  24 {
  25   init_timer(&ctx->start_time);
  26 }
  27
  28 static void
  29 sorter_stop_timer(struct sort_context *ctx, uns *account_to)
  30 {
  31   ctx->last_pass_time = get_timer(&ctx->start_time);
  32   *account_to += ctx->last_pass_time;
  33 }
  34
  35 static uns
  36 sorter_speed(struct sort_context *ctx, u64 size)
  37 {
  38   if (!size)
  39     return 0;
  40   if (!ctx->last_pass_time)
  41     return -1;
  42   return (uns)((double)size / (1<<20) * 1000 / ctx->last_pass_time);
  43 }
  44
  45 static int
  46 sorter_presort(struct sort_context *ctx, struct sort_bucket *in, struct sort_bucket *out, struct sort_bucket *out_only)
  47 {
  48   sorter_alloc_buf(ctx);
  49   if (in->flags & SBF_CUSTOM_PRESORT)
  50     {
  51       struct fastbuf *f = sbuck_write(out);
  52       out->runs++;
  53       return ctx->custom_presort(f, ctx->big_buf, ctx->big_buf_size);   // FIXME: out_only optimization?
  54     }
  55   return ctx->internal_sort(ctx, in, out, out_only);
  56 }
  57
  58 static inline struct sort_bucket *
  59 sbuck_join_to(struct sort_bucket *b)
  60 {
  61   if (sorter_debug & SORT_DEBUG_NO_JOIN)
  62     return NULL;
  63
  64   struct sort_bucket *out = (struct sort_bucket *) b->n.prev;   // Such bucket is guaranteed to exist
  65   if (!(out->flags & SBF_FINAL))
  66     return NULL;
  67   ASSERT(out->runs == 1);
  68   return out;
  69 }
  70
  71 static void
  72 sorter_join(struct sort_bucket *b)
  73 {
  74   struct sort_bucket *join = (struct sort_bucket *) b->n.prev;
  75   ASSERT(join->flags & SBF_FINAL);
  76   ASSERT(b->runs == 1);
  77
  78   if (!sbuck_has_file(join))
  79     {
  80       // The final bucket doesn't have any file associated yet, so replace
  81       // it with the new bucket.
  82       SORT_XTRACE(2, "Replaced final bucket");
  83       b->flags |= SBF_FINAL;
  84       sbuck_drop(join);
  85     }
  86   else
  87     {
  88       SORT_TRACE("Copying to output file: %s", F_BSIZE(b));
  89       struct fastbuf *src = sbuck_read(b);
  90       struct fastbuf *dest = sbuck_write(join);
  91       bbcopy(src, dest, ~0U);
  92       sbuck_drop(b);
  93     }
  94 }
  95
  96 static void
  97 sorter_twoway(struct sort_context *ctx, struct sort_bucket *b)
  98 {
  99   struct sort_bucket *ins[3] = { NULL }, *outs[3] = { NULL };
 100   cnode *list_pos = b->n.prev;
 101   struct sort_bucket *join = sbuck_join_to(b);
 102
 103   if (!(sorter_debug & SORT_DEBUG_NO_PRESORT) || (b->flags & SBF_CUSTOM_PRESORT))
 104     {
 105       SORT_XTRACE(3, "%s", ((b->flags & SBF_CUSTOM_PRESORT) ? "Custom presorting" : "Presorting"));
 106       sorter_start_timer(ctx);
 107       ins[0] = sbuck_new(ctx);
 108       if (!sorter_presort(ctx, b, ins[0], join ? : ins[0]))
 109         {
 110           sorter_stop_timer(ctx, &ctx->total_pre_time);
 111           SORT_XTRACE(((b->flags & SBF_SOURCE) ? 1 : 2), "Sorted in memory");
 112           if (join)
 113             {
 114               ASSERT(join->runs == 2);
 115               join->runs--;
 116               sbuck_drop(ins[0]);
 117             }
 118           else
 119             clist_insert_after(&ins[0]->n, list_pos);
 120           sbuck_drop(b);
 121           return;
 122         }
 123
 124       ins[1] = sbuck_new(ctx);
 125       int i = 1;
 126       while (sorter_presort(ctx, b, ins[i], ins[i]))
 127         i = 1-i;
 128       sbuck_drop(b);
 129       sorter_stop_timer(ctx, &ctx->total_pre_time);
 130       SORT_TRACE("Presorting pass (%d+%d runs, %s+%s, %dMB/s)",
 131                  ins[0]->runs, ins[1]->runs,
 132                  F_BSIZE(ins[0]), F_BSIZE(ins[1]),
 133                  sorter_speed(ctx, sbuck_size(ins[0]) + sbuck_size(ins[1])));
 134     }
 135   else
 136     {
 137       SORT_XTRACE(2, "Presorting disabled");
 138       ins[0] = b;
 139     }
 140
 141   SORT_XTRACE(3, "Main sorting");
 142   uns pass = 0;
 143   do {
 144     ++pass;
 145     sorter_start_timer(ctx);
 146     if (ins[0]->runs == 1 && ins[1]->runs == 1 && join)
 147       {
 148         // This is guaranteed to produce a single run, so join if possible
 149         sh_off_t join_size = sbuck_size(join);
 150         outs[0] = join;
 151         outs[1] = NULL;
 152         ctx->twoway_merge(ctx, ins, outs);
 153         ASSERT(join->runs == 2);
 154         join->runs--;
 155         join_size = sbuck_size(join) - join_size;
 156         sorter_stop_timer(ctx, &ctx->total_ext_time);
 157         SORT_TRACE("Mergesort pass %d (final run, %s, %dMB/s)", pass, stk_fsize(join_size), sorter_speed(ctx, join_size));
 158         sbuck_drop(ins[0]);
 159         sbuck_drop(ins[1]);
 160         return;
 161       }
 162     outs[0] = sbuck_new(ctx);
 163     outs[1] = sbuck_new(ctx);
 164     outs[2] = NULL;
 165     ctx->twoway_merge(ctx, ins, outs);
 166     sorter_stop_timer(ctx, &ctx->total_ext_time);
 167     SORT_TRACE("Mergesort pass %d (%d+%d runs, %s+%s, %dMB/s)", pass,
 168                outs[0]->runs, outs[1]->runs,
 169                F_BSIZE(outs[0]), F_BSIZE(outs[1]),
 170                sorter_speed(ctx, sbuck_size(outs[0]) + sbuck_size(outs[1])));
 171     sbuck_drop(ins[0]);
 172     sbuck_drop(ins[1]);
 173     memcpy(ins, outs, 3*sizeof(struct sort_bucket *));
 174   } while (sbuck_have(ins[1]));
 175
 176   sbuck_drop(ins[1]);
 177   clist_insert_after(&ins[0]->n, list_pos);
 178 }
 179
 180 static void
 181 sorter_multiway(struct sort_context *ctx, struct sort_bucket *b)
 182 {
 183   clist parts;
 184   cnode *list_pos = b->n.prev;
 185   struct sort_bucket *join = sbuck_join_to(b);
 186   uns trace_level = (b->flags & SBF_SOURCE) ? 1 : 2;
 187
 188   clist_init(&parts);
 189   ASSERT(!(sorter_debug & SORT_DEBUG_NO_PRESORT));
 190   // FIXME: What if the parts will be too small?
 191   SORT_XTRACE(3, "%s", ((b->flags & SBF_CUSTOM_PRESORT) ? "Custom presorting" : "Presorting"));
 192   uns cont;
 193   uns part_cnt = 0;
 194   u64 total_size = 0;
 195   sorter_start_timer(ctx);
 196   do
 197     {
 198       struct sort_bucket *p = sbuck_new(ctx);
 199       cont = sorter_presort(ctx, b, p, (!part_cnt && join) ? join : p);
 200       if (sbuck_have(p))
 201         {
 202           part_cnt++;
 203           clist_add_tail(&parts, &p->n);
 204           total_size += sbuck_size(p);
 205           sbuck_swap_out(p);
 206         }
 207       else
 208         sbuck_drop(p);
 209     }
 210   while (cont);
 211   sorter_stop_timer(ctx, &ctx->total_pre_time);
 212   sbuck_drop(b);
 213
 214   // FIXME: This is way too similar to the two-way case.
 215   if (!part_cnt)
 216     {
 217       if (join)
 218         {
 219           SORT_XTRACE(trace_level, "Sorted in memory and joined");
 220           ASSERT(join->runs == 2);
 221           join->runs--;
 222         }
 223       return;
 224     }
 225   if (part_cnt == 1)
 226     {
 227       struct sort_bucket *p = clist_head(&parts);
 228       SORT_XTRACE(trace_level, "Sorted in memory");
 229       clist_insert_after(&p->n, list_pos);
 230       return;
 231     }
 232
 233   SORT_TRACE("Multi-way presorting pass (%d parts, %s, %dMB/s)", part_cnt, stk_fsize(total_size), sorter_speed(ctx, total_size));
 234
 235   uns max_ways = 64;
 236   struct sort_bucket *ways[max_ways+1];
 237   SORT_XTRACE(2, "Starting up to %d-way merge", max_ways);
 238   for (;;)
 239     {
 240       uns n = 0;
 241       struct sort_bucket *p;
 242       while (n < max_ways && (p = clist_head(&parts)))
 243         {
 244           clist_remove(&p->n);
 245           ways[n++] = p;
 246         }
 247       ways[n] = NULL;
 248       ASSERT(n > 1);
 249
 250       struct sort_bucket *out;
 251       out = sbuck_new(ctx);             // FIXME: No joining so far
 252       sorter_start_timer(ctx);
 253       ctx->multiway_merge(ctx, ways, out);
 254       sorter_stop_timer(ctx, &ctx->total_ext_time);
 255
 256       for (uns i=0; i<n; i++)
 257         sbuck_drop(ways[i]);
 258
 259       if (clist_empty(&parts))
 260         {
 261           clist_insert_after(&out->n, list_pos);
 262           SORT_TRACE("Multi-way merge completed (%s, %dMB/s)", F_BSIZE(out), sorter_speed(ctx, sbuck_size(out)));
 263           return;
 264         }
 265       else
 266         {
 267           sbuck_swap_out(out);
 268           clist_add_tail(&parts, &out->n);
 269           SORT_TRACE("Multi-way merge pass (%d ways, %s, %dMB/s)", n, F_BSIZE(out), sorter_speed(ctx, sbuck_size(out)));
 270         }
 271     }
 272 }
 273
 274 static uns
 275 sorter_radix_bits(struct sort_context *ctx, struct sort_bucket *b)
 276 {
 277   if (!b->hash_bits || b->hash_bits < sorter_min_radix_bits ||
 278       !ctx->radix_split ||
 279       (b->flags & SBF_CUSTOM_PRESORT) ||
 280       (sorter_debug & SORT_DEBUG_NO_RADIX))
 281     return 0;
 282
 283   u64 in = sbuck_size(b);
 284   u64 mem = ctx->internal_estimate(ctx, b) * 0.8;       // FIXME: Magical factor for hash non-uniformity
 285   if (in <= mem)
 286     return 0;
 287
 288   uns n = sorter_min_radix_bits;
 289   while (n < sorter_max_radix_bits && n < b->hash_bits && (in >> n) > mem)
 290     n++;
 291   return n;
 292 }
 293
 294 static void
 295 sorter_radix(struct sort_context *ctx, struct sort_bucket *b, uns bits)
 296 {
 297   uns nbuck = 1 << bits;
 298   SORT_XTRACE(2, "Running radix split on %s with hash %d bits of %d (expecting %s buckets)",
 299               F_BSIZE(b), bits, b->hash_bits, stk_fsize(sbuck_size(b) / nbuck));
 300   sorter_free_buf(ctx);
 301   sorter_start_timer(ctx);
 302
 303   struct sort_bucket **outs = alloca(nbuck * sizeof(struct sort_bucket *));
 304   for (uns i=nbuck; i--; )
 305     {
 306       outs[i] = sbuck_new(ctx);
 307       outs[i]->hash_bits = b->hash_bits - bits;
 308       clist_insert_after(&outs[i]->n, &b->n);
 309     }
 310
 311   ctx->radix_split(ctx, b, outs, b->hash_bits - bits, bits);
 312
 313   u64 min = ~(u64)0, max = 0, sum = 0;
 314   for (uns i=0; i<nbuck; i++)
 315     {
 316       u64 s = sbuck_size(outs[i]);
 317       min = MIN(min, s);
 318       max = MAX(max, s);
 319       sum += s;
 320       if (nbuck > 4)
 321         sbuck_swap_out(outs[i]);
 322     }
 323
 324   sorter_stop_timer(ctx, &ctx->total_ext_time);
 325   SORT_TRACE("Radix split (%d buckets, %s min, %s max, %s avg, %dMB/s)", nbuck,
 326              stk_fsize(min), stk_fsize(max), stk_fsize(sum / nbuck), sorter_speed(ctx, sum));
 327   sbuck_drop(b);
 328 }
 329
 330 void
 331 sorter_run(struct sort_context *ctx)
 332 {
 333   ctx->pool = mp_new(4096);
 334   clist_init(&ctx->bucket_list);
 335   sorter_prepare_buf(ctx);
 336
 337   // Create bucket containing the source
 338   struct sort_bucket *bin = sbuck_new(ctx);
 339   bin->flags = SBF_SOURCE | SBF_OPEN_READ;
 340   if (ctx->custom_presort)
 341     bin->flags |= SBF_CUSTOM_PRESORT;
 342   else
 343     bin->fb = ctx->in_fb;
 344   bin->ident = "in";
 345   bin->size = ctx->in_size;
 346   bin->hash_bits = ctx->hash_bits;
 347   clist_add_tail(&ctx->bucket_list, &bin->n);
 348   SORT_XTRACE(2, "Input size: %s, %d hash bits", F_BSIZE(bin), bin->hash_bits);
 349
 350   // Create bucket for the output
 351   struct sort_bucket *bout = sbuck_new(ctx);
 352   bout->flags = SBF_FINAL;
 353   if (bout->fb = ctx->out_fb)
 354     bout->flags |= SBF_OPEN_WRITE;
 355   bout->ident = "out";
 356   bout->runs = 1;
 357   clist_add_head(&ctx->bucket_list, &bout->n);
 358
 359   struct sort_bucket *b;
 360   uns bits;
 361   while (bout = clist_head(&ctx->bucket_list), b = clist_next(&ctx->bucket_list, &bout->n))
 362     {
 363       SORT_XTRACE(2, "Next block: %s, %d hash bits", F_BSIZE(b), b->hash_bits);
 364       if (!sbuck_have(b))
 365         sbuck_drop(b);
 366       else if (b->runs == 1)
 367         sorter_join(b);
 368       else if (ctx->multiway_merge && !(sorter_debug & (SORT_DEBUG_NO_MULTIWAY | SORT_DEBUG_NO_PRESORT)))       // FIXME: Just kidding...
 369         sorter_multiway(ctx, b);
 370       else if (bits = sorter_radix_bits(ctx, b))
 371         sorter_radix(ctx, b, bits);
 372       else
 373         sorter_twoway(ctx, b);
 374     }
 375
 376   sorter_free_buf(ctx);
 377   sbuck_write(bout);            // Force empty bucket to a file
 378   SORT_XTRACE(2, "Final size: %s", F_BSIZE(bout));
 379   SORT_XTRACE(2, "Final timings: %.3fs external sorting, %.3fs presorting, %.3fs internal sorting",
 380               ctx->total_ext_time/1000., ctx->total_pre_time/1000., ctx->total_int_time/1000.);
 381   ctx->out_fb = sbuck_read(bout);
 382 }