Make tests public. Rewrite most tests. Add tests.
[pintos-anon] / src / lib / kernel / bitmap.h
index 1c66c2a613ee6e7d35b15d0f825d84727f54d72f..a50593c9f291d56a80ac81c5b5362a17eb1d7b00 100644 (file)
@@ -3,45 +3,49 @@
 
 #include <stdbool.h>
 #include <stddef.h>
+#include <inttypes.h>
 
 /* Bitmap abstract data type. */
 
+/* Creation and destruction. */
 struct bitmap *bitmap_create (size_t bit_cnt);
+struct bitmap *bitmap_create_in_buf (size_t bit_cnt, void *, size_t byte_cnt);
+size_t bitmap_buf_size (size_t bit_cnt);
 void bitmap_destroy (struct bitmap *);
 
+/* Bitmap size. */
 size_t bitmap_size (const struct bitmap *);
 
+/* Setting and testing single bits. */
 void bitmap_set (struct bitmap *, size_t idx, bool);
-void bitmap_set_all (struct bitmap *, bool);
-void bitmap_set_multiple (struct bitmap *, size_t start, size_t cnt, bool);
-
 void bitmap_mark (struct bitmap *, size_t idx);
 void bitmap_reset (struct bitmap *, size_t idx);
 void bitmap_flip (struct bitmap *, size_t idx);
-
 bool bitmap_test (const struct bitmap *, size_t idx);
 
-#define BITMAP_ERROR ((size_t) -1)
-size_t bitmap_scan (const struct bitmap *, size_t start, size_t cnt, bool);
-size_t bitmap_scan_and_flip (struct bitmap *, size_t start, size_t cnt,
-                             bool);
-
+/* Setting and testing multiple bits. */
+void bitmap_set_all (struct bitmap *, bool);
+void bitmap_set_multiple (struct bitmap *, size_t start, size_t cnt, bool);
 size_t bitmap_count (const struct bitmap *, size_t start, size_t cnt, bool);
+bool bitmap_contains (const struct bitmap *, size_t start, size_t cnt, bool);
 bool bitmap_any (const struct bitmap *, size_t start, size_t cnt);
 bool bitmap_none (const struct bitmap *, size_t start, size_t cnt);
 bool bitmap_all (const struct bitmap *, size_t start, size_t cnt);
 
+/* Finding set or unset bits. */
+#define BITMAP_ERROR SIZE_MAX
+size_t bitmap_scan (const struct bitmap *, size_t start, size_t cnt, bool);
+size_t bitmap_scan_and_flip (struct bitmap *, size_t start, size_t cnt, bool);
+
+/* File input and output. */
 #ifdef FILESYS
 struct file;
 size_t bitmap_file_size (const struct bitmap *);
-void bitmap_read (struct bitmap *, struct file *);
-void bitmap_write (const struct bitmap *, struct file *);
+bool bitmap_read (struct bitmap *, struct file *);
+bool bitmap_write (const struct bitmap *, struct file *);
 #endif
 
+/* Debugging. */
 void bitmap_dump (const struct bitmap *);
 
-size_t bitmap_needed_bytes (size_t bit_cnt);
-struct bitmap *bitmap_create_preallocated (size_t bit_cnt,
-                                           void *, size_t byte_cnt);
-
 #endif /* lib/kernel/bitmap.h */