1TKRZW_DBM_PERF(1) User Commands TKRZW_DBM_PERF(1)
2
6 tkrzw_dbm_perf - manual page for tkrzw_dbm_perf 1.0.24
7
9 tkrzw_dbm_perf: Performance checker of DBM implementations of Tkrzw
10 Usage:
12 tkrzw_dbm_perf sequence [options]
13 : Checks setting/getting/removing performance in sequence.
15 tkrzw_dbm_perf parallel [options]
17 : Checks setting/getting/removing performance in parallel.
19 tkrzw_dbm_perf wicked [options]
21 : Checks consistency with various operations.
23 tkrzw_dbm_perf index [options]
25 : Checks performance of on-memory indexing.
27 Common options:
29 --dbm impl : The name of a DBM implementation: auto, hash, tree, skip,
30 tiny, baby, cache, stdhash, stdtree, poly, shard. (default:
31 auto)
32 --iter num : The number of iterations. (default: 10000)
34 --size num : The size of each record value. (default: 8)
36 --threads num : The number of threads. (default: 1)
38 --random_seed num : The random seed or negative for real RNG. (default:
40 0)
41 --verbose : Prints verbose reports.
43 --path path : The path of the file to write or read.
45 --file impl : The name of a file implementation: std, mmap-para,
47 mmap-atom, pos-para, pos-atom. (default: mmap-para)
48 --no_wait : Fails if the file is locked by another process.
50 --no_lock : Omits file locking.
52 --sync_hard : Synchronizes the file physically when closing.
54 --alloc_init num : The initial allocation size. (default: 1048576)
56 --alloc_inc num : The allocation increment factor. (default: 2.0)
58 --block_size num : The block size of the positional access file. (de‐
60 fault: 1)
61 --direct_io : Enables the direct I/O option of the positional access
63 file.
64 --sync_io : Enables the synchronous I/O option of the positional access
66 file.
67 --padding : Enables padding at the end of the file.
69 --pagecache : Enables the mini page cache in the process.
71 --ulog str : Sets the prefix of update log files.
73 Options for the sequence subcommand:
75 --random_key : Uses random keys rather than sequential ones.
76 --random_value : Uses random length values rather than fixed ones.
78 --set_only : Does only setting.
80 --get_only : Does only getting.
82 --remove_only : Does only removing.
84 --validate : Validates records.
86 --copy str : Copies the database file.
88 Options for the parallel subcommand:
90 --random_key : Uses random keys rather than sequential ones.
91 --random_value : Uses random length values rather than fixed ones.
93 --keys : The number of unique keys.
95 --rebuild : Rebuilds the database occasionally.
97 --sleep num : The duration to sleep between iterations. (default: 0)
99 --validate : Validates records.
101 Options for the wicked subcommand:
103 --iterator : Uses iterators occasionally.
104 --clear : Clears the database occasionally.
106 --rebuild : Rebuilds the database occasionally.
108 --validate : Validates records.
110 Options for the index subcommand:
112 --type expr : The types of the key and value of the index: file, mem,
113 n2n, n2s, s2n, s2s, str, file. (default: file)
114 --random_key : Uses random keys rather than sequential ones.
116 --random_value : Uses random length values rather than fixed ones.
118 Options for HashDBM:
120 --append : Uses the appending mode rather than the in-place mode.
121 --record_crc num : The record CRC mode: -1, 0, 8, 16, 32. (default: 0
123 or -1)
124 --record_comp str : The record compression mode: default, none, zlib,
126 zstd, lz4, lzma. (default: none or default)
127 --offset_width num : The width to represent the offset of records. (de‐
129 fault: 4)
130 --align_pow num : Sets the power to align records. (default: 3)
132 --buckets num : Sets the number of buckets for hashing. (default:
134 1048583)
135 --fbp_cap num : Sets the capacity of the free block pool. (default:
137 2048)
138 --min_read_size num : Sets the minimum reading size to read a record.
140 (default: -1)
141 --cache_buckets : Caches the hash buckets on memory.
143 Options for TreeDBM and FileIndex:
145 --append : Uses the appending mode rather than the in-place mode.
146 --record_crc num : The record CRC mode: -1, 0, 8, 16, 32. (default: 0
148 or -1)
149 --record_comp str : The record compression mode: default, none, zlib,
151 zstd, lz4, lzma. (default: none or default)
152 --offset_width num : The width to represent the offset of records. (de‐
154 fault: 4)
155 --align_pow num : Sets the power to align records. (default: 10)
157 --buckets num : Sets the number of buckets for hashing. (default:
159 131101)
160 --fbp_cap num : Sets the capacity of the free block pool. (default:
162 2048)
163 --min_read_size num : Sets the minimum reading size to read a record.
165 (default: -1)
166 --cache_buckets : Caches the hash buckets on memory.
168 --max_page_size num : Sets the maximum size of a page. (default: 8130)
170 --max_branches num : Sets the maximum number of branches of inner
172 nodes. (default: 256)
173 --max_cached_pages num : Sets the maximum number of cached pages. (de‐
175 fault: 10000)
176 --page_update_write : Writes updated pages immediately.
178 Options for SkipDBM:
180 --offset_width num : The width to represent the offset of records. (de‐
181 fault: 4)
182 --step_unit num : Sets the step unit of the skip list. (default: 4)
184 --max_level num : Sets the maximum level of the skip list. (default:
186 14)
187 --sort_mem_size num : Sets the memory size used for sorting. (default:
189 268435456)
190 --insert_in_order : Inserts records in ascending order of the key.
192 --max_cached_records num : Sets the number of cached records (default:
194 65536)
195 --reducer func : Sets the reducer: none, first, second, last, concat,
197 total. (default: none)
198 Options for TinyDBM and StdHashDBM:
200 --buckets num : Sets the number of buckets for hashing. (default:
201 1048583)
202 Options for CacheDBM:
204 --cap_rec_num num : Sets the maximum number of records. (default:
205 1048576)
206 --cap_memsize num : Sets the total memory size to use.
208 Options for PolyDBM and ShardDBM:
210 --params str : Sets the parameters in "key=value,key=value" format.
211tkrzw_dbm_perf 1.0.24 July 2022 TKRZW_DBM_PERF(1)