llama-bench.cpp 83 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174
  1. #include <algorithm>
  2. #include <array>
  3. #include <cassert>
  4. #include <chrono>
  5. #include <cinttypes>
  6. #include <clocale>
  7. #include <cmath>
  8. #include <cstdio>
  9. #include <cstdlib>
  10. #include <cstring>
  11. #include <ctime>
  12. #include <iterator>
  13. #include <map>
  14. #include <numeric>
  15. #include <regex>
  16. #include <sstream>
  17. #include <string>
  18. #include <thread>
  19. #include <vector>
  20. #include <unordered_set>
  21. #include "common.h"
  22. #include "ggml.h"
  23. #include "llama.h"
  24. #ifdef _WIN32
  25. # define WIN32_LEAN_AND_MEAN
  26. # ifndef NOMINMAX
  27. # define NOMINMAX
  28. # endif
  29. # include <windows.h>
  30. #endif
  31. // utils
  32. static uint64_t get_time_ns() {
  33. using clock = std::chrono::high_resolution_clock;
  34. return std::chrono::nanoseconds(clock::now().time_since_epoch()).count();
  35. }
  36. static bool tensor_buft_override_equal(const llama_model_tensor_buft_override& a, const llama_model_tensor_buft_override& b) {
  37. if (a.pattern != b.pattern) {
  38. // cString comparison that may be null
  39. if (a.pattern == nullptr || b.pattern == nullptr) {
  40. return false;
  41. }
  42. if (strcmp(a.pattern, b.pattern) != 0) {
  43. return false;
  44. }
  45. }
  46. if (a.buft != b.buft) {
  47. return false;
  48. }
  49. return true;
  50. }
  51. static bool vec_tensor_buft_override_equal(const std::vector<llama_model_tensor_buft_override>& a, const std::vector<llama_model_tensor_buft_override>& b) {
  52. if (a.size() != b.size()) {
  53. return false;
  54. }
  55. for (size_t i = 0; i < a.size(); i++) {
  56. if (!tensor_buft_override_equal(a[i], b[i])) {
  57. return false;
  58. }
  59. }
  60. return true;
  61. }
  62. static bool vec_vec_tensor_buft_override_equal(const std::vector<std::vector<llama_model_tensor_buft_override>>& a, const std::vector<std::vector<llama_model_tensor_buft_override>>& b) {
  63. if (a.size() != b.size()) {
  64. return false;
  65. }
  66. for (size_t i = 0; i < a.size(); i++) {
  67. if (!vec_tensor_buft_override_equal(a[i], b[i])) {
  68. return false;
  69. }
  70. }
  71. return true;
  72. }
  73. template <class T> static std::string join(const std::vector<T> & values, const std::string & delim) {
  74. std::ostringstream str;
  75. for (size_t i = 0; i < values.size(); i++) {
  76. str << values[i];
  77. if (i < values.size() - 1) {
  78. str << delim;
  79. }
  80. }
  81. return str.str();
  82. }
  83. template <typename T, typename F> static std::vector<std::string> transform_to_str(const std::vector<T> & values, F f) {
  84. std::vector<std::string> str_values;
  85. std::transform(values.begin(), values.end(), std::back_inserter(str_values), f);
  86. return str_values;
  87. }
  88. template <typename T> static T avg(const std::vector<T> & v) {
  89. if (v.empty()) {
  90. return 0;
  91. }
  92. T sum = std::accumulate(v.begin(), v.end(), T(0));
  93. return sum / (T) v.size();
  94. }
  95. template <typename T> static T stdev(const std::vector<T> & v) {
  96. if (v.size() <= 1) {
  97. return 0;
  98. }
  99. T mean = avg(v);
  100. T sq_sum = std::inner_product(v.begin(), v.end(), v.begin(), T(0));
  101. T stdev = std::sqrt(sq_sum / (T) (v.size() - 1) - mean * mean * (T) v.size() / (T) (v.size() - 1));
  102. return stdev;
  103. }
  104. static std::string get_cpu_info() {
  105. std::vector<std::string> cpu_list;
  106. for (size_t i = 0; i < ggml_backend_dev_count(); i++) {
  107. auto * dev = ggml_backend_dev_get(i);
  108. auto dev_type = ggml_backend_dev_type(dev);
  109. if (dev_type == GGML_BACKEND_DEVICE_TYPE_CPU || dev_type == GGML_BACKEND_DEVICE_TYPE_ACCEL) {
  110. cpu_list.push_back(ggml_backend_dev_description(dev));
  111. }
  112. }
  113. return join(cpu_list, ", ");
  114. }
  115. static std::string get_gpu_info() {
  116. std::vector<std::string> gpu_list;
  117. for (size_t i = 0; i < ggml_backend_dev_count(); i++) {
  118. auto * dev = ggml_backend_dev_get(i);
  119. auto dev_type = ggml_backend_dev_type(dev);
  120. if (dev_type == GGML_BACKEND_DEVICE_TYPE_GPU || dev_type == GGML_BACKEND_DEVICE_TYPE_IGPU) {
  121. gpu_list.push_back(ggml_backend_dev_description(dev));
  122. }
  123. }
  124. return join(gpu_list, ", ");
  125. }
  126. static std::vector<ggml_backend_dev_t> parse_devices_arg(const std::string & value) {
  127. std::vector<ggml_backend_dev_t> devices;
  128. std::string trimmed = string_strip(value);
  129. if (trimmed.empty()) {
  130. throw std::invalid_argument("no devices specified");
  131. }
  132. if (trimmed == "auto") {
  133. return devices;
  134. }
  135. auto dev_names = string_split<std::string>(trimmed, '/');
  136. if (dev_names.size() == 1 && string_strip(dev_names[0]) == "none") {
  137. devices.push_back(nullptr);
  138. return devices;
  139. }
  140. for (auto & name : dev_names) {
  141. std::string dev_name = string_strip(name);
  142. if (dev_name.empty()) {
  143. throw std::invalid_argument("invalid device specification");
  144. }
  145. auto * dev = ggml_backend_dev_by_name(dev_name.c_str());
  146. if (!dev || ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_CPU) {
  147. throw std::invalid_argument(string_format("invalid device: %s", dev_name.c_str()));
  148. }
  149. devices.push_back(dev);
  150. }
  151. devices.push_back(nullptr);
  152. return devices;
  153. }
  154. static void register_rpc_server_list(const std::string & servers) {
  155. auto rpc_servers = string_split<std::string>(servers, ',');
  156. if (rpc_servers.empty()) {
  157. throw std::invalid_argument("no RPC servers specified");
  158. }
  159. auto * rpc_reg = ggml_backend_reg_by_name("RPC");
  160. if (!rpc_reg) {
  161. throw std::invalid_argument("failed to find RPC backend");
  162. }
  163. using add_rpc_server_fn = ggml_backend_reg_t (*)(const char * endpoint);
  164. auto * ggml_backend_rpc_add_server_fn = (add_rpc_server_fn) ggml_backend_reg_get_proc_address(rpc_reg, "ggml_backend_rpc_add_server");
  165. if (!ggml_backend_rpc_add_server_fn) {
  166. throw std::invalid_argument("failed to find RPC add server function");
  167. }
  168. for (const auto & server : rpc_servers) {
  169. auto reg = ggml_backend_rpc_add_server_fn(server.c_str());
  170. ggml_backend_register(reg);
  171. }
  172. }
  173. static std::string devices_to_string(const std::vector<ggml_backend_dev_t> & devices) {
  174. if (devices.empty()) {
  175. return "auto";
  176. }
  177. if (devices.size() == 1 && devices[0] == nullptr) {
  178. return "none";
  179. }
  180. std::vector<std::string> names;
  181. for (auto * dev : devices) {
  182. if (dev == nullptr) {
  183. break;
  184. }
  185. names.push_back(ggml_backend_dev_name(dev));
  186. }
  187. return join(names, "/");
  188. }
  189. // command line params
  190. enum output_formats { NONE, CSV, JSON, JSONL, MARKDOWN, SQL };
  191. static const char * output_format_str(output_formats format) {
  192. switch (format) {
  193. case NONE:
  194. return "none";
  195. case CSV:
  196. return "csv";
  197. case JSON:
  198. return "json";
  199. case JSONL:
  200. return "jsonl";
  201. case MARKDOWN:
  202. return "md";
  203. case SQL:
  204. return "sql";
  205. default:
  206. GGML_ABORT("invalid output format");
  207. }
  208. }
  209. static bool output_format_from_str(const std::string & s, output_formats & format) {
  210. if (s == "none") {
  211. format = NONE;
  212. } else if (s == "csv") {
  213. format = CSV;
  214. } else if (s == "json") {
  215. format = JSON;
  216. } else if (s == "jsonl") {
  217. format = JSONL;
  218. } else if (s == "md") {
  219. format = MARKDOWN;
  220. } else if (s == "sql") {
  221. format = SQL;
  222. } else {
  223. return false;
  224. }
  225. return true;
  226. }
  227. static const char * split_mode_str(llama_split_mode mode) {
  228. switch (mode) {
  229. case LLAMA_SPLIT_MODE_NONE:
  230. return "none";
  231. case LLAMA_SPLIT_MODE_LAYER:
  232. return "layer";
  233. case LLAMA_SPLIT_MODE_ROW:
  234. return "row";
  235. default:
  236. GGML_ABORT("invalid split mode");
  237. }
  238. }
  239. static std::string pair_str(const std::pair<int, int> & p) {
  240. static char buf[32];
  241. snprintf(buf, sizeof(buf), "%d,%d", p.first, p.second);
  242. return buf;
  243. }
  244. static std::vector<int> parse_int_range(const std::string & s) {
  245. // first[-last[(+|*)step]]
  246. std::regex range_regex(R"(^(\d+)(?:-(\d+)(?:([\+|\*])(\d+))?)?(?:,|$))");
  247. std::smatch match;
  248. std::string::const_iterator search_start(s.cbegin());
  249. std::vector<int> result;
  250. while (std::regex_search(search_start, s.cend(), match, range_regex)) {
  251. int first = std::stoi(match[1]);
  252. int last = match[2].matched ? std::stoi(match[2]) : first;
  253. char op = match[3].matched ? match[3].str()[0] : '+';
  254. int step = match[4].matched ? std::stoi(match[4]) : 1;
  255. for (int i = first; i <= last;) {
  256. result.push_back(i);
  257. int prev_i = i;
  258. if (op == '+') {
  259. i += step;
  260. } else if (op == '*') {
  261. i *= step;
  262. } else {
  263. throw std::invalid_argument("invalid range format");
  264. }
  265. if (i <= prev_i) {
  266. throw std::invalid_argument("invalid range");
  267. }
  268. }
  269. search_start = match.suffix().first;
  270. }
  271. if (search_start != s.cend()) {
  272. throw std::invalid_argument("invalid range format");
  273. }
  274. return result;
  275. }
  276. struct cmd_params {
  277. std::vector<std::string> model;
  278. std::vector<int> n_prompt;
  279. std::vector<int> n_gen;
  280. std::vector<std::pair<int, int>> n_pg;
  281. std::vector<int> n_depth;
  282. std::vector<int> n_batch;
  283. std::vector<int> n_ubatch;
  284. std::vector<ggml_type> type_k;
  285. std::vector<ggml_type> type_v;
  286. std::vector<int> n_threads;
  287. std::vector<std::string> cpu_mask;
  288. std::vector<bool> cpu_strict;
  289. std::vector<int> poll;
  290. std::vector<int> n_gpu_layers;
  291. std::vector<int> n_cpu_moe;
  292. std::vector<llama_split_mode> split_mode;
  293. std::vector<int> main_gpu;
  294. std::vector<bool> no_kv_offload;
  295. std::vector<bool> flash_attn;
  296. std::vector<std::vector<ggml_backend_dev_t>> devices;
  297. std::vector<std::vector<float>> tensor_split;
  298. std::vector<std::vector<llama_model_tensor_buft_override>> tensor_buft_overrides;
  299. std::vector<bool> use_mmap;
  300. std::vector<bool> embeddings;
  301. std::vector<bool> no_op_offload;
  302. ggml_numa_strategy numa;
  303. int reps;
  304. ggml_sched_priority prio;
  305. int delay;
  306. bool verbose;
  307. bool progress;
  308. bool no_warmup;
  309. output_formats output_format;
  310. output_formats output_format_stderr;
  311. };
  312. static const cmd_params cmd_params_defaults = {
  313. /* model */ { "models/7B/ggml-model-q4_0.gguf" },
  314. /* n_prompt */ { 512 },
  315. /* n_gen */ { 128 },
  316. /* n_pg */ {},
  317. /* n_depth */ { 0 },
  318. /* n_batch */ { 2048 },
  319. /* n_ubatch */ { 512 },
  320. /* type_k */ { GGML_TYPE_F16 },
  321. /* type_v */ { GGML_TYPE_F16 },
  322. /* n_threads */ { cpu_get_num_math() },
  323. /* cpu_mask */ { "0x0" },
  324. /* cpu_strict */ { false },
  325. /* poll */ { 50 },
  326. /* n_gpu_layers */ { 99 },
  327. /* n_cpu_moe */ { 0 },
  328. /* split_mode */ { LLAMA_SPLIT_MODE_LAYER },
  329. /* main_gpu */ { 0 },
  330. /* no_kv_offload */ { false },
  331. /* flash_attn */ { false },
  332. /* devices */ { {} },
  333. /* tensor_split */ { std::vector<float>(llama_max_devices(), 0.0f) },
  334. /* tensor_buft_overrides*/ { std::vector<llama_model_tensor_buft_override>{ { nullptr, nullptr } } },
  335. /* use_mmap */ { true },
  336. /* embeddings */ { false },
  337. /* no_op_offload */ { false },
  338. /* numa */ GGML_NUMA_STRATEGY_DISABLED,
  339. /* reps */ 5,
  340. /* prio */ GGML_SCHED_PRIO_NORMAL,
  341. /* delay */ 0,
  342. /* verbose */ false,
  343. /* progress */ false,
  344. /* no_warmup */ false,
  345. /* output_format */ MARKDOWN,
  346. /* output_format_stderr */ NONE,
  347. };
  348. static void print_usage(int /* argc */, char ** argv) {
  349. printf("usage: %s [options]\n", argv[0]);
  350. printf("\n");
  351. printf("options:\n");
  352. printf(" -h, --help\n");
  353. printf(" --numa <distribute|isolate|numactl> numa mode (default: disabled)\n");
  354. printf(" -r, --repetitions <n> number of times to repeat each test (default: %d)\n",
  355. cmd_params_defaults.reps);
  356. printf(" --prio <-1|0|1|2|3> process/thread priority (default: %d)\n",
  357. cmd_params_defaults.prio);
  358. printf(" --delay <0...N> (seconds) delay between each test (default: %d)\n",
  359. cmd_params_defaults.delay);
  360. printf(" -o, --output <csv|json|jsonl|md|sql> output format printed to stdout (default: %s)\n",
  361. output_format_str(cmd_params_defaults.output_format));
  362. printf(" -oe, --output-err <csv|json|jsonl|md|sql> output format printed to stderr (default: %s)\n",
  363. output_format_str(cmd_params_defaults.output_format_stderr));
  364. printf(" --list-devices list available devices and exit\n");
  365. printf(" -v, --verbose verbose output\n");
  366. printf(" --progress print test progress indicators\n");
  367. printf(" --no-warmup skip warmup runs before benchmarking\n");
  368. if (llama_supports_rpc()) {
  369. printf(" -rpc, --rpc <rpc_servers> register RPC devices (comma separated)\n");
  370. }
  371. printf("\n");
  372. printf("test parameters:\n");
  373. printf(" -m, --model <filename> (default: %s)\n", join(cmd_params_defaults.model, ",").c_str());
  374. printf(" -p, --n-prompt <n> (default: %s)\n",
  375. join(cmd_params_defaults.n_prompt, ",").c_str());
  376. printf(" -n, --n-gen <n> (default: %s)\n", join(cmd_params_defaults.n_gen, ",").c_str());
  377. printf(" -pg <pp,tg> (default: %s)\n",
  378. join(transform_to_str(cmd_params_defaults.n_pg, pair_str), ",").c_str());
  379. printf(" -d, --n-depth <n> (default: %s)\n",
  380. join(cmd_params_defaults.n_depth, ",").c_str());
  381. printf(" -b, --batch-size <n> (default: %s)\n",
  382. join(cmd_params_defaults.n_batch, ",").c_str());
  383. printf(" -ub, --ubatch-size <n> (default: %s)\n",
  384. join(cmd_params_defaults.n_ubatch, ",").c_str());
  385. printf(" -ctk, --cache-type-k <t> (default: %s)\n",
  386. join(transform_to_str(cmd_params_defaults.type_k, ggml_type_name), ",").c_str());
  387. printf(" -ctv, --cache-type-v <t> (default: %s)\n",
  388. join(transform_to_str(cmd_params_defaults.type_v, ggml_type_name), ",").c_str());
  389. printf(" -t, --threads <n> (default: %s)\n",
  390. join(cmd_params_defaults.n_threads, ",").c_str());
  391. printf(" -C, --cpu-mask <hex,hex> (default: %s)\n",
  392. join(cmd_params_defaults.cpu_mask, ",").c_str());
  393. printf(" --cpu-strict <0|1> (default: %s)\n",
  394. join(cmd_params_defaults.cpu_strict, ",").c_str());
  395. printf(" --poll <0...100> (default: %s)\n", join(cmd_params_defaults.poll, ",").c_str());
  396. printf(" -ngl, --n-gpu-layers <n> (default: %s)\n",
  397. join(cmd_params_defaults.n_gpu_layers, ",").c_str());
  398. printf(" -ncmoe, --n-cpu-moe <n> (default: %s)\n",
  399. join(cmd_params_defaults.n_cpu_moe, ",").c_str());
  400. printf(" -sm, --split-mode <none|layer|row> (default: %s)\n",
  401. join(transform_to_str(cmd_params_defaults.split_mode, split_mode_str), ",").c_str());
  402. printf(" -mg, --main-gpu <i> (default: %s)\n",
  403. join(cmd_params_defaults.main_gpu, ",").c_str());
  404. printf(" -nkvo, --no-kv-offload <0|1> (default: %s)\n",
  405. join(cmd_params_defaults.no_kv_offload, ",").c_str());
  406. printf(" -fa, --flash-attn <0|1> (default: %s)\n",
  407. join(cmd_params_defaults.flash_attn, ",").c_str());
  408. printf(" -dev, --device <dev0/dev1/...> (default: auto)\n");
  409. printf(" -mmp, --mmap <0|1> (default: %s)\n",
  410. join(cmd_params_defaults.use_mmap, ",").c_str());
  411. printf(" -embd, --embeddings <0|1> (default: %s)\n",
  412. join(cmd_params_defaults.embeddings, ",").c_str());
  413. printf(" -ts, --tensor-split <ts0/ts1/..> (default: 0)\n");
  414. printf(" -ot --override-tensor <tensor name pattern>=<buffer type>;...\n");
  415. printf(" (default: disabled)\n");
  416. printf(" -nopo, --no-op-offload <0|1> (default: 0)\n");
  417. printf("\n");
  418. printf(
  419. "Multiple values can be given for each parameter by separating them with ','\n"
  420. "or by specifying the parameter multiple times. Ranges can be given as\n"
  421. "'first-last' or 'first-last+step' or 'first-last*mult'.\n");
  422. }
  423. static ggml_type ggml_type_from_name(const std::string & s) {
  424. if (s == "f16") {
  425. return GGML_TYPE_F16;
  426. }
  427. if (s == "bf16") {
  428. return GGML_TYPE_BF16;
  429. }
  430. if (s == "q8_0") {
  431. return GGML_TYPE_Q8_0;
  432. }
  433. if (s == "q4_0") {
  434. return GGML_TYPE_Q4_0;
  435. }
  436. if (s == "q4_1") {
  437. return GGML_TYPE_Q4_1;
  438. }
  439. if (s == "q5_0") {
  440. return GGML_TYPE_Q5_0;
  441. }
  442. if (s == "q5_1") {
  443. return GGML_TYPE_Q5_1;
  444. }
  445. if (s == "iq4_nl") {
  446. return GGML_TYPE_IQ4_NL;
  447. }
  448. return GGML_TYPE_COUNT;
  449. }
  450. static cmd_params parse_cmd_params(int argc, char ** argv) {
  451. cmd_params params;
  452. std::string arg;
  453. bool invalid_param = false;
  454. const std::string arg_prefix = "--";
  455. const char split_delim = ',';
  456. params.verbose = cmd_params_defaults.verbose;
  457. params.output_format = cmd_params_defaults.output_format;
  458. params.output_format_stderr = cmd_params_defaults.output_format_stderr;
  459. params.reps = cmd_params_defaults.reps;
  460. params.numa = cmd_params_defaults.numa;
  461. params.prio = cmd_params_defaults.prio;
  462. params.delay = cmd_params_defaults.delay;
  463. params.progress = cmd_params_defaults.progress;
  464. params.no_warmup = cmd_params_defaults.no_warmup;
  465. for (int i = 1; i < argc; i++) {
  466. arg = argv[i];
  467. if (arg.compare(0, arg_prefix.size(), arg_prefix) == 0) {
  468. std::replace(arg.begin(), arg.end(), '_', '-');
  469. }
  470. try {
  471. if (arg == "-h" || arg == "--help") {
  472. print_usage(argc, argv);
  473. exit(0);
  474. } else if (arg == "-m" || arg == "--model") {
  475. if (++i >= argc) {
  476. invalid_param = true;
  477. break;
  478. }
  479. auto p = string_split<std::string>(argv[i], split_delim);
  480. params.model.insert(params.model.end(), p.begin(), p.end());
  481. } else if (arg == "-p" || arg == "--n-prompt") {
  482. if (++i >= argc) {
  483. invalid_param = true;
  484. break;
  485. }
  486. auto p = parse_int_range(argv[i]);
  487. params.n_prompt.insert(params.n_prompt.end(), p.begin(), p.end());
  488. } else if (arg == "-n" || arg == "--n-gen") {
  489. if (++i >= argc) {
  490. invalid_param = true;
  491. break;
  492. }
  493. auto p = parse_int_range(argv[i]);
  494. params.n_gen.insert(params.n_gen.end(), p.begin(), p.end());
  495. } else if (arg == "-pg") {
  496. if (++i >= argc) {
  497. invalid_param = true;
  498. break;
  499. }
  500. auto p = string_split<std::string>(argv[i], ',');
  501. if (p.size() != 2) {
  502. invalid_param = true;
  503. break;
  504. }
  505. params.n_pg.push_back({ std::stoi(p[0]), std::stoi(p[1]) });
  506. } else if (arg == "-d" || arg == "--n-depth") {
  507. if (++i >= argc) {
  508. invalid_param = true;
  509. break;
  510. }
  511. auto p = parse_int_range(argv[i]);
  512. params.n_depth.insert(params.n_depth.end(), p.begin(), p.end());
  513. } else if (arg == "-b" || arg == "--batch-size") {
  514. if (++i >= argc) {
  515. invalid_param = true;
  516. break;
  517. }
  518. auto p = parse_int_range(argv[i]);
  519. params.n_batch.insert(params.n_batch.end(), p.begin(), p.end());
  520. } else if (arg == "-ub" || arg == "--ubatch-size") {
  521. if (++i >= argc) {
  522. invalid_param = true;
  523. break;
  524. }
  525. auto p = parse_int_range(argv[i]);
  526. params.n_ubatch.insert(params.n_ubatch.end(), p.begin(), p.end());
  527. } else if (arg == "-ctk" || arg == "--cache-type-k") {
  528. if (++i >= argc) {
  529. invalid_param = true;
  530. break;
  531. }
  532. auto p = string_split<std::string>(argv[i], split_delim);
  533. std::vector<ggml_type> types;
  534. for (const auto & t : p) {
  535. ggml_type gt = ggml_type_from_name(t);
  536. if (gt == GGML_TYPE_COUNT) {
  537. invalid_param = true;
  538. break;
  539. }
  540. types.push_back(gt);
  541. }
  542. if (invalid_param) {
  543. break;
  544. }
  545. params.type_k.insert(params.type_k.end(), types.begin(), types.end());
  546. } else if (arg == "-ctv" || arg == "--cache-type-v") {
  547. if (++i >= argc) {
  548. invalid_param = true;
  549. break;
  550. }
  551. auto p = string_split<std::string>(argv[i], split_delim);
  552. std::vector<ggml_type> types;
  553. for (const auto & t : p) {
  554. ggml_type gt = ggml_type_from_name(t);
  555. if (gt == GGML_TYPE_COUNT) {
  556. invalid_param = true;
  557. break;
  558. }
  559. types.push_back(gt);
  560. }
  561. if (invalid_param) {
  562. break;
  563. }
  564. params.type_v.insert(params.type_v.end(), types.begin(), types.end());
  565. } else if (arg == "-dev" || arg == "--device") {
  566. if (++i >= argc) {
  567. invalid_param = true;
  568. break;
  569. }
  570. auto combos = string_split<std::string>(argv[i], split_delim);
  571. for (const auto & combo : combos) {
  572. try {
  573. params.devices.push_back(parse_devices_arg(combo));
  574. } catch (const std::exception & e) {
  575. fprintf(stderr, "error: %s\n", e.what());
  576. invalid_param = true;
  577. break;
  578. }
  579. }
  580. if (invalid_param) {
  581. break;
  582. }
  583. } else if (arg == "--list-devices") {
  584. std::vector<ggml_backend_dev_t> devices;
  585. for (size_t i = 0; i < ggml_backend_dev_count(); ++i) {
  586. auto * dev = ggml_backend_dev_get(i);
  587. if (ggml_backend_dev_type(dev) != GGML_BACKEND_DEVICE_TYPE_CPU) {
  588. devices.push_back(dev);
  589. }
  590. }
  591. printf("Available devices:\n");
  592. if (devices.empty()) {
  593. printf(" (none)\n");
  594. }
  595. for (auto * dev : devices) {
  596. size_t free, total;
  597. ggml_backend_dev_memory(dev, &free, &total);
  598. printf(" %s: %s (%zu MiB, %zu MiB free)\n", ggml_backend_dev_name(dev), ggml_backend_dev_description(dev), total / 1024 / 1024, free / 1024 / 1024);
  599. }
  600. exit(0);
  601. } else if (arg == "-t" || arg == "--threads") {
  602. if (++i >= argc) {
  603. invalid_param = true;
  604. break;
  605. }
  606. auto p = parse_int_range(argv[i]);
  607. params.n_threads.insert(params.n_threads.end(), p.begin(), p.end());
  608. } else if (arg == "-C" || arg == "--cpu-mask") {
  609. if (++i >= argc) {
  610. invalid_param = true;
  611. break;
  612. }
  613. auto p = string_split<std::string>(argv[i], split_delim);
  614. params.cpu_mask.insert(params.cpu_mask.end(), p.begin(), p.end());
  615. } else if (arg == "--cpu-strict") {
  616. if (++i >= argc) {
  617. invalid_param = true;
  618. break;
  619. }
  620. auto p = string_split<bool>(argv[i], split_delim);
  621. params.cpu_strict.insert(params.cpu_strict.end(), p.begin(), p.end());
  622. } else if (arg == "--poll") {
  623. if (++i >= argc) {
  624. invalid_param = true;
  625. break;
  626. }
  627. auto p = parse_int_range(argv[i]);
  628. params.poll.insert(params.poll.end(), p.begin(), p.end());
  629. } else if (arg == "-ngl" || arg == "--n-gpu-layers") {
  630. if (++i >= argc) {
  631. invalid_param = true;
  632. break;
  633. }
  634. auto p = parse_int_range(argv[i]);
  635. params.n_gpu_layers.insert(params.n_gpu_layers.end(), p.begin(), p.end());
  636. } else if (arg == "-ncmoe" || arg == "--n-cpu-moe") {
  637. if (++i >= argc) {
  638. invalid_param = true;
  639. break;
  640. }
  641. auto p = parse_int_range(argv[i]);
  642. params.n_cpu_moe.insert(params.n_cpu_moe.end(), p.begin(), p.end());
  643. } else if (llama_supports_rpc() && (arg == "-rpc" || arg == "--rpc")) {
  644. if (++i >= argc) {
  645. invalid_param = true;
  646. break;
  647. }
  648. try {
  649. register_rpc_server_list(argv[i]);
  650. } catch (const std::exception & e) {
  651. fprintf(stderr, "error: %s\n", e.what());
  652. invalid_param = true;
  653. break;
  654. }
  655. } else if (arg == "-sm" || arg == "--split-mode") {
  656. if (++i >= argc) {
  657. invalid_param = true;
  658. break;
  659. }
  660. auto p = string_split<std::string>(argv[i], split_delim);
  661. std::vector<llama_split_mode> modes;
  662. for (const auto & m : p) {
  663. llama_split_mode mode;
  664. if (m == "none") {
  665. mode = LLAMA_SPLIT_MODE_NONE;
  666. } else if (m == "layer") {
  667. mode = LLAMA_SPLIT_MODE_LAYER;
  668. } else if (m == "row") {
  669. mode = LLAMA_SPLIT_MODE_ROW;
  670. } else {
  671. invalid_param = true;
  672. break;
  673. }
  674. modes.push_back(mode);
  675. }
  676. if (invalid_param) {
  677. break;
  678. }
  679. params.split_mode.insert(params.split_mode.end(), modes.begin(), modes.end());
  680. } else if (arg == "-mg" || arg == "--main-gpu") {
  681. if (++i >= argc) {
  682. invalid_param = true;
  683. break;
  684. }
  685. params.main_gpu = parse_int_range(argv[i]);
  686. } else if (arg == "-nkvo" || arg == "--no-kv-offload") {
  687. if (++i >= argc) {
  688. invalid_param = true;
  689. break;
  690. }
  691. auto p = string_split<bool>(argv[i], split_delim);
  692. params.no_kv_offload.insert(params.no_kv_offload.end(), p.begin(), p.end());
  693. } else if (arg == "--numa") {
  694. if (++i >= argc) {
  695. invalid_param = true;
  696. break;
  697. }
  698. std::string value(argv[i]);
  699. if (value == "distribute" || value == "") {
  700. params.numa = GGML_NUMA_STRATEGY_DISTRIBUTE;
  701. } else if (value == "isolate") {
  702. params.numa = GGML_NUMA_STRATEGY_ISOLATE;
  703. } else if (value == "numactl") {
  704. params.numa = GGML_NUMA_STRATEGY_NUMACTL;
  705. } else {
  706. invalid_param = true;
  707. break;
  708. }
  709. } else if (arg == "-fa" || arg == "--flash-attn") {
  710. if (++i >= argc) {
  711. invalid_param = true;
  712. break;
  713. }
  714. auto p = string_split<bool>(argv[i], split_delim);
  715. params.flash_attn.insert(params.flash_attn.end(), p.begin(), p.end());
  716. } else if (arg == "-mmp" || arg == "--mmap") {
  717. if (++i >= argc) {
  718. invalid_param = true;
  719. break;
  720. }
  721. auto p = string_split<bool>(argv[i], split_delim);
  722. params.use_mmap.insert(params.use_mmap.end(), p.begin(), p.end());
  723. } else if (arg == "-embd" || arg == "--embeddings") {
  724. if (++i >= argc) {
  725. invalid_param = true;
  726. break;
  727. }
  728. auto p = string_split<bool>(argv[i], split_delim);
  729. params.embeddings.insert(params.embeddings.end(), p.begin(), p.end());
  730. } else if (arg == "-nopo" || arg == "--no-op-offload") {
  731. if (++i >= argc) {
  732. invalid_param = true;
  733. break;
  734. }
  735. auto p = string_split<bool>(argv[i], split_delim);
  736. params.no_op_offload.insert(params.no_op_offload.end(), p.begin(), p.end());
  737. } else if (arg == "-ts" || arg == "--tensor-split") {
  738. if (++i >= argc) {
  739. invalid_param = true;
  740. break;
  741. }
  742. for (auto ts : string_split<std::string>(argv[i], split_delim)) {
  743. // split string by ; and /
  744. const std::regex regex{ R"([;/]+)" };
  745. std::sregex_token_iterator it{ ts.begin(), ts.end(), regex, -1 };
  746. std::vector<std::string> split_arg{ it, {} };
  747. GGML_ASSERT(split_arg.size() <= llama_max_devices());
  748. std::vector<float> tensor_split(llama_max_devices());
  749. for (size_t i = 0; i < llama_max_devices(); ++i) {
  750. if (i < split_arg.size()) {
  751. tensor_split[i] = std::stof(split_arg[i]);
  752. } else {
  753. tensor_split[i] = 0.0f;
  754. }
  755. }
  756. params.tensor_split.push_back(tensor_split);
  757. }
  758. } else if (arg == "-ot" || arg == "--override-tensor") {
  759. if (++i >= argc) {
  760. invalid_param = true;
  761. break;
  762. }
  763. auto * value = argv[i];
  764. /* static */ std::map<std::string, ggml_backend_buffer_type_t> buft_list;
  765. if (buft_list.empty()) {
  766. // enumerate all the devices and add their buffer types to the list
  767. for (size_t i = 0; i < ggml_backend_dev_count(); ++i) {
  768. auto * dev = ggml_backend_dev_get(i);
  769. auto * buft = ggml_backend_dev_buffer_type(dev);
  770. if (buft) {
  771. buft_list[ggml_backend_buft_name(buft)] = buft;
  772. }
  773. }
  774. }
  775. auto override_group_span_len = std::strcspn(value, ",");
  776. bool last_group = false;
  777. do {
  778. if (override_group_span_len == 0) {
  779. // Adds an empty override-tensors for an empty span
  780. params.tensor_buft_overrides.push_back({{}});
  781. if (value[override_group_span_len] == '\0') {
  782. value = &value[override_group_span_len];
  783. last_group = true;
  784. } else {
  785. value = &value[override_group_span_len + 1];
  786. override_group_span_len = std::strcspn(value, ",");
  787. }
  788. continue;
  789. }
  790. // Stamps null terminators into the argv
  791. // value for this option to avoid the
  792. // memory leak present in the implementation
  793. // over in arg.cpp. Acceptable because we
  794. // only parse these args once in this program.
  795. auto * override_group = value;
  796. if (value[override_group_span_len] == '\0') {
  797. value = &value[override_group_span_len];
  798. last_group = true;
  799. } else {
  800. value[override_group_span_len] = '\0';
  801. value = &value[override_group_span_len + 1];
  802. }
  803. std::vector<llama_model_tensor_buft_override> group_tensor_buft_overrides{};
  804. auto override_span_len = std::strcspn(override_group, ";");
  805. while (override_span_len > 0) {
  806. auto * override = override_group;
  807. if (override_group[override_span_len] != '\0') {
  808. override_group[override_span_len] = '\0';
  809. override_group = &override_group[override_span_len + 1];
  810. } else {
  811. override_group = &override_group[override_span_len];
  812. }
  813. auto tensor_name_span_len = std::strcspn(override, "=");
  814. if (tensor_name_span_len >= override_span_len) {
  815. invalid_param = true;
  816. break;
  817. }
  818. override[tensor_name_span_len] = '\0';
  819. auto * tensor_name = override;
  820. auto * buffer_type = &override[tensor_name_span_len + 1];
  821. if (buft_list.find(buffer_type) == buft_list.end()) {
  822. printf("error: unrecognized buffer type '%s'\n", buffer_type);
  823. printf("Available buffer types:\n");
  824. for (const auto & it : buft_list) {
  825. printf(" %s\n", ggml_backend_buft_name(it.second));
  826. }
  827. invalid_param = true;
  828. break;
  829. }
  830. group_tensor_buft_overrides.push_back({tensor_name, buft_list.at(buffer_type)});
  831. override_span_len = std::strcspn(override_group, ";");
  832. }
  833. if (invalid_param) {
  834. break;
  835. }
  836. group_tensor_buft_overrides.push_back({nullptr,nullptr});
  837. params.tensor_buft_overrides.push_back(group_tensor_buft_overrides);
  838. override_group_span_len = std::strcspn(value, ",");
  839. } while (!last_group);
  840. } else if (arg == "-r" || arg == "--repetitions") {
  841. if (++i >= argc) {
  842. invalid_param = true;
  843. break;
  844. }
  845. params.reps = std::stoi(argv[i]);
  846. } else if (arg == "--prio") {
  847. if (++i >= argc) {
  848. invalid_param = true;
  849. break;
  850. }
  851. params.prio = (enum ggml_sched_priority) std::stoi(argv[i]);
  852. } else if (arg == "--delay") {
  853. if (++i >= argc) {
  854. invalid_param = true;
  855. break;
  856. }
  857. params.delay = std::stoi(argv[i]);
  858. } else if (arg == "-o" || arg == "--output") {
  859. if (++i >= argc) {
  860. invalid_param = true;
  861. break;
  862. }
  863. invalid_param = !output_format_from_str(argv[i], params.output_format);
  864. } else if (arg == "-oe" || arg == "--output-err") {
  865. if (++i >= argc) {
  866. invalid_param = true;
  867. break;
  868. }
  869. invalid_param = !output_format_from_str(argv[i], params.output_format_stderr);
  870. } else if (arg == "-v" || arg == "--verbose") {
  871. params.verbose = true;
  872. } else if (arg == "--progress") {
  873. params.progress = true;
  874. } else if (arg == "--no-warmup") {
  875. params.no_warmup = true;
  876. } else {
  877. invalid_param = true;
  878. break;
  879. }
  880. } catch (const std::exception & e) {
  881. fprintf(stderr, "error: %s\n", e.what());
  882. invalid_param = true;
  883. break;
  884. }
  885. }
  886. if (invalid_param) {
  887. fprintf(stderr, "error: invalid parameter for argument: %s\n", arg.c_str());
  888. print_usage(argc, argv);
  889. exit(1);
  890. }
  891. // set defaults
  892. if (params.model.empty()) {
  893. params.model = cmd_params_defaults.model;
  894. }
  895. if (params.n_prompt.empty()) {
  896. params.n_prompt = cmd_params_defaults.n_prompt;
  897. }
  898. if (params.n_gen.empty()) {
  899. params.n_gen = cmd_params_defaults.n_gen;
  900. }
  901. if (params.n_pg.empty()) {
  902. params.n_pg = cmd_params_defaults.n_pg;
  903. }
  904. if (params.n_depth.empty()) {
  905. params.n_depth = cmd_params_defaults.n_depth;
  906. }
  907. if (params.n_batch.empty()) {
  908. params.n_batch = cmd_params_defaults.n_batch;
  909. }
  910. if (params.n_ubatch.empty()) {
  911. params.n_ubatch = cmd_params_defaults.n_ubatch;
  912. }
  913. if (params.type_k.empty()) {
  914. params.type_k = cmd_params_defaults.type_k;
  915. }
  916. if (params.type_v.empty()) {
  917. params.type_v = cmd_params_defaults.type_v;
  918. }
  919. if (params.n_gpu_layers.empty()) {
  920. params.n_gpu_layers = cmd_params_defaults.n_gpu_layers;
  921. }
  922. if (params.n_cpu_moe.empty()) {
  923. params.n_cpu_moe = cmd_params_defaults.n_cpu_moe;
  924. }
  925. if (params.split_mode.empty()) {
  926. params.split_mode = cmd_params_defaults.split_mode;
  927. }
  928. if (params.main_gpu.empty()) {
  929. params.main_gpu = cmd_params_defaults.main_gpu;
  930. }
  931. if (params.no_kv_offload.empty()) {
  932. params.no_kv_offload = cmd_params_defaults.no_kv_offload;
  933. }
  934. if (params.flash_attn.empty()) {
  935. params.flash_attn = cmd_params_defaults.flash_attn;
  936. }
  937. if (params.devices.empty()) {
  938. params.devices = cmd_params_defaults.devices;
  939. }
  940. if (params.tensor_split.empty()) {
  941. params.tensor_split = cmd_params_defaults.tensor_split;
  942. }
  943. if (params.tensor_buft_overrides.empty()) {
  944. params.tensor_buft_overrides = cmd_params_defaults.tensor_buft_overrides;
  945. }
  946. if (params.use_mmap.empty()) {
  947. params.use_mmap = cmd_params_defaults.use_mmap;
  948. }
  949. if (params.embeddings.empty()) {
  950. params.embeddings = cmd_params_defaults.embeddings;
  951. }
  952. if (params.no_op_offload.empty()) {
  953. params.no_op_offload = cmd_params_defaults.no_op_offload;
  954. }
  955. if (params.n_threads.empty()) {
  956. params.n_threads = cmd_params_defaults.n_threads;
  957. }
  958. if (params.cpu_mask.empty()) {
  959. params.cpu_mask = cmd_params_defaults.cpu_mask;
  960. }
  961. if (params.cpu_strict.empty()) {
  962. params.cpu_strict = cmd_params_defaults.cpu_strict;
  963. }
  964. if (params.poll.empty()) {
  965. params.poll = cmd_params_defaults.poll;
  966. }
  967. return params;
  968. }
  969. struct cmd_params_instance {
  970. std::string model;
  971. int n_prompt;
  972. int n_gen;
  973. int n_depth;
  974. int n_batch;
  975. int n_ubatch;
  976. ggml_type type_k;
  977. ggml_type type_v;
  978. int n_threads;
  979. std::string cpu_mask;
  980. bool cpu_strict;
  981. int poll;
  982. int n_gpu_layers;
  983. int n_cpu_moe;
  984. llama_split_mode split_mode;
  985. int main_gpu;
  986. bool no_kv_offload;
  987. bool flash_attn;
  988. std::vector<ggml_backend_dev_t> devices;
  989. std::vector<float> tensor_split;
  990. std::vector<llama_model_tensor_buft_override> tensor_buft_overrides;
  991. bool use_mmap;
  992. bool embeddings;
  993. bool no_op_offload;
  994. llama_model_params to_llama_mparams() const {
  995. llama_model_params mparams = llama_model_default_params();
  996. mparams.n_gpu_layers = n_gpu_layers;
  997. if (!devices.empty()) {
  998. mparams.devices = const_cast<ggml_backend_dev_t *>(devices.data());
  999. }
  1000. mparams.split_mode = split_mode;
  1001. mparams.main_gpu = main_gpu;
  1002. mparams.tensor_split = tensor_split.data();
  1003. mparams.use_mmap = use_mmap;
  1004. if (n_cpu_moe <= 0) {
  1005. if (tensor_buft_overrides.empty()) {
  1006. mparams.tensor_buft_overrides = nullptr;
  1007. } else {
  1008. GGML_ASSERT(tensor_buft_overrides.back().pattern == nullptr &&
  1009. "Tensor buffer overrides not terminated with empty pattern");
  1010. mparams.tensor_buft_overrides = tensor_buft_overrides.data();
  1011. }
  1012. } else {
  1013. static std::vector<llama_model_tensor_buft_override> merged;
  1014. static std::vector<std::string> patterns;
  1015. merged.clear();
  1016. patterns.clear();
  1017. auto first = tensor_buft_overrides.begin();
  1018. auto last = tensor_buft_overrides.end();
  1019. if (first != last && (last - 1)->pattern == nullptr) {
  1020. --last;
  1021. }
  1022. merged.insert(merged.end(), first, last);
  1023. patterns.reserve((size_t) n_cpu_moe);
  1024. merged.reserve(merged.size() + (size_t) n_cpu_moe + 1);
  1025. for (int i = 0; i < n_cpu_moe; ++i) {
  1026. patterns.push_back(llm_ffn_exps_block_regex(i));
  1027. merged.push_back({ patterns.back().c_str(),
  1028. ggml_backend_cpu_buffer_type() });
  1029. }
  1030. merged.push_back({ nullptr, nullptr });
  1031. mparams.tensor_buft_overrides = merged.data();
  1032. }
  1033. return mparams;
  1034. }
  1035. bool equal_mparams(const cmd_params_instance & other) const {
  1036. return model == other.model && n_gpu_layers == other.n_gpu_layers && n_cpu_moe == other.n_cpu_moe &&
  1037. split_mode == other.split_mode &&
  1038. main_gpu == other.main_gpu && use_mmap == other.use_mmap && tensor_split == other.tensor_split &&
  1039. devices == other.devices &&
  1040. vec_tensor_buft_override_equal(tensor_buft_overrides, other.tensor_buft_overrides);
  1041. }
  1042. llama_context_params to_llama_cparams() const {
  1043. llama_context_params cparams = llama_context_default_params();
  1044. cparams.n_ctx = n_prompt + n_gen + n_depth;
  1045. cparams.n_batch = n_batch;
  1046. cparams.n_ubatch = n_ubatch;
  1047. cparams.type_k = type_k;
  1048. cparams.type_v = type_v;
  1049. cparams.offload_kqv = !no_kv_offload;
  1050. cparams.flash_attn_type = flash_attn ? LLAMA_FLASH_ATTN_TYPE_ENABLED : LLAMA_FLASH_ATTN_TYPE_DISABLED;
  1051. cparams.embeddings = embeddings;
  1052. cparams.op_offload = !no_op_offload;
  1053. cparams.swa_full = false;
  1054. return cparams;
  1055. }
  1056. };
  1057. static std::vector<cmd_params_instance> get_cmd_params_instances(const cmd_params & params) {
  1058. std::vector<cmd_params_instance> instances;
  1059. // this ordering minimizes the number of times that each model needs to be reloaded
  1060. // clang-format off
  1061. for (const auto & m : params.model)
  1062. for (const auto & nl : params.n_gpu_layers)
  1063. for (const auto & ncmoe : params.n_cpu_moe)
  1064. for (const auto & sm : params.split_mode)
  1065. for (const auto & mg : params.main_gpu)
  1066. for (const auto & devs : params.devices)
  1067. for (const auto & ts : params.tensor_split)
  1068. for (const auto & ot : params.tensor_buft_overrides)
  1069. for (const auto & mmp : params.use_mmap)
  1070. for (const auto & embd : params.embeddings)
  1071. for (const auto & nopo : params.no_op_offload)
  1072. for (const auto & nb : params.n_batch)
  1073. for (const auto & nub : params.n_ubatch)
  1074. for (const auto & tk : params.type_k)
  1075. for (const auto & tv : params.type_v)
  1076. for (const auto & nkvo : params.no_kv_offload)
  1077. for (const auto & fa : params.flash_attn)
  1078. for (const auto & nt : params.n_threads)
  1079. for (const auto & cm : params.cpu_mask)
  1080. for (const auto & cs : params.cpu_strict)
  1081. for (const auto & nd : params.n_depth)
  1082. for (const auto & pl : params.poll) {
  1083. for (const auto & n_prompt : params.n_prompt) {
  1084. if (n_prompt == 0) {
  1085. continue;
  1086. }
  1087. cmd_params_instance instance = {
  1088. /* .model = */ m,
  1089. /* .n_prompt = */ n_prompt,
  1090. /* .n_gen = */ 0,
  1091. /* .n_depth = */ nd,
  1092. /* .n_batch = */ nb,
  1093. /* .n_ubatch = */ nub,
  1094. /* .type_k = */ tk,
  1095. /* .type_v = */ tv,
  1096. /* .n_threads = */ nt,
  1097. /* .cpu_mask = */ cm,
  1098. /* .cpu_strict = */ cs,
  1099. /* .poll = */ pl,
  1100. /* .n_gpu_layers = */ nl,
  1101. /* .n_cpu_moe = */ ncmoe,
  1102. /* .split_mode = */ sm,
  1103. /* .main_gpu = */ mg,
  1104. /* .no_kv_offload= */ nkvo,
  1105. /* .flash_attn = */ fa,
  1106. /* .devices = */ devs,
  1107. /* .tensor_split = */ ts,
  1108. /* .tensor_buft_overrides = */ ot,
  1109. /* .use_mmap = */ mmp,
  1110. /* .embeddings = */ embd,
  1111. /* .no_op_offload= */ nopo,
  1112. };
  1113. instances.push_back(instance);
  1114. }
  1115. for (const auto & n_gen : params.n_gen) {
  1116. if (n_gen == 0) {
  1117. continue;
  1118. }
  1119. cmd_params_instance instance = {
  1120. /* .model = */ m,
  1121. /* .n_prompt = */ 0,
  1122. /* .n_gen = */ n_gen,
  1123. /* .n_depth = */ nd,
  1124. /* .n_batch = */ nb,
  1125. /* .n_ubatch = */ nub,
  1126. /* .type_k = */ tk,
  1127. /* .type_v = */ tv,
  1128. /* .n_threads = */ nt,
  1129. /* .cpu_mask = */ cm,
  1130. /* .cpu_strict = */ cs,
  1131. /* .poll = */ pl,
  1132. /* .n_gpu_layers = */ nl,
  1133. /* .n_cpu_moe = */ ncmoe,
  1134. /* .split_mode = */ sm,
  1135. /* .main_gpu = */ mg,
  1136. /* .no_kv_offload= */ nkvo,
  1137. /* .flash_attn = */ fa,
  1138. /* .devices = */ devs,
  1139. /* .tensor_split = */ ts,
  1140. /* .tensor_buft_overrides = */ ot,
  1141. /* .use_mmap = */ mmp,
  1142. /* .embeddings = */ embd,
  1143. /* .no_op_offload= */ nopo,
  1144. };
  1145. instances.push_back(instance);
  1146. }
  1147. for (const auto & n_pg : params.n_pg) {
  1148. if (n_pg.first == 0 && n_pg.second == 0) {
  1149. continue;
  1150. }
  1151. cmd_params_instance instance = {
  1152. /* .model = */ m,
  1153. /* .n_prompt = */ n_pg.first,
  1154. /* .n_gen = */ n_pg.second,
  1155. /* .n_depth = */ nd,
  1156. /* .n_batch = */ nb,
  1157. /* .n_ubatch = */ nub,
  1158. /* .type_k = */ tk,
  1159. /* .type_v = */ tv,
  1160. /* .n_threads = */ nt,
  1161. /* .cpu_mask = */ cm,
  1162. /* .cpu_strict = */ cs,
  1163. /* .poll = */ pl,
  1164. /* .n_gpu_layers = */ nl,
  1165. /* .n_cpu_moe = */ ncmoe,
  1166. /* .split_mode = */ sm,
  1167. /* .main_gpu = */ mg,
  1168. /* .no_kv_offload= */ nkvo,
  1169. /* .flash_attn = */ fa,
  1170. /* .devices = */ devs,
  1171. /* .tensor_split = */ ts,
  1172. /* .tensor_buft_overrides = */ ot,
  1173. /* .use_mmap = */ mmp,
  1174. /* .embeddings = */ embd,
  1175. /* .no_op_offload= */ nopo,
  1176. };
  1177. instances.push_back(instance);
  1178. }
  1179. }
  1180. // clang-format on
  1181. return instances;
  1182. }
  1183. struct test {
  1184. static const std::string build_commit;
  1185. static const int build_number;
  1186. const std::string cpu_info;
  1187. const std::string gpu_info;
  1188. std::string model_filename;
  1189. std::string model_type;
  1190. uint64_t model_size;
  1191. uint64_t model_n_params;
  1192. int n_batch;
  1193. int n_ubatch;
  1194. int n_threads;
  1195. std::string cpu_mask;
  1196. bool cpu_strict;
  1197. int poll;
  1198. ggml_type type_k;
  1199. ggml_type type_v;
  1200. int n_gpu_layers;
  1201. int n_cpu_moe;
  1202. llama_split_mode split_mode;
  1203. int main_gpu;
  1204. bool no_kv_offload;
  1205. bool flash_attn;
  1206. std::vector<ggml_backend_dev_t> devices;
  1207. std::vector<float> tensor_split;
  1208. std::vector<llama_model_tensor_buft_override> tensor_buft_overrides;
  1209. bool use_mmap;
  1210. bool embeddings;
  1211. bool no_op_offload;
  1212. int n_prompt;
  1213. int n_gen;
  1214. int n_depth;
  1215. std::string test_time;
  1216. std::vector<uint64_t> samples_ns;
  1217. test(const cmd_params_instance & inst, const llama_model * lmodel, const llama_context * ctx) :
  1218. cpu_info(get_cpu_info()),
  1219. gpu_info(get_gpu_info()) {
  1220. model_filename = inst.model;
  1221. char buf[128];
  1222. llama_model_desc(lmodel, buf, sizeof(buf));
  1223. model_type = buf;
  1224. model_size = llama_model_size(lmodel);
  1225. model_n_params = llama_model_n_params(lmodel);
  1226. n_batch = inst.n_batch;
  1227. n_ubatch = inst.n_ubatch;
  1228. n_threads = inst.n_threads;
  1229. cpu_mask = inst.cpu_mask;
  1230. cpu_strict = inst.cpu_strict;
  1231. poll = inst.poll;
  1232. type_k = inst.type_k;
  1233. type_v = inst.type_v;
  1234. n_gpu_layers = inst.n_gpu_layers;
  1235. n_cpu_moe = inst.n_cpu_moe;
  1236. split_mode = inst.split_mode;
  1237. main_gpu = inst.main_gpu;
  1238. no_kv_offload = inst.no_kv_offload;
  1239. flash_attn = inst.flash_attn;
  1240. devices = inst.devices;
  1241. tensor_split = inst.tensor_split;
  1242. tensor_buft_overrides = inst.tensor_buft_overrides;
  1243. use_mmap = inst.use_mmap;
  1244. embeddings = inst.embeddings;
  1245. no_op_offload = inst.no_op_offload;
  1246. n_prompt = inst.n_prompt;
  1247. n_gen = inst.n_gen;
  1248. n_depth = inst.n_depth;
  1249. // RFC 3339 date-time format
  1250. time_t t = time(NULL);
  1251. std::strftime(buf, sizeof(buf), "%FT%TZ", gmtime(&t));
  1252. test_time = buf;
  1253. (void) ctx;
  1254. }
  1255. uint64_t avg_ns() const { return ::avg(samples_ns); }
  1256. uint64_t stdev_ns() const { return ::stdev(samples_ns); }
  1257. std::vector<double> get_ts() const {
  1258. int n_tokens = n_prompt + n_gen;
  1259. std::vector<double> ts;
  1260. std::transform(samples_ns.begin(), samples_ns.end(), std::back_inserter(ts),
  1261. [n_tokens](uint64_t t) { return 1e9 * n_tokens / t; });
  1262. return ts;
  1263. }
  1264. double avg_ts() const { return ::avg(get_ts()); }
  1265. double stdev_ts() const { return ::stdev(get_ts()); }
  1266. static std::string get_backend() {
  1267. std::vector<std::string> backends;
  1268. bool rpc_used = false;
  1269. for (size_t i = 0; i < ggml_backend_reg_count(); i++) {
  1270. auto * reg = ggml_backend_reg_get(i);
  1271. std::string name = ggml_backend_reg_name(reg);
  1272. if (string_starts_with(name, "RPC")) {
  1273. if (ggml_backend_reg_dev_count(reg) > 0) {
  1274. rpc_used = true;
  1275. }
  1276. } else {
  1277. if (name != "CPU") {
  1278. backends.push_back(ggml_backend_reg_name(reg));
  1279. }
  1280. }
  1281. }
  1282. if (rpc_used) {
  1283. backends.push_back("RPC");
  1284. }
  1285. return backends.empty() ? "CPU" : join(backends, ",");
  1286. }
  1287. static const std::vector<std::string> & get_fields() {
  1288. static const std::vector<std::string> fields = {
  1289. "build_commit", "build_number", "cpu_info", "gpu_info", "backends",
  1290. "model_filename", "model_type", "model_size", "model_n_params", "n_batch",
  1291. "n_ubatch", "n_threads", "cpu_mask", "cpu_strict", "poll",
  1292. "type_k", "type_v", "n_gpu_layers", "n_cpu_moe", "split_mode",
  1293. "main_gpu", "no_kv_offload", "flash_attn", "devices", "tensor_split",
  1294. "tensor_buft_overrides", "use_mmap", "embeddings", "no_op_offload",
  1295. "n_prompt", "n_gen", "n_depth", "test_time", "avg_ns",
  1296. "stddev_ns", "avg_ts", "stddev_ts"
  1297. };
  1298. return fields;
  1299. }
  1300. enum field_type { STRING, BOOL, INT, FLOAT };
  1301. static field_type get_field_type(const std::string & field) {
  1302. if (field == "build_number" || field == "n_batch" || field == "n_ubatch" || field == "n_threads" ||
  1303. field == "poll" || field == "model_size" || field == "model_n_params" || field == "n_gpu_layers" ||
  1304. field == "main_gpu" || field == "n_prompt" || field == "n_gen" || field == "n_depth" || field == "avg_ns" ||
  1305. field == "stddev_ns" || field == "no_op_offload" || field == "n_cpu_moe") {
  1306. return INT;
  1307. }
  1308. if (field == "f16_kv" || field == "no_kv_offload" || field == "cpu_strict" || field == "flash_attn" ||
  1309. field == "use_mmap" || field == "embeddings") {
  1310. return BOOL;
  1311. }
  1312. if (field == "avg_ts" || field == "stddev_ts") {
  1313. return FLOAT;
  1314. }
  1315. return STRING;
  1316. }
  1317. std::vector<std::string> get_values() const {
  1318. std::string tensor_split_str;
  1319. std::string tensor_buft_overrides_str;
  1320. int max_nonzero = 0;
  1321. for (size_t i = 0; i < llama_max_devices(); i++) {
  1322. if (tensor_split[i] > 0) {
  1323. max_nonzero = i;
  1324. }
  1325. }
  1326. for (int i = 0; i <= max_nonzero; i++) {
  1327. char buf[32];
  1328. snprintf(buf, sizeof(buf), "%.2f", tensor_split[i]);
  1329. tensor_split_str += buf;
  1330. if (i < max_nonzero) {
  1331. tensor_split_str += "/";
  1332. }
  1333. }
  1334. if (tensor_buft_overrides.size() == 1) {
  1335. // Last element of tensor_buft_overrides is always a null pattern
  1336. // so if it is only one element long, it must be a null pattern.
  1337. GGML_ASSERT(tensor_buft_overrides[0].pattern == nullptr);
  1338. tensor_buft_overrides_str += "none";
  1339. } else {
  1340. for (size_t i = 0; i < tensor_buft_overrides.size()-1; i++) {
  1341. // Last element of tensor_buft_overrides is always a null pattern
  1342. if (tensor_buft_overrides[i].pattern == nullptr) {
  1343. tensor_buft_overrides_str += "none";
  1344. } else {
  1345. tensor_buft_overrides_str += tensor_buft_overrides[i].pattern;
  1346. tensor_buft_overrides_str += "=";
  1347. tensor_buft_overrides_str += ggml_backend_buft_name(tensor_buft_overrides[i].buft);
  1348. }
  1349. if (i + 2 < tensor_buft_overrides.size()) {
  1350. tensor_buft_overrides_str += ";";
  1351. }
  1352. }
  1353. }
  1354. std::vector<std::string> values = { build_commit,
  1355. std::to_string(build_number),
  1356. cpu_info,
  1357. gpu_info,
  1358. get_backend(),
  1359. model_filename,
  1360. model_type,
  1361. std::to_string(model_size),
  1362. std::to_string(model_n_params),
  1363. std::to_string(n_batch),
  1364. std::to_string(n_ubatch),
  1365. std::to_string(n_threads),
  1366. cpu_mask,
  1367. std::to_string(cpu_strict),
  1368. std::to_string(poll),
  1369. ggml_type_name(type_k),
  1370. ggml_type_name(type_v),
  1371. std::to_string(n_gpu_layers),
  1372. std::to_string(n_cpu_moe),
  1373. split_mode_str(split_mode),
  1374. std::to_string(main_gpu),
  1375. std::to_string(no_kv_offload),
  1376. std::to_string(flash_attn),
  1377. devices_to_string(devices),
  1378. tensor_split_str,
  1379. tensor_buft_overrides_str,
  1380. std::to_string(use_mmap),
  1381. std::to_string(embeddings),
  1382. std::to_string(no_op_offload),
  1383. std::to_string(n_prompt),
  1384. std::to_string(n_gen),
  1385. std::to_string(n_depth),
  1386. test_time,
  1387. std::to_string(avg_ns()),
  1388. std::to_string(stdev_ns()),
  1389. std::to_string(avg_ts()),
  1390. std::to_string(stdev_ts()) };
  1391. return values;
  1392. }
  1393. std::map<std::string, std::string> get_map() const {
  1394. std::map<std::string, std::string> map;
  1395. auto fields = get_fields();
  1396. auto values = get_values();
  1397. std::transform(fields.begin(), fields.end(), values.begin(), std::inserter(map, map.end()),
  1398. std::make_pair<const std::string &, const std::string &>);
  1399. return map;
  1400. }
  1401. };
  1402. const std::string test::build_commit = LLAMA_COMMIT;
  1403. const int test::build_number = LLAMA_BUILD_NUMBER;
  1404. struct printer {
  1405. virtual ~printer() {}
  1406. FILE * fout;
  1407. virtual void print_header(const cmd_params & params) { (void) params; }
  1408. virtual void print_test(const test & t) = 0;
  1409. virtual void print_footer() {}
  1410. };
  1411. struct csv_printer : public printer {
  1412. static std::string escape_csv(const std::string & field) {
  1413. std::string escaped = "\"";
  1414. for (auto c : field) {
  1415. if (c == '"') {
  1416. escaped += "\"";
  1417. }
  1418. escaped += c;
  1419. }
  1420. escaped += "\"";
  1421. return escaped;
  1422. }
  1423. void print_header(const cmd_params & params) override {
  1424. std::vector<std::string> fields = test::get_fields();
  1425. fprintf(fout, "%s\n", join(fields, ",").c_str());
  1426. (void) params;
  1427. }
  1428. void print_test(const test & t) override {
  1429. std::vector<std::string> values = t.get_values();
  1430. std::transform(values.begin(), values.end(), values.begin(), escape_csv);
  1431. fprintf(fout, "%s\n", join(values, ",").c_str());
  1432. }
  1433. };
  1434. static std::string escape_json(const std::string & value) {
  1435. std::string escaped;
  1436. for (auto c : value) {
  1437. if (c == '"') {
  1438. escaped += "\\\"";
  1439. } else if (c == '\\') {
  1440. escaped += "\\\\";
  1441. } else if (c <= 0x1f) {
  1442. char buf[8];
  1443. snprintf(buf, sizeof(buf), "\\u%04x", c);
  1444. escaped += buf;
  1445. } else {
  1446. escaped += c;
  1447. }
  1448. }
  1449. return escaped;
  1450. }
  1451. static std::string format_json_value(const std::string & field, const std::string & value) {
  1452. switch (test::get_field_type(field)) {
  1453. case test::STRING:
  1454. return "\"" + escape_json(value) + "\"";
  1455. case test::BOOL:
  1456. return value == "0" ? "false" : "true";
  1457. default:
  1458. return value;
  1459. }
  1460. }
  1461. struct json_printer : public printer {
  1462. bool first = true;
  1463. void print_header(const cmd_params & params) override {
  1464. fprintf(fout, "[\n");
  1465. (void) params;
  1466. }
  1467. void print_fields(const std::vector<std::string> & fields, const std::vector<std::string> & values) {
  1468. assert(fields.size() == values.size());
  1469. for (size_t i = 0; i < fields.size(); i++) {
  1470. fprintf(fout, " \"%s\": %s,\n", fields.at(i).c_str(),
  1471. format_json_value(fields.at(i), values.at(i)).c_str());
  1472. }
  1473. }
  1474. void print_test(const test & t) override {
  1475. if (first) {
  1476. first = false;
  1477. } else {
  1478. fprintf(fout, ",\n");
  1479. }
  1480. fprintf(fout, " {\n");
  1481. print_fields(test::get_fields(), t.get_values());
  1482. fprintf(fout, " \"samples_ns\": [ %s ],\n", join(t.samples_ns, ", ").c_str());
  1483. fprintf(fout, " \"samples_ts\": [ %s ]\n", join(t.get_ts(), ", ").c_str());
  1484. fprintf(fout, " }");
  1485. fflush(fout);
  1486. }
  1487. void print_footer() override { fprintf(fout, "\n]\n"); }
  1488. };
  1489. struct jsonl_printer : public printer {
  1490. void print_fields(const std::vector<std::string> & fields, const std::vector<std::string> & values) {
  1491. assert(fields.size() == values.size());
  1492. for (size_t i = 0; i < fields.size(); i++) {
  1493. fprintf(fout, "\"%s\": %s, ", fields.at(i).c_str(), format_json_value(fields.at(i), values.at(i)).c_str());
  1494. }
  1495. }
  1496. void print_test(const test & t) override {
  1497. fprintf(fout, "{");
  1498. print_fields(test::get_fields(), t.get_values());
  1499. fprintf(fout, "\"samples_ns\": [ %s ],", join(t.samples_ns, ", ").c_str());
  1500. fprintf(fout, "\"samples_ts\": [ %s ]", join(t.get_ts(), ", ").c_str());
  1501. fprintf(fout, "}\n");
  1502. fflush(fout);
  1503. }
  1504. };
  1505. struct markdown_printer : public printer {
  1506. std::vector<std::string> fields;
  1507. static int get_field_width(const std::string & field) {
  1508. if (field == "model") {
  1509. return -30;
  1510. }
  1511. if (field == "t/s") {
  1512. return 20;
  1513. }
  1514. if (field == "size" || field == "params") {
  1515. return 10;
  1516. }
  1517. if (field == "n_gpu_layers") {
  1518. return 3;
  1519. }
  1520. if (field == "n_threads") {
  1521. return 7;
  1522. }
  1523. if (field == "n_batch") {
  1524. return 7;
  1525. }
  1526. if (field == "n_ubatch") {
  1527. return 8;
  1528. }
  1529. if (field == "type_k" || field == "type_v") {
  1530. return 6;
  1531. }
  1532. if (field == "split_mode") {
  1533. return 5;
  1534. }
  1535. if (field == "flash_attn") {
  1536. return 2;
  1537. }
  1538. if (field == "devices") {
  1539. return -12;
  1540. }
  1541. if (field == "use_mmap") {
  1542. return 4;
  1543. }
  1544. if (field == "test") {
  1545. return 15;
  1546. }
  1547. if (field == "no_op_offload") {
  1548. return 4;
  1549. }
  1550. int width = std::max((int) field.length(), 10);
  1551. if (test::get_field_type(field) == test::STRING) {
  1552. return -width;
  1553. }
  1554. return width;
  1555. }
  1556. static std::string get_field_display_name(const std::string & field) {
  1557. if (field == "n_gpu_layers") {
  1558. return "ngl";
  1559. }
  1560. if (field == "split_mode") {
  1561. return "sm";
  1562. }
  1563. if (field == "n_threads") {
  1564. return "threads";
  1565. }
  1566. if (field == "no_kv_offload") {
  1567. return "nkvo";
  1568. }
  1569. if (field == "flash_attn") {
  1570. return "fa";
  1571. }
  1572. if (field == "use_mmap") {
  1573. return "mmap";
  1574. }
  1575. if (field == "embeddings") {
  1576. return "embd";
  1577. }
  1578. if (field == "no_op_offload") {
  1579. return "nopo";
  1580. }
  1581. if (field == "devices") {
  1582. return "dev";
  1583. }
  1584. if (field == "tensor_split") {
  1585. return "ts";
  1586. }
  1587. if (field == "tensor_buft_overrides") {
  1588. return "ot";
  1589. }
  1590. return field;
  1591. }
  1592. void print_header(const cmd_params & params) override {
  1593. // select fields to print
  1594. fields.emplace_back("model");
  1595. fields.emplace_back("size");
  1596. fields.emplace_back("params");
  1597. fields.emplace_back("backend");
  1598. bool is_cpu_backend = test::get_backend().find("CPU") != std::string::npos ||
  1599. test::get_backend().find("BLAS") != std::string::npos;
  1600. if (!is_cpu_backend) {
  1601. fields.emplace_back("n_gpu_layers");
  1602. }
  1603. if (params.n_cpu_moe.size() > 1) {
  1604. fields.emplace_back("n_cpu_moe");
  1605. }
  1606. if (params.n_threads.size() > 1 || params.n_threads != cmd_params_defaults.n_threads || is_cpu_backend) {
  1607. fields.emplace_back("n_threads");
  1608. }
  1609. if (params.cpu_mask.size() > 1 || params.cpu_mask != cmd_params_defaults.cpu_mask) {
  1610. fields.emplace_back("cpu_mask");
  1611. }
  1612. if (params.cpu_strict.size() > 1 || params.cpu_strict != cmd_params_defaults.cpu_strict) {
  1613. fields.emplace_back("cpu_strict");
  1614. }
  1615. if (params.poll.size() > 1 || params.poll != cmd_params_defaults.poll) {
  1616. fields.emplace_back("poll");
  1617. }
  1618. if (params.n_batch.size() > 1 || params.n_batch != cmd_params_defaults.n_batch) {
  1619. fields.emplace_back("n_batch");
  1620. }
  1621. if (params.n_ubatch.size() > 1 || params.n_ubatch != cmd_params_defaults.n_ubatch) {
  1622. fields.emplace_back("n_ubatch");
  1623. }
  1624. if (params.type_k.size() > 1 || params.type_k != cmd_params_defaults.type_k) {
  1625. fields.emplace_back("type_k");
  1626. }
  1627. if (params.type_v.size() > 1 || params.type_v != cmd_params_defaults.type_v) {
  1628. fields.emplace_back("type_v");
  1629. }
  1630. if (params.main_gpu.size() > 1 || params.main_gpu != cmd_params_defaults.main_gpu) {
  1631. fields.emplace_back("main_gpu");
  1632. }
  1633. if (params.split_mode.size() > 1 || params.split_mode != cmd_params_defaults.split_mode) {
  1634. fields.emplace_back("split_mode");
  1635. }
  1636. if (params.no_kv_offload.size() > 1 || params.no_kv_offload != cmd_params_defaults.no_kv_offload) {
  1637. fields.emplace_back("no_kv_offload");
  1638. }
  1639. if (params.flash_attn.size() > 1 || params.flash_attn != cmd_params_defaults.flash_attn) {
  1640. fields.emplace_back("flash_attn");
  1641. }
  1642. if (params.devices.size() > 1 || params.devices != cmd_params_defaults.devices) {
  1643. fields.emplace_back("devices");
  1644. }
  1645. if (params.tensor_split.size() > 1 || params.tensor_split != cmd_params_defaults.tensor_split) {
  1646. fields.emplace_back("tensor_split");
  1647. }
  1648. if (params.tensor_buft_overrides.size() > 1 || !vec_vec_tensor_buft_override_equal(params.tensor_buft_overrides, cmd_params_defaults.tensor_buft_overrides)) {
  1649. fields.emplace_back("tensor_buft_overrides");
  1650. }
  1651. if (params.use_mmap.size() > 1 || params.use_mmap != cmd_params_defaults.use_mmap) {
  1652. fields.emplace_back("use_mmap");
  1653. }
  1654. if (params.embeddings.size() > 1 || params.embeddings != cmd_params_defaults.embeddings) {
  1655. fields.emplace_back("embeddings");
  1656. }
  1657. if (params.no_op_offload.size() > 1 || params.no_op_offload != cmd_params_defaults.no_op_offload) {
  1658. fields.emplace_back("no_op_offload");
  1659. }
  1660. fields.emplace_back("test");
  1661. fields.emplace_back("t/s");
  1662. fprintf(fout, "|");
  1663. for (const auto & field : fields) {
  1664. fprintf(fout, " %*s |", get_field_width(field), get_field_display_name(field).c_str());
  1665. }
  1666. fprintf(fout, "\n");
  1667. fprintf(fout, "|");
  1668. for (const auto & field : fields) {
  1669. int width = get_field_width(field);
  1670. fprintf(fout, " %s%s |", std::string(std::abs(width) - 1, '-').c_str(), width > 0 ? ":" : "-");
  1671. }
  1672. fprintf(fout, "\n");
  1673. }
  1674. void print_test(const test & t) override {
  1675. std::map<std::string, std::string> vmap = t.get_map();
  1676. fprintf(fout, "|");
  1677. for (const auto & field : fields) {
  1678. std::string value;
  1679. char buf[128];
  1680. if (field == "model") {
  1681. value = t.model_type;
  1682. } else if (field == "size") {
  1683. if (t.model_size < 1024 * 1024 * 1024) {
  1684. snprintf(buf, sizeof(buf), "%.2f MiB", t.model_size / 1024.0 / 1024.0);
  1685. } else {
  1686. snprintf(buf, sizeof(buf), "%.2f GiB", t.model_size / 1024.0 / 1024.0 / 1024.0);
  1687. }
  1688. value = buf;
  1689. } else if (field == "params") {
  1690. if (t.model_n_params < 1000 * 1000 * 1000) {
  1691. snprintf(buf, sizeof(buf), "%.2f M", t.model_n_params / 1e6);
  1692. } else {
  1693. snprintf(buf, sizeof(buf), "%.2f B", t.model_n_params / 1e9);
  1694. }
  1695. value = buf;
  1696. } else if (field == "backend") {
  1697. value = test::get_backend();
  1698. } else if (field == "test") {
  1699. if (t.n_prompt > 0 && t.n_gen == 0) {
  1700. snprintf(buf, sizeof(buf), "pp%d", t.n_prompt);
  1701. } else if (t.n_gen > 0 && t.n_prompt == 0) {
  1702. snprintf(buf, sizeof(buf), "tg%d", t.n_gen);
  1703. } else {
  1704. snprintf(buf, sizeof(buf), "pp%d+tg%d", t.n_prompt, t.n_gen);
  1705. }
  1706. if (t.n_depth > 0) {
  1707. int len = strlen(buf);
  1708. snprintf(buf + len, sizeof(buf) - len, " @ d%d", t.n_depth);
  1709. }
  1710. value = buf;
  1711. } else if (field == "t/s") {
  1712. snprintf(buf, sizeof(buf), "%.2f ± %.2f", t.avg_ts(), t.stdev_ts());
  1713. value = buf;
  1714. } else if (vmap.find(field) != vmap.end()) {
  1715. value = vmap.at(field);
  1716. } else {
  1717. assert(false);
  1718. exit(1);
  1719. }
  1720. int width = get_field_width(field);
  1721. if (field == "t/s") {
  1722. // HACK: the utf-8 character is 2 bytes
  1723. width += 1;
  1724. }
  1725. fprintf(fout, " %*s |", width, value.c_str());
  1726. }
  1727. fprintf(fout, "\n");
  1728. }
  1729. void print_footer() override {
  1730. fprintf(fout, "\nbuild: %s (%d)\n", test::build_commit.c_str(), test::build_number);
  1731. }
  1732. };
  1733. struct sql_printer : public printer {
  1734. static std::string get_sql_field_type(const std::string & field) {
  1735. switch (test::get_field_type(field)) {
  1736. case test::STRING:
  1737. return "TEXT";
  1738. case test::BOOL:
  1739. case test::INT:
  1740. return "INTEGER";
  1741. case test::FLOAT:
  1742. return "REAL";
  1743. default:
  1744. assert(false);
  1745. exit(1);
  1746. }
  1747. }
  1748. void print_header(const cmd_params & params) override {
  1749. std::vector<std::string> fields = test::get_fields();
  1750. fprintf(fout, "CREATE TABLE IF NOT EXISTS llama_bench (\n");
  1751. for (size_t i = 0; i < fields.size(); i++) {
  1752. fprintf(fout, " %s %s%s\n", fields.at(i).c_str(), get_sql_field_type(fields.at(i)).c_str(),
  1753. i < fields.size() - 1 ? "," : "");
  1754. }
  1755. fprintf(fout, ");\n");
  1756. fprintf(fout, "\n");
  1757. (void) params;
  1758. }
  1759. void print_test(const test & t) override {
  1760. fprintf(fout, "INSERT INTO llama_bench (%s) ", join(test::get_fields(), ", ").c_str());
  1761. fprintf(fout, "VALUES (");
  1762. std::vector<std::string> values = t.get_values();
  1763. for (size_t i = 0; i < values.size(); i++) {
  1764. fprintf(fout, "'%s'%s", values.at(i).c_str(), i < values.size() - 1 ? ", " : "");
  1765. }
  1766. fprintf(fout, ");\n");
  1767. }
  1768. };
  1769. static bool test_prompt(llama_context * ctx, int n_prompt, int n_batch, int n_threads) {
  1770. llama_set_n_threads(ctx, n_threads, n_threads);
  1771. const llama_model * model = llama_get_model(ctx);
  1772. const llama_vocab * vocab = llama_model_get_vocab(model);
  1773. const int32_t n_vocab = llama_vocab_n_tokens(vocab);
  1774. std::vector<llama_token> tokens(n_batch);
  1775. int n_processed = 0;
  1776. while (n_processed < n_prompt) {
  1777. int n_tokens = std::min(n_prompt - n_processed, n_batch);
  1778. tokens[0] = n_processed == 0 && llama_vocab_get_add_bos(vocab) ? llama_vocab_bos(vocab) : std::rand() % n_vocab;
  1779. for (int i = 1; i < n_tokens; i++) {
  1780. tokens[i] = std::rand() % n_vocab;
  1781. }
  1782. int res = llama_decode(ctx, llama_batch_get_one(tokens.data(), n_tokens));
  1783. if (res != 0) {
  1784. fprintf(stderr, "%s: failed to decode prompt batch, res = %d\n", __func__, res);
  1785. return false;
  1786. }
  1787. n_processed += n_tokens;
  1788. }
  1789. llama_synchronize(ctx);
  1790. return true;
  1791. }
  1792. static bool test_gen(llama_context * ctx, int n_gen, int n_threads) {
  1793. llama_set_n_threads(ctx, n_threads, n_threads);
  1794. const llama_model * model = llama_get_model(ctx);
  1795. const llama_vocab * vocab = llama_model_get_vocab(model);
  1796. const int32_t n_vocab = llama_vocab_n_tokens(vocab);
  1797. llama_token token = llama_vocab_get_add_bos(vocab) ? llama_vocab_bos(vocab) : std::rand() % n_vocab;
  1798. for (int i = 0; i < n_gen; i++) {
  1799. int res = llama_decode(ctx, llama_batch_get_one(&token, 1));
  1800. if (res != 0) {
  1801. fprintf(stderr, "%s: failed to decode generation batch, res = %d\n", __func__, res);
  1802. return false;
  1803. }
  1804. llama_synchronize(ctx);
  1805. token = std::rand() % n_vocab;
  1806. }
  1807. return true;
  1808. }
  1809. static void llama_null_log_callback(enum ggml_log_level level, const char * text, void * user_data) {
  1810. (void) level;
  1811. (void) text;
  1812. (void) user_data;
  1813. }
  1814. static std::unique_ptr<printer> create_printer(output_formats format) {
  1815. switch (format) {
  1816. case NONE:
  1817. return nullptr;
  1818. case CSV:
  1819. return std::unique_ptr<printer>(new csv_printer());
  1820. case JSON:
  1821. return std::unique_ptr<printer>(new json_printer());
  1822. case JSONL:
  1823. return std::unique_ptr<printer>(new jsonl_printer());
  1824. case MARKDOWN:
  1825. return std::unique_ptr<printer>(new markdown_printer());
  1826. case SQL:
  1827. return std::unique_ptr<printer>(new sql_printer());
  1828. }
  1829. GGML_ABORT("fatal error");
  1830. }
  1831. int main(int argc, char ** argv) {
  1832. // try to set locale for unicode characters in markdown
  1833. setlocale(LC_CTYPE, ".UTF-8");
  1834. #if !defined(NDEBUG)
  1835. fprintf(stderr, "warning: asserts enabled, performance may be affected\n");
  1836. #endif
  1837. #if (defined(_MSC_VER) && defined(_DEBUG)) || (!defined(_MSC_VER) && !defined(__OPTIMIZE__))
  1838. fprintf(stderr, "warning: debug build, performance may be affected\n");
  1839. #endif
  1840. #if defined(__SANITIZE_ADDRESS__) || defined(__SANITIZE_THREAD__)
  1841. fprintf(stderr, "warning: sanitizer enabled, performance may be affected\n");
  1842. #endif
  1843. // initialize backends
  1844. ggml_backend_load_all();
  1845. cmd_params params = parse_cmd_params(argc, argv);
  1846. auto * cpu_dev = ggml_backend_dev_by_type(GGML_BACKEND_DEVICE_TYPE_CPU);
  1847. if (!cpu_dev) {
  1848. fprintf(stderr, "%s: error: CPU backend is not loaded\n", __func__);
  1849. return 1;
  1850. }
  1851. auto * cpu_reg = ggml_backend_dev_backend_reg(cpu_dev);
  1852. auto * ggml_threadpool_new_fn = (decltype(ggml_threadpool_new) *) ggml_backend_reg_get_proc_address(cpu_reg, "ggml_threadpool_new");
  1853. auto * ggml_threadpool_free_fn = (decltype(ggml_threadpool_free) *) ggml_backend_reg_get_proc_address(cpu_reg, "ggml_threadpool_free");
  1854. // initialize llama.cpp
  1855. if (!params.verbose) {
  1856. llama_log_set(llama_null_log_callback, NULL);
  1857. }
  1858. llama_backend_init();
  1859. llama_numa_init(params.numa);
  1860. set_process_priority(params.prio);
  1861. // initialize printer
  1862. std::unique_ptr<printer> p = create_printer(params.output_format);
  1863. std::unique_ptr<printer> p_err = create_printer(params.output_format_stderr);
  1864. if (p) {
  1865. p->fout = stdout;
  1866. p->print_header(params);
  1867. }
  1868. if (p_err) {
  1869. p_err->fout = stderr;
  1870. p_err->print_header(params);
  1871. }
  1872. std::vector<cmd_params_instance> params_instances = get_cmd_params_instances(params);
  1873. llama_model * lmodel = nullptr;
  1874. const cmd_params_instance * prev_inst = nullptr;
  1875. int params_idx = 0;
  1876. auto params_count = params_instances.size();
  1877. for (const auto & inst : params_instances) {
  1878. params_idx++;
  1879. if (params.progress) {
  1880. fprintf(stderr, "llama-bench: benchmark %d/%zu: starting\n", params_idx, params_count);
  1881. }
  1882. // keep the same model between tests when possible
  1883. if (!lmodel || !prev_inst || !inst.equal_mparams(*prev_inst)) {
  1884. if (lmodel) {
  1885. llama_model_free(lmodel);
  1886. }
  1887. lmodel = llama_model_load_from_file(inst.model.c_str(), inst.to_llama_mparams());
  1888. if (lmodel == NULL) {
  1889. fprintf(stderr, "%s: error: failed to load model '%s'\n", __func__, inst.model.c_str());
  1890. return 1;
  1891. }
  1892. prev_inst = &inst;
  1893. }
  1894. llama_context * ctx = llama_init_from_model(lmodel, inst.to_llama_cparams());
  1895. if (ctx == NULL) {
  1896. fprintf(stderr, "%s: error: failed to create context with model '%s'\n", __func__, inst.model.c_str());
  1897. llama_model_free(lmodel);
  1898. return 1;
  1899. }
  1900. test t(inst, lmodel, ctx);
  1901. llama_memory_clear(llama_get_memory(ctx), false);
  1902. // cool off before the test
  1903. if (params.delay) {
  1904. std::this_thread::sleep_for(std::chrono::seconds(params.delay));
  1905. }
  1906. struct ggml_threadpool_params tpp = ggml_threadpool_params_default(t.n_threads);
  1907. if (!parse_cpu_mask(t.cpu_mask, tpp.cpumask)) {
  1908. fprintf(stderr, "%s: failed to parse cpu-mask: %s\n", __func__, t.cpu_mask.c_str());
  1909. exit(1);
  1910. }
  1911. tpp.strict_cpu = t.cpu_strict;
  1912. tpp.poll = t.poll;
  1913. tpp.prio = params.prio;
  1914. struct ggml_threadpool * threadpool = ggml_threadpool_new_fn(&tpp);
  1915. if (!threadpool) {
  1916. fprintf(stderr, "%s: threadpool create failed : n_threads %d\n", __func__, tpp.n_threads);
  1917. exit(1);
  1918. }
  1919. llama_attach_threadpool(ctx, threadpool, NULL);
  1920. // warmup run
  1921. if (!params.no_warmup) {
  1922. if (t.n_prompt > 0) {
  1923. if (params.progress) {
  1924. fprintf(stderr, "llama-bench: benchmark %d/%zu: warmup prompt run\n", params_idx, params_count);
  1925. }
  1926. //test_prompt(ctx, std::min(t.n_batch, std::min(t.n_prompt, 32)), 0, t.n_batch, t.n_threads);
  1927. bool res = test_prompt(ctx, t.n_prompt, t.n_batch, t.n_threads);
  1928. if (!res) {
  1929. fprintf(stderr, "%s: error: failed to run prompt warmup\n", __func__);
  1930. exit(1);
  1931. }
  1932. }
  1933. if (t.n_gen > 0) {
  1934. if (params.progress) {
  1935. fprintf(stderr, "llama-bench: benchmark %d/%zu: warmup generation run\n", params_idx, params_count);
  1936. }
  1937. bool res = test_gen(ctx, 1, t.n_threads);
  1938. if (!res) {
  1939. fprintf(stderr, "%s: error: failed to run gen warmup\n", __func__);
  1940. exit(1);
  1941. }
  1942. }
  1943. }
  1944. for (int i = 0; i < params.reps; i++) {
  1945. llama_memory_clear(llama_get_memory(ctx), false);
  1946. if (t.n_depth > 0) {
  1947. if (params.progress) {
  1948. fprintf(stderr, "llama-bench: benchmark %d/%zu: depth run %d/%d\n", params_idx, params_count,
  1949. i + 1, params.reps);
  1950. }
  1951. bool res = test_prompt(ctx, t.n_depth, t.n_batch, t.n_threads);
  1952. if (!res) {
  1953. fprintf(stderr, "%s: error: failed to run depth\n", __func__);
  1954. exit(1);
  1955. }
  1956. }
  1957. uint64_t t_start = get_time_ns();
  1958. if (t.n_prompt > 0) {
  1959. if (params.progress) {
  1960. fprintf(stderr, "llama-bench: benchmark %d/%zu: prompt run %d/%d\n", params_idx, params_count,
  1961. i + 1, params.reps);
  1962. }
  1963. bool res = test_prompt(ctx, t.n_prompt, t.n_batch, t.n_threads);
  1964. if (!res) {
  1965. fprintf(stderr, "%s: error: failed to run prompt\n", __func__);
  1966. exit(1);
  1967. }
  1968. }
  1969. if (t.n_gen > 0) {
  1970. if (params.progress) {
  1971. fprintf(stderr, "llama-bench: benchmark %d/%zu: generation run %d/%d\n", params_idx, params_count,
  1972. i + 1, params.reps);
  1973. }
  1974. bool res = test_gen(ctx, t.n_gen, t.n_threads);
  1975. if (!res) {
  1976. fprintf(stderr, "%s: error: failed to run gen\n", __func__);
  1977. exit(1);
  1978. }
  1979. }
  1980. uint64_t t_ns = get_time_ns() - t_start;
  1981. t.samples_ns.push_back(t_ns);
  1982. }
  1983. if (p) {
  1984. p->print_test(t);
  1985. fflush(p->fout);
  1986. }
  1987. if (p_err) {
  1988. p_err->print_test(t);
  1989. fflush(p_err->fout);
  1990. }
  1991. llama_perf_context_print(ctx);
  1992. llama_free(ctx);
  1993. ggml_threadpool_free_fn(threadpool);
  1994. }
  1995. llama_model_free(lmodel);
  1996. if (p) {
  1997. p->print_footer();
  1998. }
  1999. if (p_err) {
  2000. p_err->print_footer();
  2001. }
  2002. llama_backend_free();
  2003. return 0;
  2004. }