ocl.c 35 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021
  1. /*
  2. * Copyright 2011-2012 Con Kolivas
  3. *
  4. * This program is free software; you can redistribute it and/or modify it
  5. * under the terms of the GNU General Public License as published by the Free
  6. * Software Foundation; either version 3 of the License, or (at your option)
  7. * any later version. See COPYING for more details.
  8. */
  9. #include "config.h"
  10. #ifdef HAVE_OPENCL
  11. #include <signal.h>
  12. #include <stdlib.h>
  13. #include <string.h>
  14. #include <stdio.h>
  15. #include <sys/types.h>
  16. #ifdef WIN32
  17. #include <winsock2.h>
  18. #else
  19. #include <sys/socket.h>
  20. #include <netinet/in.h>
  21. #include <netdb.h>
  22. #endif
  23. #include <time.h>
  24. #include <sys/time.h>
  25. #include <pthread.h>
  26. #include <sys/stat.h>
  27. #include <unistd.h>
  28. #define OMIT_OPENCL_API
  29. #include "findnonce.h"
  30. #include "ocl.h"
  31. /* Platform API */
  32. extern
  33. CL_API_ENTRY cl_int CL_API_CALL
  34. (*clGetPlatformIDs)(cl_uint /* num_entries */,
  35. cl_platform_id * /* platforms */,
  36. cl_uint * /* num_platforms */) CL_API_SUFFIX__VERSION_1_0;
  37. extern
  38. CL_API_ENTRY cl_int CL_API_CALL
  39. (*clGetPlatformInfo)(cl_platform_id /* platform */,
  40. cl_platform_info /* param_name */,
  41. size_t /* param_value_size */,
  42. void * /* param_value */,
  43. size_t * /* param_value_size_ret */) CL_API_SUFFIX__VERSION_1_0;
  44. /* Device APIs */
  45. extern
  46. CL_API_ENTRY cl_int CL_API_CALL
  47. (*clGetDeviceIDs)(cl_platform_id /* platform */,
  48. cl_device_type /* device_type */,
  49. cl_uint /* num_entries */,
  50. cl_device_id * /* devices */,
  51. cl_uint * /* num_devices */) CL_API_SUFFIX__VERSION_1_0;
  52. extern
  53. CL_API_ENTRY cl_int CL_API_CALL
  54. (*clGetDeviceInfo)(cl_device_id /* device */,
  55. cl_device_info /* param_name */,
  56. size_t /* param_value_size */,
  57. void * /* param_value */,
  58. size_t * /* param_value_size_ret */) CL_API_SUFFIX__VERSION_1_0;
  59. /* Context APIs */
  60. extern
  61. CL_API_ENTRY cl_context CL_API_CALL
  62. (*clCreateContextFromType)(const cl_context_properties * /* properties */,
  63. cl_device_type /* device_type */,
  64. void (CL_CALLBACK * /* pfn_notify*/ )(const char *, const void *, size_t, void *),
  65. void * /* user_data */,
  66. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  67. extern
  68. CL_API_ENTRY cl_int CL_API_CALL
  69. (*clReleaseContext)(cl_context /* context */) CL_API_SUFFIX__VERSION_1_0;
  70. /* Command Queue APIs */
  71. extern
  72. CL_API_ENTRY cl_command_queue CL_API_CALL
  73. (*clCreateCommandQueue)(cl_context /* context */,
  74. cl_device_id /* device */,
  75. cl_command_queue_properties /* properties */,
  76. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  77. extern
  78. CL_API_ENTRY cl_int CL_API_CALL
  79. (*clReleaseCommandQueue)(cl_command_queue /* command_queue */) CL_API_SUFFIX__VERSION_1_0;
  80. /* Memory Object APIs */
  81. extern
  82. CL_API_ENTRY cl_mem CL_API_CALL
  83. (*clCreateBuffer)(cl_context /* context */,
  84. cl_mem_flags /* flags */,
  85. size_t /* size */,
  86. void * /* host_ptr */,
  87. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  88. /* Program Object APIs */
  89. extern
  90. CL_API_ENTRY cl_program CL_API_CALL
  91. (*clCreateProgramWithSource)(cl_context /* context */,
  92. cl_uint /* count */,
  93. const char ** /* strings */,
  94. const size_t * /* lengths */,
  95. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  96. extern
  97. CL_API_ENTRY cl_program CL_API_CALL
  98. (*clCreateProgramWithBinary)(cl_context /* context */,
  99. cl_uint /* num_devices */,
  100. const cl_device_id * /* device_list */,
  101. const size_t * /* lengths */,
  102. const unsigned char ** /* binaries */,
  103. cl_int * /* binary_status */,
  104. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  105. extern
  106. CL_API_ENTRY cl_int CL_API_CALL
  107. (*clReleaseProgram)(cl_program /* program */) CL_API_SUFFIX__VERSION_1_0;
  108. extern
  109. CL_API_ENTRY cl_int CL_API_CALL
  110. (*clBuildProgram)(cl_program /* program */,
  111. cl_uint /* num_devices */,
  112. const cl_device_id * /* device_list */,
  113. const char * /* options */,
  114. void (CL_CALLBACK * /* pfn_notify */)(cl_program /* program */, void * /* user_data */),
  115. void * /* user_data */) CL_API_SUFFIX__VERSION_1_0;
  116. extern
  117. CL_API_ENTRY cl_int CL_API_CALL
  118. (*clGetProgramInfo)(cl_program /* program */,
  119. cl_program_info /* param_name */,
  120. size_t /* param_value_size */,
  121. void * /* param_value */,
  122. size_t * /* param_value_size_ret */) CL_API_SUFFIX__VERSION_1_0;
  123. extern
  124. CL_API_ENTRY cl_int CL_API_CALL
  125. (*clGetProgramBuildInfo)(cl_program /* program */,
  126. cl_device_id /* device */,
  127. cl_program_build_info /* param_name */,
  128. size_t /* param_value_size */,
  129. void * /* param_value */,
  130. size_t * /* param_value_size_ret */) CL_API_SUFFIX__VERSION_1_0;
  131. /* Kernel Object APIs */
  132. extern
  133. CL_API_ENTRY cl_kernel CL_API_CALL
  134. (*clCreateKernel)(cl_program /* program */,
  135. const char * /* kernel_name */,
  136. cl_int * /* errcode_ret */) CL_API_SUFFIX__VERSION_1_0;
  137. extern
  138. CL_API_ENTRY cl_int CL_API_CALL
  139. (*clReleaseKernel)(cl_kernel /* kernel */) CL_API_SUFFIX__VERSION_1_0;
  140. extern
  141. CL_API_ENTRY cl_int CL_API_CALL
  142. (*clSetKernelArg)(cl_kernel /* kernel */,
  143. cl_uint /* arg_index */,
  144. size_t /* arg_size */,
  145. const void * /* arg_value */) CL_API_SUFFIX__VERSION_1_0;
  146. /* Flush and Finish APIs */
  147. extern
  148. CL_API_ENTRY cl_int CL_API_CALL
  149. (*clFinish)(cl_command_queue /* command_queue */) CL_API_SUFFIX__VERSION_1_0;
  150. /* Enqueued Commands APIs */
  151. extern
  152. CL_API_ENTRY cl_int CL_API_CALL
  153. (*clEnqueueReadBuffer)(cl_command_queue /* command_queue */,
  154. cl_mem /* buffer */,
  155. cl_bool /* blocking_read */,
  156. size_t /* offset */,
  157. size_t /* size */,
  158. void * /* ptr */,
  159. cl_uint /* num_events_in_wait_list */,
  160. const cl_event * /* event_wait_list */,
  161. cl_event * /* event */) CL_API_SUFFIX__VERSION_1_0;
  162. extern
  163. CL_API_ENTRY cl_int CL_API_CALL
  164. (*clEnqueueWriteBuffer)(cl_command_queue /* command_queue */,
  165. cl_mem /* buffer */,
  166. cl_bool /* blocking_write */,
  167. size_t /* offset */,
  168. size_t /* size */,
  169. const void * /* ptr */,
  170. cl_uint /* num_events_in_wait_list */,
  171. const cl_event * /* event_wait_list */,
  172. cl_event * /* event */) CL_API_SUFFIX__VERSION_1_0;
  173. extern
  174. CL_API_ENTRY cl_int CL_API_CALL
  175. (*clEnqueueNDRangeKernel)(cl_command_queue /* command_queue */,
  176. cl_kernel /* kernel */,
  177. cl_uint /* work_dim */,
  178. const size_t * /* global_work_offset */,
  179. const size_t * /* global_work_size */,
  180. const size_t * /* local_work_size */,
  181. cl_uint /* num_events_in_wait_list */,
  182. const cl_event * /* event_wait_list */,
  183. cl_event * /* event */) CL_API_SUFFIX__VERSION_1_0;
  184. int opt_platform_id = -1;
  185. char *file_contents(const char *filename, int *length)
  186. {
  187. char *fullpath = alloca(PATH_MAX);
  188. void *buffer;
  189. FILE *f;
  190. strcpy(fullpath, opt_kernel_path);
  191. strcat(fullpath, filename);
  192. /* Try in the optional kernel path or installed prefix first */
  193. f = fopen(fullpath, "rb");
  194. if (!f) {
  195. /* Then try from the path BFGMiner was called */
  196. strcpy(fullpath, cgminer_path);
  197. strcat(fullpath, filename);
  198. f = fopen(fullpath, "rb");
  199. }
  200. /* Finally try opening it directly */
  201. if (!f)
  202. f = fopen(filename, "rb");
  203. if (!f) {
  204. applog(LOG_ERR, "Unable to open %s or %s for reading", filename, fullpath);
  205. return NULL;
  206. }
  207. fseek(f, 0, SEEK_END);
  208. *length = ftell(f);
  209. fseek(f, 0, SEEK_SET);
  210. buffer = malloc(*length+1);
  211. *length = fread(buffer, 1, *length, f);
  212. fclose(f);
  213. ((char*)buffer)[*length] = '\0';
  214. return (char*)buffer;
  215. }
  216. int clDevicesNum(void) {
  217. cl_int status;
  218. char pbuff[256];
  219. cl_uint numDevices;
  220. cl_uint numPlatforms;
  221. cl_platform_id *platforms;
  222. cl_platform_id platform = NULL;
  223. unsigned int most_devices = 0, i, mdplatform = 0;
  224. status = clGetPlatformIDs(0, NULL, &numPlatforms);
  225. /* If this fails, assume no GPUs. */
  226. if (status != CL_SUCCESS) {
  227. applog(LOG_ERR, "Error %d: clGetPlatformsIDs failed (no OpenCL SDK installed?)", status);
  228. return -1;
  229. }
  230. if (numPlatforms == 0) {
  231. applog(LOG_ERR, "clGetPlatformsIDs returned no platforms (no OpenCL SDK installed?)");
  232. return -1;
  233. }
  234. platforms = (cl_platform_id *)alloca(numPlatforms*sizeof(cl_platform_id));
  235. status = clGetPlatformIDs(numPlatforms, platforms, NULL);
  236. if (status != CL_SUCCESS) {
  237. applog(LOG_ERR, "Error %d: Getting Platform Ids. (clGetPlatformsIDs)", status);
  238. return -1;
  239. }
  240. for (i = 0; i < numPlatforms; i++) {
  241. status = clGetPlatformInfo( platforms[i], CL_PLATFORM_VENDOR, sizeof(pbuff), pbuff, NULL);
  242. if (status != CL_SUCCESS) {
  243. applog(LOG_ERR, "Error %d: Getting Platform Info. (clGetPlatformInfo)", status);
  244. return -1;
  245. }
  246. platform = platforms[i];
  247. applog(LOG_INFO, "CL Platform %d vendor: %s", i, pbuff);
  248. status = clGetPlatformInfo(platform, CL_PLATFORM_NAME, sizeof(pbuff), pbuff, NULL);
  249. if (status == CL_SUCCESS)
  250. applog(LOG_INFO, "CL Platform %d name: %s", i, pbuff);
  251. status = clGetPlatformInfo(platform, CL_PLATFORM_VERSION, sizeof(pbuff), pbuff, NULL);
  252. if (status == CL_SUCCESS)
  253. applog(LOG_INFO, "CL Platform %d version: %s", i, pbuff);
  254. status = clGetDeviceIDs(platform, CL_DEVICE_TYPE_GPU, 0, NULL, &numDevices);
  255. if (status != CL_SUCCESS) {
  256. applog(LOG_ERR, "Error %d: Getting Device IDs (num)", status);
  257. if ((int)i != opt_platform_id)
  258. continue;
  259. return -1;
  260. }
  261. applog(LOG_INFO, "Platform %d devices: %d", i, numDevices);
  262. if (numDevices > most_devices) {
  263. most_devices = numDevices;
  264. mdplatform = i;
  265. }
  266. if (numDevices) {
  267. unsigned int j;
  268. char pbuff[256];
  269. cl_device_id *devices = (cl_device_id *)malloc(numDevices*sizeof(cl_device_id));
  270. clGetDeviceIDs(platform, CL_DEVICE_TYPE_GPU, numDevices, devices, NULL);
  271. for (j = 0; j < numDevices; j++) {
  272. clGetDeviceInfo(devices[j], CL_DEVICE_NAME, sizeof(pbuff), pbuff, NULL);
  273. applog(LOG_INFO, "\t%i\t%s", j, pbuff);
  274. }
  275. free(devices);
  276. }
  277. }
  278. if (opt_platform_id < 0)
  279. opt_platform_id = mdplatform;;
  280. return most_devices;
  281. }
  282. static int advance(char **area, unsigned *remaining, const char *marker)
  283. {
  284. char *find = memmem(*area, *remaining, marker, strlen(marker));
  285. if (!find) {
  286. applog(LOG_DEBUG, "Marker \"%s\" not found", marker);
  287. return 0;
  288. }
  289. *remaining -= find - *area;
  290. *area = find;
  291. return 1;
  292. }
  293. #define OP3_INST_BFE_UINT 4ULL
  294. #define OP3_INST_BFE_INT 5ULL
  295. #define OP3_INST_BFI_INT 6ULL
  296. #define OP3_INST_BIT_ALIGN_INT 12ULL
  297. #define OP3_INST_BYTE_ALIGN_INT 13ULL
  298. void patch_opcodes(char *w, unsigned remaining)
  299. {
  300. uint64_t *opcode = (uint64_t *)w;
  301. int patched = 0;
  302. int count_bfe_int = 0;
  303. int count_bfe_uint = 0;
  304. int count_byte_align = 0;
  305. while (42) {
  306. int clamp = (*opcode >> (32 + 31)) & 0x1;
  307. int dest_rel = (*opcode >> (32 + 28)) & 0x1;
  308. int alu_inst = (*opcode >> (32 + 13)) & 0x1f;
  309. int s2_neg = (*opcode >> (32 + 12)) & 0x1;
  310. int s2_rel = (*opcode >> (32 + 9)) & 0x1;
  311. int pred_sel = (*opcode >> 29) & 0x3;
  312. if (!clamp && !dest_rel && !s2_neg && !s2_rel && !pred_sel) {
  313. if (alu_inst == OP3_INST_BFE_INT) {
  314. count_bfe_int++;
  315. } else if (alu_inst == OP3_INST_BFE_UINT) {
  316. count_bfe_uint++;
  317. } else if (alu_inst == OP3_INST_BYTE_ALIGN_INT) {
  318. count_byte_align++;
  319. // patch this instruction to BFI_INT
  320. *opcode &= 0xfffc1fffffffffffULL;
  321. *opcode |= OP3_INST_BFI_INT << (32 + 13);
  322. patched++;
  323. }
  324. }
  325. if (remaining <= 8)
  326. break;
  327. opcode++;
  328. remaining -= 8;
  329. }
  330. applog(LOG_DEBUG, "Potential OP3 instructions identified: "
  331. "%i BFE_INT, %i BFE_UINT, %i BYTE_ALIGN",
  332. count_bfe_int, count_bfe_uint, count_byte_align);
  333. applog(LOG_DEBUG, "Patched a total of %i BFI_INT instructions", patched);
  334. }
  335. _clState *initCl(unsigned int gpu, char *name, size_t nameSize)
  336. {
  337. _clState *clState = calloc(1, sizeof(_clState));
  338. bool patchbfi = false, prog_built = false;
  339. struct cgpu_info *cgpu = &gpus[gpu];
  340. cl_platform_id platform = NULL;
  341. char pbuff[256], vbuff[255];
  342. cl_platform_id* platforms;
  343. cl_uint preferred_vwidth;
  344. cl_device_id *devices;
  345. cl_uint numPlatforms;
  346. cl_uint numDevices;
  347. cl_int status;
  348. status = clGetPlatformIDs(0, NULL, &numPlatforms);
  349. if (status != CL_SUCCESS) {
  350. applog(LOG_ERR, "Error %d: Getting Platforms. (clGetPlatformsIDs)", status);
  351. return NULL;
  352. }
  353. platforms = (cl_platform_id *)alloca(numPlatforms*sizeof(cl_platform_id));
  354. status = clGetPlatformIDs(numPlatforms, platforms, NULL);
  355. if (status != CL_SUCCESS) {
  356. applog(LOG_ERR, "Error %d: Getting Platform Ids. (clGetPlatformsIDs)", status);
  357. return NULL;
  358. }
  359. if (opt_platform_id >= (int)numPlatforms) {
  360. applog(LOG_ERR, "Specified platform that does not exist");
  361. return NULL;
  362. }
  363. status = clGetPlatformInfo(platforms[opt_platform_id], CL_PLATFORM_VENDOR, sizeof(pbuff), pbuff, NULL);
  364. if (status != CL_SUCCESS) {
  365. applog(LOG_ERR, "Error %d: Getting Platform Info. (clGetPlatformInfo)", status);
  366. return NULL;
  367. }
  368. platform = platforms[opt_platform_id];
  369. if (platform == NULL) {
  370. perror("NULL platform found!\n");
  371. return NULL;
  372. }
  373. applog(LOG_INFO, "CL Platform vendor: %s", pbuff);
  374. status = clGetPlatformInfo(platform, CL_PLATFORM_NAME, sizeof(pbuff), pbuff, NULL);
  375. if (status == CL_SUCCESS)
  376. applog(LOG_INFO, "CL Platform name: %s", pbuff);
  377. status = clGetPlatformInfo(platform, CL_PLATFORM_VERSION, sizeof(vbuff), vbuff, NULL);
  378. if (status == CL_SUCCESS)
  379. applog(LOG_INFO, "CL Platform version: %s", vbuff);
  380. status = clGetDeviceIDs(platform, CL_DEVICE_TYPE_GPU, 0, NULL, &numDevices);
  381. if (status != CL_SUCCESS) {
  382. applog(LOG_ERR, "Error %d: Getting Device IDs (num)", status);
  383. return NULL;
  384. }
  385. if (numDevices > 0 ) {
  386. devices = (cl_device_id *)malloc(numDevices*sizeof(cl_device_id));
  387. /* Now, get the device list data */
  388. status = clGetDeviceIDs(platform, CL_DEVICE_TYPE_GPU, numDevices, devices, NULL);
  389. if (status != CL_SUCCESS) {
  390. applog(LOG_ERR, "Error %d: Getting Device IDs (list)", status);
  391. return NULL;
  392. }
  393. applog(LOG_INFO, "List of devices:");
  394. unsigned int i;
  395. for (i = 0; i < numDevices; i++) {
  396. status = clGetDeviceInfo(devices[i], CL_DEVICE_NAME, sizeof(pbuff), pbuff, NULL);
  397. if (status != CL_SUCCESS) {
  398. applog(LOG_ERR, "Error %d: Getting Device Info", status);
  399. return NULL;
  400. }
  401. applog(LOG_INFO, "\t%i\t%s", i, pbuff);
  402. }
  403. if (gpu < numDevices) {
  404. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_NAME, sizeof(pbuff), pbuff, NULL);
  405. if (status != CL_SUCCESS) {
  406. applog(LOG_ERR, "Error %d: Getting Device Info", status);
  407. return NULL;
  408. }
  409. applog(LOG_INFO, "Selected %i: %s", gpu, pbuff);
  410. strncpy(name, pbuff, nameSize);
  411. } else {
  412. applog(LOG_ERR, "Invalid GPU %i", gpu);
  413. return NULL;
  414. }
  415. } else return NULL;
  416. cl_context_properties cps[3] = { CL_CONTEXT_PLATFORM, (cl_context_properties)platform, 0 };
  417. clState->context = clCreateContextFromType(cps, CL_DEVICE_TYPE_GPU, NULL, NULL, &status);
  418. if (status != CL_SUCCESS) {
  419. applog(LOG_ERR, "Error %d: Creating Context. (clCreateContextFromType)", status);
  420. return NULL;
  421. }
  422. /////////////////////////////////////////////////////////////////
  423. // Create an OpenCL command queue
  424. /////////////////////////////////////////////////////////////////
  425. clState->commandQueue = clCreateCommandQueue(clState->context, devices[gpu],
  426. CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE, &status);
  427. if (status != CL_SUCCESS) /* Try again without OOE enable */
  428. clState->commandQueue = clCreateCommandQueue(clState->context, devices[gpu], 0 , &status);
  429. if (status != CL_SUCCESS) {
  430. applog(LOG_ERR, "Error %d: Creating Command Queue. (clCreateCommandQueue)", status);
  431. return NULL;
  432. }
  433. /* Check for BFI INT support. Hopefully people don't mix devices with
  434. * and without it! */
  435. char * extensions = malloc(1024);
  436. const char * camo = "cl_amd_media_ops";
  437. char *find;
  438. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_EXTENSIONS, 1024, (void *)extensions, NULL);
  439. if (status != CL_SUCCESS) {
  440. applog(LOG_ERR, "Error %d: Failed to clGetDeviceInfo when trying to get CL_DEVICE_EXTENSIONS", status);
  441. return NULL;
  442. }
  443. find = strstr(extensions, camo);
  444. if (find)
  445. clState->hasBitAlign = true;
  446. /* Check for OpenCL >= 1.0 support, needed for global offset parameter usage. */
  447. char * devoclver = malloc(1024);
  448. const char * ocl10 = "OpenCL 1.0";
  449. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_VERSION, 1024, (void *)devoclver, NULL);
  450. if (status != CL_SUCCESS) {
  451. applog(LOG_ERR, "Error %d: Failed to clGetDeviceInfo when trying to get CL_DEVICE_VERSION", status);
  452. return NULL;
  453. }
  454. find = strstr(devoclver, ocl10);
  455. if (!find)
  456. clState->hasOpenCL11plus = true;
  457. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_PREFERRED_VECTOR_WIDTH_INT, sizeof(cl_uint), (void *)&preferred_vwidth, NULL);
  458. if (status != CL_SUCCESS) {
  459. applog(LOG_ERR, "Error %d: Failed to clGetDeviceInfo when trying to get CL_DEVICE_PREFERRED_VECTOR_WIDTH_INT", status);
  460. return NULL;
  461. }
  462. applog(LOG_DEBUG, "Preferred vector width reported %d", preferred_vwidth);
  463. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_MAX_WORK_GROUP_SIZE, sizeof(size_t), (void *)&clState->max_work_size, NULL);
  464. if (status != CL_SUCCESS) {
  465. applog(LOG_ERR, "Error %d: Failed to clGetDeviceInfo when trying to get CL_DEVICE_MAX_WORK_GROUP_SIZE", status);
  466. return NULL;
  467. }
  468. applog(LOG_DEBUG, "Max work group size reported %"PRId64, (int64_t)clState->max_work_size);
  469. status = clGetDeviceInfo(devices[gpu], CL_DEVICE_MAX_MEM_ALLOC_SIZE , sizeof(cl_ulong), (void *)&cgpu->max_alloc, NULL);
  470. if (status != CL_SUCCESS) {
  471. applog(LOG_ERR, "Error %d: Failed to clGetDeviceInfo when trying to get CL_DEVICE_MAX_MEM_ALLOC_SIZE", status);
  472. return NULL;
  473. }
  474. applog(LOG_DEBUG, "Max mem alloc size is %lu", (unsigned long)cgpu->max_alloc);
  475. /* Create binary filename based on parameters passed to opencl
  476. * compiler to ensure we only load a binary that matches what would
  477. * have otherwise created. The filename is:
  478. * name + kernelname +/- g(offset) + v + vectors + w + work_size + l + sizeof(long) + .bin
  479. * For scrypt the filename is:
  480. * name + kernelname + g + lg + lookup_gap + tc + thread_concurrency + w + work_size + l + sizeof(long) + .bin
  481. */
  482. char binaryfilename[255];
  483. char filename[255];
  484. char numbuf[32];
  485. if (cgpu->kernel == KL_NONE) {
  486. if (opt_scrypt) {
  487. applog(LOG_INFO, "Selecting scrypt kernel");
  488. clState->chosen_kernel = KL_SCRYPT;
  489. } else if (!strstr(name, "Tahiti") &&
  490. /* Detect all 2.6 SDKs not with Tahiti and use diablo kernel */
  491. (strstr(vbuff, "844.4") || // Linux 64 bit ATI 2.6 SDK
  492. strstr(vbuff, "851.4") || // Windows 64 bit ""
  493. strstr(vbuff, "831.4") ||
  494. strstr(vbuff, "898.1") || // 12.2 driver SDK
  495. strstr(vbuff, "923.1") || // 12.4
  496. strstr(vbuff, "938.2"))) { // SDK 2.7
  497. applog(LOG_INFO, "Selecting diablo kernel");
  498. clState->chosen_kernel = KL_DIABLO;
  499. /* Detect all 7970s, older ATI and NVIDIA and use poclbm */
  500. } else if (strstr(name, "Tahiti") || !clState->hasBitAlign) {
  501. applog(LOG_INFO, "Selecting poclbm kernel");
  502. clState->chosen_kernel = KL_POCLBM;
  503. /* Use phatk for the rest R5xxx R6xxx */
  504. } else {
  505. applog(LOG_INFO, "Selecting phatk kernel");
  506. clState->chosen_kernel = KL_PHATK;
  507. }
  508. cgpu->kernel = clState->chosen_kernel;
  509. } else {
  510. clState->chosen_kernel = cgpu->kernel;
  511. if (clState->chosen_kernel == KL_PHATK &&
  512. (strstr(vbuff, "844.4") || strstr(vbuff, "851.4") ||
  513. strstr(vbuff, "831.4") || strstr(vbuff, "898.1") ||
  514. strstr(vbuff, "923.1") || strstr(vbuff, "938.2"))) {
  515. applog(LOG_WARNING, "WARNING: You have selected the phatk kernel.");
  516. applog(LOG_WARNING, "You are running SDK 2.6+ which performs poorly with this kernel.");
  517. applog(LOG_WARNING, "Downgrade your SDK and delete any .bin files before starting again.");
  518. applog(LOG_WARNING, "Or allow BFGMiner to automatically choose a more suitable kernel.");
  519. }
  520. }
  521. /* For some reason 2 vectors is still better even if the card says
  522. * otherwise, and many cards lie about their max so use 256 as max
  523. * unless explicitly set on the command line. Tahiti prefers 1 */
  524. if (strstr(name, "Tahiti"))
  525. preferred_vwidth = 1;
  526. else if (preferred_vwidth > 2)
  527. preferred_vwidth = 2;
  528. switch (clState->chosen_kernel) {
  529. case KL_POCLBM:
  530. strcpy(filename, POCLBM_KERNNAME".cl");
  531. strcpy(binaryfilename, POCLBM_KERNNAME);
  532. break;
  533. case KL_PHATK:
  534. strcpy(filename, PHATK_KERNNAME".cl");
  535. strcpy(binaryfilename, PHATK_KERNNAME);
  536. break;
  537. case KL_DIAKGCN:
  538. strcpy(filename, DIAKGCN_KERNNAME".cl");
  539. strcpy(binaryfilename, DIAKGCN_KERNNAME);
  540. break;
  541. case KL_SCRYPT:
  542. strcpy(filename, SCRYPT_KERNNAME".cl");
  543. strcpy(binaryfilename, SCRYPT_KERNNAME);
  544. /* Scrypt only supports vector 1 */
  545. cgpu->vwidth = 1;
  546. break;
  547. case KL_NONE: /* Shouldn't happen */
  548. case KL_DIABLO:
  549. strcpy(filename, DIABLO_KERNNAME".cl");
  550. strcpy(binaryfilename, DIABLO_KERNNAME);
  551. break;
  552. }
  553. if (cgpu->vwidth)
  554. clState->vwidth = cgpu->vwidth;
  555. else {
  556. clState->vwidth = preferred_vwidth;
  557. cgpu->vwidth = preferred_vwidth;
  558. }
  559. if (((clState->chosen_kernel == KL_POCLBM || clState->chosen_kernel == KL_DIABLO || clState->chosen_kernel == KL_DIAKGCN) &&
  560. clState->vwidth == 1 && clState->hasOpenCL11plus) || opt_scrypt)
  561. clState->goffset = true;
  562. if (cgpu->work_size && cgpu->work_size <= clState->max_work_size)
  563. clState->wsize = cgpu->work_size;
  564. else if (strstr(name, "Tahiti"))
  565. clState->wsize = 64;
  566. else
  567. clState->wsize = (clState->max_work_size <= 256 ? clState->max_work_size : 256) / clState->vwidth;
  568. cgpu->work_size = clState->wsize;
  569. #ifdef USE_SCRYPT
  570. if (opt_scrypt) {
  571. cl_ulong ma = cgpu->max_alloc, mt;
  572. if (!cgpu->opt_lg) {
  573. applog(LOG_DEBUG, "GPU %d: selecting lookup gap of 2", gpu);
  574. cgpu->lookup_gap = 2;
  575. } else
  576. cgpu->lookup_gap = cgpu->opt_lg;
  577. if (!cgpu->opt_tc) {
  578. cgpu->thread_concurrency = ma / 32768 / cgpu->lookup_gap;
  579. if (cgpu->shaders && cgpu->thread_concurrency > cgpu->shaders) {
  580. cgpu->thread_concurrency -= cgpu->thread_concurrency % cgpu->shaders;
  581. if (cgpu->thread_concurrency > cgpu->shaders * 5)
  582. cgpu->thread_concurrency = cgpu->shaders * 5;
  583. }
  584. applog(LOG_DEBUG, "GPU %u: selecting thread concurrency of %lu", gpu, (unsigned long)cgpu->thread_concurrency);
  585. } else
  586. cgpu->thread_concurrency = cgpu->opt_tc;
  587. /* If we have memory to spare, try to find a power of 2 value
  588. * >= required amount to map nicely to an intensity */
  589. mt = cgpu->thread_concurrency * 32768 * cgpu->lookup_gap;
  590. if (ma > mt) {
  591. ma = 1;
  592. while (ma < mt)
  593. ma <<= 1;
  594. if (ma < cgpu->max_alloc) {
  595. cgpu->max_alloc = ma;
  596. applog(LOG_DEBUG, "Max alloc decreased to %lu", (unsigned long)cgpu->max_alloc);
  597. }
  598. }
  599. }
  600. #endif
  601. FILE *binaryfile;
  602. size_t *binary_sizes;
  603. char **binaries;
  604. int pl;
  605. char *source = file_contents(filename, &pl);
  606. size_t sourceSize[] = {(size_t)pl};
  607. cl_uint slot, cpnd;
  608. slot = cpnd = 0;
  609. if (!source)
  610. return NULL;
  611. binary_sizes = calloc(sizeof(size_t) * MAX_GPUDEVICES * 4, 1);
  612. if (unlikely(!binary_sizes)) {
  613. applog(LOG_ERR, "Unable to calloc binary_sizes");
  614. return NULL;
  615. }
  616. binaries = calloc(sizeof(char *) * MAX_GPUDEVICES * 4, 1);
  617. if (unlikely(!binaries)) {
  618. applog(LOG_ERR, "Unable to calloc binaries");
  619. return NULL;
  620. }
  621. strcat(binaryfilename, name);
  622. if (clState->goffset)
  623. strcat(binaryfilename, "g");
  624. if (opt_scrypt) {
  625. #ifdef USE_SCRYPT
  626. sprintf(numbuf, "lg%utc%u", cgpu->lookup_gap, (unsigned int)cgpu->thread_concurrency);
  627. strcat(binaryfilename, numbuf);
  628. #endif
  629. } else {
  630. sprintf(numbuf, "v%d", clState->vwidth);
  631. strcat(binaryfilename, numbuf);
  632. }
  633. sprintf(numbuf, "w%d", (int)clState->wsize);
  634. strcat(binaryfilename, numbuf);
  635. sprintf(numbuf, "l%d", (int)sizeof(long));
  636. strcat(binaryfilename, numbuf);
  637. strcat(binaryfilename, ".bin");
  638. binaryfile = fopen(binaryfilename, "rb");
  639. if (!binaryfile) {
  640. applog(LOG_DEBUG, "No binary found, generating from source");
  641. } else {
  642. struct stat binary_stat;
  643. if (unlikely(stat(binaryfilename, &binary_stat))) {
  644. applog(LOG_DEBUG, "Unable to stat binary, generating from source");
  645. fclose(binaryfile);
  646. goto build;
  647. }
  648. if (!binary_stat.st_size)
  649. goto build;
  650. binary_sizes[slot] = binary_stat.st_size;
  651. binaries[slot] = (char *)calloc(binary_sizes[slot], 1);
  652. if (unlikely(!binaries[slot])) {
  653. applog(LOG_ERR, "Unable to calloc binaries");
  654. fclose(binaryfile);
  655. return NULL;
  656. }
  657. if (fread(binaries[slot], 1, binary_sizes[slot], binaryfile) != binary_sizes[slot]) {
  658. applog(LOG_ERR, "Unable to fread binaries");
  659. fclose(binaryfile);
  660. free(binaries[slot]);
  661. goto build;
  662. }
  663. clState->program = clCreateProgramWithBinary(clState->context, 1, &devices[gpu], &binary_sizes[slot], (const unsigned char **)binaries, &status, NULL);
  664. if (status != CL_SUCCESS) {
  665. applog(LOG_ERR, "Error %d: Loading Binary into cl_program (clCreateProgramWithBinary)", status);
  666. fclose(binaryfile);
  667. free(binaries[slot]);
  668. goto build;
  669. }
  670. fclose(binaryfile);
  671. applog(LOG_DEBUG, "Loaded binary image %s", binaryfilename);
  672. goto built;
  673. }
  674. /////////////////////////////////////////////////////////////////
  675. // Load CL file, build CL program object, create CL kernel object
  676. /////////////////////////////////////////////////////////////////
  677. build:
  678. clState->program = clCreateProgramWithSource(clState->context, 1, (const char **)&source, sourceSize, &status);
  679. if (status != CL_SUCCESS) {
  680. applog(LOG_ERR, "Error %d: Loading Binary into cl_program (clCreateProgramWithSource)", status);
  681. return NULL;
  682. }
  683. /* create a cl program executable for all the devices specified */
  684. char *CompilerOptions = calloc(1, 256);
  685. #ifdef USE_SCRYPT
  686. if (opt_scrypt)
  687. sprintf(CompilerOptions, "-D LOOKUP_GAP=%d -D CONCURRENT_THREADS=%d -D WORKSIZE=%d",
  688. cgpu->lookup_gap, (unsigned int)cgpu->thread_concurrency, (int)clState->wsize);
  689. else
  690. #endif
  691. {
  692. sprintf(CompilerOptions, "-D WORKSIZE=%d -D VECTORS%d -D WORKVEC=%d",
  693. (int)clState->wsize, clState->vwidth, (int)clState->wsize * clState->vwidth);
  694. }
  695. applog(LOG_DEBUG, "Setting worksize to %"PRId64, (int64_t)clState->wsize);
  696. if (clState->vwidth > 1)
  697. applog(LOG_DEBUG, "Patched source to suit %d vectors", clState->vwidth);
  698. if (clState->hasBitAlign) {
  699. strcat(CompilerOptions, " -D BITALIGN");
  700. applog(LOG_DEBUG, "cl_amd_media_ops found, setting BITALIGN");
  701. if (strstr(name, "Cedar") ||
  702. strstr(name, "Redwood") ||
  703. strstr(name, "Juniper") ||
  704. strstr(name, "Cypress" ) ||
  705. strstr(name, "Hemlock" ) ||
  706. strstr(name, "Caicos" ) ||
  707. strstr(name, "Turks" ) ||
  708. strstr(name, "Barts" ) ||
  709. strstr(name, "Cayman" ) ||
  710. strstr(name, "Antilles" ) ||
  711. strstr(name, "Wrestler" ) ||
  712. strstr(name, "Zacate" ) ||
  713. strstr(name, "WinterPark" ) ||
  714. strstr(name, "BeaverCreek" ))
  715. patchbfi = true;
  716. } else
  717. applog(LOG_DEBUG, "cl_amd_media_ops not found, will not set BITALIGN");
  718. if (patchbfi) {
  719. strcat(CompilerOptions, " -D BFI_INT");
  720. applog(LOG_DEBUG, "BFI_INT patch requiring device found, patched source with BFI_INT");
  721. } else
  722. applog(LOG_DEBUG, "BFI_INT patch requiring device not found, will not BFI_INT patch");
  723. if (clState->goffset)
  724. strcat(CompilerOptions, " -D GOFFSET");
  725. if (!clState->hasOpenCL11plus)
  726. strcat(CompilerOptions, " -D OCL1");
  727. applog(LOG_DEBUG, "CompilerOptions: %s", CompilerOptions);
  728. status = clBuildProgram(clState->program, 1, &devices[gpu], CompilerOptions , NULL, NULL);
  729. free(CompilerOptions);
  730. if (status != CL_SUCCESS) {
  731. applog(LOG_ERR, "Error %d: Building Program (clBuildProgram)", status);
  732. size_t logSize;
  733. status = clGetProgramBuildInfo(clState->program, devices[gpu], CL_PROGRAM_BUILD_LOG, 0, NULL, &logSize);
  734. char *log = malloc(logSize);
  735. status = clGetProgramBuildInfo(clState->program, devices[gpu], CL_PROGRAM_BUILD_LOG, logSize, log, NULL);
  736. applog(LOG_ERR, "%s", log);
  737. return NULL;
  738. }
  739. prog_built = true;
  740. status = clGetProgramInfo(clState->program, CL_PROGRAM_NUM_DEVICES, sizeof(cl_uint), &cpnd, NULL);
  741. if (unlikely(status != CL_SUCCESS)) {
  742. applog(LOG_ERR, "Error %d: Getting program info CL_PROGRAM_NUM_DEVICES. (clGetProgramInfo)", status);
  743. return NULL;
  744. }
  745. status = clGetProgramInfo(clState->program, CL_PROGRAM_BINARY_SIZES, sizeof(size_t)*cpnd, binary_sizes, NULL);
  746. if (unlikely(status != CL_SUCCESS)) {
  747. applog(LOG_ERR, "Error %d: Getting program info CL_PROGRAM_BINARY_SIZES. (clGetProgramInfo)", status);
  748. return NULL;
  749. }
  750. /* The actual compiled binary ends up in a RANDOM slot! Grr, so we have
  751. * to iterate over all the binary slots and find where the real program
  752. * is. What the heck is this!? */
  753. for (slot = 0; slot < cpnd; slot++)
  754. if (binary_sizes[slot])
  755. break;
  756. /* copy over all of the generated binaries. */
  757. applog(LOG_DEBUG, "Binary size for gpu %u found in binary slot %u: %"PRId64,
  758. gpu, (unsigned)slot, (int64_t)binary_sizes[slot]);
  759. if (!binary_sizes[slot]) {
  760. applog(LOG_ERR, "OpenCL compiler generated a zero sized binary, FAIL!");
  761. return NULL;
  762. }
  763. binaries[slot] = calloc(sizeof(char) * binary_sizes[slot], 1);
  764. status = clGetProgramInfo(clState->program, CL_PROGRAM_BINARIES, sizeof(char *) * cpnd, binaries, NULL );
  765. if (unlikely(status != CL_SUCCESS)) {
  766. applog(LOG_ERR, "Error %d: Getting program info. CL_PROGRAM_BINARIES (clGetProgramInfo)", status);
  767. return NULL;
  768. }
  769. /* Patch the kernel if the hardware supports BFI_INT but it needs to
  770. * be hacked in */
  771. if (patchbfi) {
  772. unsigned remaining = binary_sizes[slot];
  773. char *w = binaries[slot];
  774. unsigned int start, length;
  775. /* Find 2nd incidence of .text, and copy the program's
  776. * position and length at a fixed offset from that. Then go
  777. * back and find the 2nd incidence of \x7ELF (rewind by one
  778. * from ELF) and then patch the opcocdes */
  779. if (!advance(&w, &remaining, ".text"))
  780. goto build;
  781. w++; remaining--;
  782. if (!advance(&w, &remaining, ".text")) {
  783. /* 32 bit builds only one ELF */
  784. w--; remaining++;
  785. }
  786. memcpy(&start, w + 285, 4);
  787. memcpy(&length, w + 289, 4);
  788. w = binaries[slot]; remaining = binary_sizes[slot];
  789. if (!advance(&w, &remaining, "ELF"))
  790. goto build;
  791. w++; remaining--;
  792. if (!advance(&w, &remaining, "ELF")) {
  793. /* 32 bit builds only one ELF */
  794. w--; remaining++;
  795. }
  796. w--; remaining++;
  797. w += start; remaining -= start;
  798. applog(LOG_DEBUG, "At %p (%u rem. bytes), to begin patching",
  799. w, remaining);
  800. patch_opcodes(w, length);
  801. status = clReleaseProgram(clState->program);
  802. if (status != CL_SUCCESS) {
  803. applog(LOG_ERR, "Error %d: Releasing program. (clReleaseProgram)", status);
  804. return NULL;
  805. }
  806. clState->program = clCreateProgramWithBinary(clState->context, 1, &devices[gpu], &binary_sizes[slot], (const unsigned char **)&binaries[slot], &status, NULL);
  807. if (status != CL_SUCCESS) {
  808. applog(LOG_ERR, "Error %d: Loading Binary into cl_program (clCreateProgramWithBinary)", status);
  809. return NULL;
  810. }
  811. /* Program needs to be rebuilt */
  812. prog_built = false;
  813. }
  814. free(source);
  815. /* Save the binary to be loaded next time */
  816. binaryfile = fopen(binaryfilename, "wb");
  817. if (!binaryfile) {
  818. /* Not a fatal problem, just means we build it again next time */
  819. applog(LOG_DEBUG, "Unable to create file %s", binaryfilename);
  820. } else {
  821. if (unlikely(fwrite(binaries[slot], 1, binary_sizes[slot], binaryfile) != binary_sizes[slot])) {
  822. applog(LOG_ERR, "Unable to fwrite to binaryfile");
  823. return NULL;
  824. }
  825. fclose(binaryfile);
  826. }
  827. built:
  828. if (binaries[slot])
  829. free(binaries[slot]);
  830. free(binaries);
  831. free(binary_sizes);
  832. applog(LOG_INFO, "Initialising kernel %s with%s bitalign, %"PRId64" vectors and worksize %"PRIu64,
  833. filename, clState->hasBitAlign ? "" : "out", (int64_t)clState->vwidth, (uint64_t)clState->wsize);
  834. if (!prog_built) {
  835. /* create a cl program executable for all the devices specified */
  836. status = clBuildProgram(clState->program, 1, &devices[gpu], NULL, NULL, NULL);
  837. if (status != CL_SUCCESS) {
  838. applog(LOG_ERR, "Error %d: Building Program (clBuildProgram)", status);
  839. size_t logSize;
  840. status = clGetProgramBuildInfo(clState->program, devices[gpu], CL_PROGRAM_BUILD_LOG, 0, NULL, &logSize);
  841. char *log = malloc(logSize);
  842. status = clGetProgramBuildInfo(clState->program, devices[gpu], CL_PROGRAM_BUILD_LOG, logSize, log, NULL);
  843. applog(LOG_ERR, "%s", log);
  844. return NULL;
  845. }
  846. }
  847. /* get a kernel object handle for a kernel with the given name */
  848. clState->kernel = clCreateKernel(clState->program, "search", &status);
  849. if (status != CL_SUCCESS) {
  850. applog(LOG_ERR, "Error %d: Creating Kernel from program. (clCreateKernel)", status);
  851. return NULL;
  852. }
  853. #ifdef USE_SCRYPT
  854. if (opt_scrypt) {
  855. size_t ipt = (1024 / cgpu->lookup_gap + (1024 % cgpu->lookup_gap > 0));
  856. size_t bufsize = 128 * ipt * cgpu->thread_concurrency;
  857. /* Use the max alloc value which has been rounded to a power of
  858. * 2 greater >= required amount earlier */
  859. if (bufsize > cgpu->max_alloc) {
  860. applog(LOG_WARNING, "Maximum buffer memory device %d supports says %lu", gpu, (unsigned long)cgpu->max_alloc);
  861. applog(LOG_WARNING, "Your scrypt settings come to %lu", (unsigned long)bufsize);
  862. } else
  863. bufsize = cgpu->max_alloc;
  864. applog(LOG_DEBUG, "Creating scrypt buffer sized %ld", (unsigned long)bufsize);
  865. clState->padbufsize = bufsize;
  866. /* This buffer is weird and might work to some degree even if
  867. * the create buffer call has apparently failed, so check if we
  868. * get anything back before we call it a failure. */
  869. clState->padbuffer8 = NULL;
  870. clState->padbuffer8 = clCreateBuffer(clState->context, CL_MEM_READ_WRITE, bufsize, NULL, &status);
  871. if (status != CL_SUCCESS && !clState->padbuffer8) {
  872. applog(LOG_ERR, "Error %d: clCreateBuffer (padbuffer8), decrease CT or increase LG", status);
  873. return NULL;
  874. }
  875. clState->CLbuffer0 = clCreateBuffer(clState->context, CL_MEM_READ_ONLY, 128, NULL, &status);
  876. if (status != CL_SUCCESS) {
  877. applog(LOG_ERR, "Error %d: clCreateBuffer (CLbuffer0)", status);
  878. return NULL;
  879. }
  880. }
  881. #endif
  882. clState->outputBuffer = clCreateBuffer(clState->context, CL_MEM_WRITE_ONLY, BUFFERSIZE, NULL, &status);
  883. if (status != CL_SUCCESS) {
  884. applog(LOG_ERR, "Error %d: clCreateBuffer (outputBuffer)", status);
  885. return NULL;
  886. }
  887. return clState;
  888. }
  889. #endif /* HAVE_OPENCL */