1TKRZW_DBM_PERF(1)                User Commands               TKRZW_DBM_PERF(1)
2
3
4

NAME

6       tkrzw_dbm_perf - manual page for tkrzw_dbm_perf 1.0.24
7

DESCRIPTION

9       tkrzw_dbm_perf: Performance checker of DBM implementations of Tkrzw
10
11   Usage:
12              tkrzw_dbm_perf sequence [options]
13
14              : Checks setting/getting/removing performance in sequence.
15
16              tkrzw_dbm_perf parallel [options]
17
18              : Checks setting/getting/removing performance in parallel.
19
20              tkrzw_dbm_perf wicked [options]
21
22              : Checks consistency with various operations.
23
24              tkrzw_dbm_perf index [options]
25
26              : Checks performance of on-memory indexing.
27
28   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
33       --iter num : The number of iterations. (default: 10000)
34
35       --size num : The size of each record value. (default: 8)
36
37       --threads num : The number of threads. (default: 1)
38
39       --random_seed num : The random seed or negative for real RNG. (default:
40              0)
41
42       --verbose : Prints verbose reports.
43
44       --path path : The path of the file to write or read.
45
46       --file impl : The  name  of  a  file  implementation:  std,  mmap-para,
47              mmap-atom, pos-para, pos-atom. (default: mmap-para)
48
49       --no_wait : Fails if the file is locked by another process.
50
51       --no_lock : Omits file locking.
52
53       --sync_hard : Synchronizes the file physically when closing.
54
55       --alloc_init num : The initial allocation size. (default: 1048576)
56
57       --alloc_inc num : The allocation increment factor. (default: 2.0)
58
59       --block_size  num  : The block size of the positional access file. (de‐
60              fault: 1)
61
62       --direct_io : Enables the direct I/O option of  the  positional  access
63              file.
64
65       --sync_io : Enables the synchronous I/O option of the positional access
66              file.
67
68       --padding : Enables padding at the end of the file.
69
70       --pagecache : Enables the mini page cache in the process.
71
72       --ulog str : Sets the prefix of update log files.
73
74   Options for the sequence subcommand:
75       --random_key : Uses random keys rather than sequential ones.
76
77       --random_value : Uses random length values rather than fixed ones.
78
79       --set_only : Does only setting.
80
81       --get_only : Does only getting.
82
83       --remove_only : Does only removing.
84
85       --validate : Validates records.
86
87       --copy str : Copies the database file.
88
89   Options for the parallel subcommand:
90       --random_key : Uses random keys rather than sequential ones.
91
92       --random_value : Uses random length values rather than fixed ones.
93
94       --keys : The number of unique keys.
95
96       --rebuild : Rebuilds the database occasionally.
97
98       --sleep num : The duration to sleep between iterations. (default: 0)
99
100       --validate : Validates records.
101
102   Options for the wicked subcommand:
103       --iterator : Uses iterators occasionally.
104
105       --clear : Clears the database occasionally.
106
107       --rebuild : Rebuilds the database occasionally.
108
109       --validate : Validates records.
110
111   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
115       --random_key : Uses random keys rather than sequential ones.
116
117       --random_value : Uses random length values rather than fixed ones.
118
119   Options for HashDBM:
120       --append : Uses the appending mode rather than the in-place mode.
121
122       --record_crc  num  : The record CRC mode: -1, 0, 8, 16, 32. (default: 0
123              or -1)
124
125       --record_comp str : The record compression mode: default,  none,  zlib,
126              zstd, lz4, lzma. (default: none or default)
127
128       --offset_width num : The width to represent the offset of records. (de‐
129              fault: 4)
130
131       --align_pow num : Sets the power to align records. (default: 3)
132
133       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
134              1048583)
135
136       --fbp_cap  num  :  Sets  the capacity of the free block pool. (default:
137              2048)
138
139       --min_read_size num : Sets the minimum reading size to read  a  record.
140              (default: -1)
141
142       --cache_buckets : Caches the hash buckets on memory.
143
144   Options for TreeDBM and FileIndex:
145       --append : Uses the appending mode rather than the in-place mode.
146
147       --record_crc  num  : The record CRC mode: -1, 0, 8, 16, 32. (default: 0
148              or -1)
149
150       --record_comp str : The record compression mode: default,  none,  zlib,
151              zstd, lz4, lzma. (default: none or default)
152
153       --offset_width num : The width to represent the offset of records. (de‐
154              fault: 4)
155
156       --align_pow num : Sets the power to align records. (default: 10)
157
158       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
159              131101)
160
161       --fbp_cap  num  :  Sets  the capacity of the free block pool. (default:
162              2048)
163
164       --min_read_size num : Sets the minimum reading size to read  a  record.
165              (default: -1)
166
167       --cache_buckets : Caches the hash buckets on memory.
168
169       --max_page_size num : Sets the maximum size of a page. (default: 8130)
170
171       --max_branches  num  :  Sets  the  maximum  number of branches of inner
172              nodes. (default: 256)
173
174       --max_cached_pages num : Sets the maximum number of cached pages.  (de‐
175              fault: 10000)
176
177       --page_update_write : Writes updated pages immediately.
178
179   Options for SkipDBM:
180       --offset_width num : The width to represent the offset of records. (de‐
181              fault: 4)
182
183       --step_unit num : Sets the step unit of the skip list. (default: 4)
184
185       --max_level num : Sets the maximum level of the  skip  list.  (default:
186              14)
187
188       --sort_mem_size  num : Sets the memory size used for sorting. (default:
189              268435456)
190
191       --insert_in_order : Inserts records in ascending order of the key.
192
193       --max_cached_records num : Sets the number of cached records  (default:
194              65536)
195
196       --reducer  func  : Sets the reducer: none, first, second, last, concat,
197              total. (default: none)
198
199   Options for TinyDBM and StdHashDBM:
200       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
201              1048583)
202
203   Options for CacheDBM:
204       --cap_rec_num  num  :  Sets  the  maximum  number of records. (default:
205              1048576)
206
207       --cap_memsize num : Sets the total memory size to use.
208
209   Options for PolyDBM and ShardDBM:
210       --params str : Sets the parameters in "key=value,key=value" format.
211
212
213
214tkrzw_dbm_perf 1.0.24             April 2022                 TKRZW_DBM_PERF(1)