ua_services_attribute.c 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935
  1. #include "ua_server_internal.h"
  2. #include "ua_services.h"
  3. /**********************/
  4. /* Parse NumericRange */
  5. /**********************/
  6. static size_t
  7. readDimension(UA_Byte *buf, size_t buflen, UA_NumericRangeDimension *dim) {
  8. size_t progress = UA_readNumber(buf, buflen, &dim->min);
  9. if(progress == 0)
  10. return 0;
  11. if(buflen <= progress + 1 || buf[progress] != ':') {
  12. dim->max = dim->min;
  13. return progress;
  14. }
  15. progress++;
  16. size_t progress2 = UA_readNumber(&buf[progress], buflen - progress, &dim->max);
  17. if(progress2 == 0)
  18. return 0;
  19. /* invalid range */
  20. if(dim->min > dim->max)
  21. return 0;
  22. return progress + progress2;
  23. }
  24. #ifndef UA_BUILD_UNIT_TESTS
  25. static
  26. #endif
  27. UA_StatusCode parse_numericrange(const UA_String *str, UA_NumericRange *range) {
  28. size_t idx = 0;
  29. size_t dimensionsMax = 0;
  30. UA_NumericRangeDimension *dimensions = NULL;
  31. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  32. size_t offset = 0;
  33. while(true) {
  34. /* alloc dimensions */
  35. if(idx >= dimensionsMax) {
  36. UA_NumericRangeDimension *newds;
  37. size_t newdssize = sizeof(UA_NumericRangeDimension) * (dimensionsMax + 2);
  38. newds = UA_realloc(dimensions, newdssize);
  39. if(!newds) {
  40. retval = UA_STATUSCODE_BADOUTOFMEMORY;
  41. break;
  42. }
  43. dimensions = newds;
  44. dimensionsMax = dimensionsMax + 2;
  45. }
  46. /* read the dimension */
  47. size_t progress = readDimension(&str->data[offset], str->length - offset,
  48. &dimensions[idx]);
  49. if(progress == 0) {
  50. retval = UA_STATUSCODE_BADINDEXRANGEINVALID;
  51. break;
  52. }
  53. offset += progress;
  54. idx++;
  55. /* loop into the next dimension */
  56. if(offset >= str->length)
  57. break;
  58. if(str->data[offset] != ',') {
  59. retval = UA_STATUSCODE_BADINDEXRANGEINVALID;
  60. break;
  61. }
  62. offset++;
  63. }
  64. if(retval == UA_STATUSCODE_GOOD && idx > 0) {
  65. range->dimensions = dimensions;
  66. range->dimensionsSize = idx;
  67. } else
  68. UA_free(dimensions);
  69. return retval;
  70. }
  71. /******************/
  72. /* Read Attribute */
  73. /******************/
  74. /* force cast for zero-copy reading. ensure that the variant is never written into. */
  75. static void forceVariantSetScalar(UA_Variant *v, const void *p, const UA_DataType *t) {
  76. UA_Variant_init(v);
  77. v->type = t;
  78. v->data = (void*)(uintptr_t)p;
  79. v->storageType = UA_VARIANT_DATA_NODELETE;
  80. }
  81. static UA_StatusCode
  82. getVariableNodeValue(UA_Server *server, UA_Session *session,
  83. const UA_VariableNode *vn,
  84. const UA_TimestampsToReturn timestamps,
  85. const UA_ReadValueId *id, UA_DataValue *v) {
  86. UA_NumericRange range;
  87. UA_NumericRange *rangeptr = NULL;
  88. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  89. if(id->indexRange.length > 0) {
  90. retval = parse_numericrange(&id->indexRange, &range);
  91. if(retval != UA_STATUSCODE_GOOD)
  92. return retval;
  93. rangeptr = &range;
  94. }
  95. if(vn->valueSource == UA_VALUESOURCE_DATA) {
  96. if(vn->value.data.callback.onRead)
  97. vn->value.data.callback.onRead(vn->value.data.callback.handle, vn->nodeId,
  98. &v->value, rangeptr);
  99. if(!rangeptr) {
  100. *v = vn->value.data.value;
  101. v->value.storageType = UA_VARIANT_DATA_NODELETE;
  102. } else
  103. retval = UA_Variant_copyRange(&vn->value.data.value.value, &v->value, range);
  104. } else {
  105. if(!vn->value.dataSource.read) {
  106. UA_LOG_DEBUG_SESSION(server->config.logger, session,
  107. "DataSource cannot be read in ReadRequest");
  108. retval = UA_STATUSCODE_BADINTERNALERROR;
  109. } else {
  110. UA_Boolean sourceTimeStamp = (timestamps == UA_TIMESTAMPSTORETURN_SOURCE ||
  111. timestamps == UA_TIMESTAMPSTORETURN_BOTH);
  112. retval = vn->value.dataSource.read(vn->value.dataSource.handle, vn->nodeId,
  113. sourceTimeStamp, rangeptr, v);
  114. }
  115. }
  116. if(rangeptr)
  117. UA_free(range.dimensions);
  118. return retval;
  119. }
  120. static UA_StatusCode
  121. getVariableNodeArrayDimensions(const UA_VariableNode *vn, UA_DataValue *v) {
  122. UA_Variant_setArray(&v->value, vn->arrayDimensions, vn->arrayDimensionsSize,
  123. &UA_TYPES[UA_TYPES_INT32]);
  124. v->value.storageType = UA_VARIANT_DATA_NODELETE;
  125. v->hasValue = true;
  126. return UA_STATUSCODE_GOOD;
  127. }
  128. static UA_StatusCode
  129. getIsAbstractAttribute(const UA_Node *node, UA_Variant *v) {
  130. const UA_Boolean *isAbstract;
  131. switch(node->nodeClass) {
  132. case UA_NODECLASS_REFERENCETYPE:
  133. isAbstract = &((const UA_ReferenceTypeNode*)node)->isAbstract;
  134. break;
  135. case UA_NODECLASS_OBJECTTYPE:
  136. isAbstract = &((const UA_ObjectTypeNode*)node)->isAbstract;
  137. break;
  138. case UA_NODECLASS_VARIABLETYPE:
  139. isAbstract = &((const UA_VariableTypeNode*)node)->isAbstract;
  140. break;
  141. case UA_NODECLASS_DATATYPE:
  142. isAbstract = &((const UA_DataTypeNode*)node)->isAbstract;
  143. break;
  144. default:
  145. return UA_STATUSCODE_BADATTRIBUTEIDINVALID;
  146. }
  147. forceVariantSetScalar(v, isAbstract, &UA_TYPES[UA_TYPES_BOOLEAN]);
  148. return UA_STATUSCODE_GOOD;
  149. }
  150. static const UA_String binEncoding = {sizeof("DefaultBinary")-1, (UA_Byte*)"DefaultBinary"};
  151. /* clang complains about unused variables */
  152. /* static const UA_String xmlEncoding = {sizeof("DefaultXml")-1, (UA_Byte*)"DefaultXml"}; */
  153. #define CHECK_NODECLASS(CLASS) \
  154. if(!(node->nodeClass & (CLASS))) { \
  155. retval = UA_STATUSCODE_BADATTRIBUTEIDINVALID; \
  156. break; \
  157. }
  158. /* Reads a single attribute from a node in the nodestore */
  159. void Service_Read_single(UA_Server *server, UA_Session *session,
  160. const UA_TimestampsToReturn timestamps,
  161. const UA_ReadValueId *id, UA_DataValue *v) {
  162. UA_LOG_DEBUG_SESSION(server->config.logger, session,
  163. "Read the attribute %i", id->attributeId);
  164. if(id->dataEncoding.name.length > 0 &&
  165. !UA_String_equal(&binEncoding, &id->dataEncoding.name)) {
  166. v->hasStatus = true;
  167. v->status = UA_STATUSCODE_BADDATAENCODINGUNSUPPORTED;
  168. return;
  169. }
  170. /* index range for a non-value */
  171. if(id->indexRange.length > 0 && id->attributeId != UA_ATTRIBUTEID_VALUE){
  172. v->hasStatus = true;
  173. v->status = UA_STATUSCODE_BADINDEXRANGENODATA;
  174. return;
  175. }
  176. UA_Node const *node = UA_NodeStore_get(server->nodestore, &id->nodeId);
  177. if(!node) {
  178. v->hasStatus = true;
  179. v->status = UA_STATUSCODE_BADNODEIDUNKNOWN;
  180. return;
  181. }
  182. /* When setting the value fails in the switch, we get an error code and set
  183. hasValue to false */
  184. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  185. v->hasValue = true;
  186. switch(id->attributeId) {
  187. case UA_ATTRIBUTEID_NODEID:
  188. forceVariantSetScalar(&v->value, &node->nodeId, &UA_TYPES[UA_TYPES_NODEID]);
  189. break;
  190. case UA_ATTRIBUTEID_NODECLASS:
  191. forceVariantSetScalar(&v->value, &node->nodeClass, &UA_TYPES[UA_TYPES_NODECLASS]);
  192. break;
  193. case UA_ATTRIBUTEID_BROWSENAME:
  194. forceVariantSetScalar(&v->value, &node->browseName, &UA_TYPES[UA_TYPES_QUALIFIEDNAME]);
  195. break;
  196. case UA_ATTRIBUTEID_DISPLAYNAME:
  197. forceVariantSetScalar(&v->value, &node->displayName, &UA_TYPES[UA_TYPES_LOCALIZEDTEXT]);
  198. break;
  199. case UA_ATTRIBUTEID_DESCRIPTION:
  200. forceVariantSetScalar(&v->value, &node->description, &UA_TYPES[UA_TYPES_LOCALIZEDTEXT]);
  201. break;
  202. case UA_ATTRIBUTEID_WRITEMASK:
  203. forceVariantSetScalar(&v->value, &node->writeMask, &UA_TYPES[UA_TYPES_UINT32]);
  204. break;
  205. case UA_ATTRIBUTEID_USERWRITEMASK:
  206. forceVariantSetScalar(&v->value, &node->userWriteMask, &UA_TYPES[UA_TYPES_UINT32]);
  207. break;
  208. case UA_ATTRIBUTEID_ISABSTRACT:
  209. retval = getIsAbstractAttribute(node, &v->value);
  210. break;
  211. case UA_ATTRIBUTEID_SYMMETRIC:
  212. CHECK_NODECLASS(UA_NODECLASS_REFERENCETYPE);
  213. forceVariantSetScalar(&v->value, &((const UA_ReferenceTypeNode*)node)->symmetric,
  214. &UA_TYPES[UA_TYPES_BOOLEAN]);
  215. break;
  216. case UA_ATTRIBUTEID_INVERSENAME:
  217. CHECK_NODECLASS(UA_NODECLASS_REFERENCETYPE);
  218. forceVariantSetScalar(&v->value, &((const UA_ReferenceTypeNode*)node)->inverseName,
  219. &UA_TYPES[UA_TYPES_LOCALIZEDTEXT]);
  220. break;
  221. case UA_ATTRIBUTEID_CONTAINSNOLOOPS:
  222. CHECK_NODECLASS(UA_NODECLASS_VIEW);
  223. forceVariantSetScalar(&v->value, &((const UA_ViewNode*)node)->containsNoLoops,
  224. &UA_TYPES[UA_TYPES_BOOLEAN]);
  225. break;
  226. case UA_ATTRIBUTEID_EVENTNOTIFIER:
  227. CHECK_NODECLASS(UA_NODECLASS_VIEW | UA_NODECLASS_OBJECT);
  228. forceVariantSetScalar(&v->value, &((const UA_ViewNode*)node)->eventNotifier,
  229. &UA_TYPES[UA_TYPES_BYTE]);
  230. break;
  231. case UA_ATTRIBUTEID_VALUE:
  232. CHECK_NODECLASS(UA_NODECLASS_VARIABLE | UA_NODECLASS_VARIABLETYPE);
  233. retval = getVariableNodeValue(server, session, (const UA_VariableNode*)node, timestamps, id, v);
  234. break;
  235. case UA_ATTRIBUTEID_DATATYPE:
  236. CHECK_NODECLASS(UA_NODECLASS_VARIABLE | UA_NODECLASS_VARIABLETYPE);
  237. forceVariantSetScalar(&v->value, &((const UA_VariableTypeNode*)node)->dataType,
  238. &UA_TYPES[UA_TYPES_NODEID]);
  239. break;
  240. case UA_ATTRIBUTEID_VALUERANK:
  241. CHECK_NODECLASS(UA_NODECLASS_VARIABLE | UA_NODECLASS_VARIABLETYPE);
  242. forceVariantSetScalar(&v->value, &((const UA_VariableTypeNode*)node)->valueRank,
  243. &UA_TYPES[UA_TYPES_INT32]);
  244. break;
  245. case UA_ATTRIBUTEID_ARRAYDIMENSIONS:
  246. CHECK_NODECLASS(UA_NODECLASS_VARIABLE | UA_NODECLASS_VARIABLETYPE);
  247. retval = getVariableNodeArrayDimensions((const UA_VariableNode*)node, v);
  248. break;
  249. case UA_ATTRIBUTEID_ACCESSLEVEL:
  250. CHECK_NODECLASS(UA_NODECLASS_VARIABLE);
  251. forceVariantSetScalar(&v->value, &((const UA_VariableNode*)node)->accessLevel,
  252. &UA_TYPES[UA_TYPES_BYTE]);
  253. break;
  254. case UA_ATTRIBUTEID_USERACCESSLEVEL:
  255. CHECK_NODECLASS(UA_NODECLASS_VARIABLE);
  256. forceVariantSetScalar(&v->value, &((const UA_VariableNode*)node)->userAccessLevel,
  257. &UA_TYPES[UA_TYPES_BYTE]);
  258. break;
  259. case UA_ATTRIBUTEID_MINIMUMSAMPLINGINTERVAL:
  260. CHECK_NODECLASS(UA_NODECLASS_VARIABLE);
  261. forceVariantSetScalar(&v->value, &((const UA_VariableNode*)node)->minimumSamplingInterval,
  262. &UA_TYPES[UA_TYPES_DOUBLE]);
  263. break;
  264. case UA_ATTRIBUTEID_HISTORIZING:
  265. CHECK_NODECLASS(UA_NODECLASS_VARIABLE);
  266. forceVariantSetScalar(&v->value, &((const UA_VariableNode*)node)->historizing,
  267. &UA_TYPES[UA_TYPES_BOOLEAN]);
  268. break;
  269. case UA_ATTRIBUTEID_EXECUTABLE:
  270. CHECK_NODECLASS(UA_NODECLASS_METHOD);
  271. forceVariantSetScalar(&v->value, &((const UA_MethodNode*)node)->executable,
  272. &UA_TYPES[UA_TYPES_BOOLEAN]);
  273. break;
  274. case UA_ATTRIBUTEID_USEREXECUTABLE:
  275. CHECK_NODECLASS(UA_NODECLASS_METHOD);
  276. forceVariantSetScalar(&v->value, &((const UA_MethodNode*)node)->userExecutable,
  277. &UA_TYPES[UA_TYPES_BOOLEAN]);
  278. break;
  279. default:
  280. retval = UA_STATUSCODE_BADATTRIBUTEIDINVALID;
  281. }
  282. if(retval != UA_STATUSCODE_GOOD) {
  283. v->hasValue = false;
  284. v->hasStatus = true;
  285. v->status = retval;
  286. }
  287. }
  288. void Service_Read(UA_Server *server, UA_Session *session,
  289. const UA_ReadRequest *request, UA_ReadResponse *response) {
  290. UA_LOG_DEBUG_SESSION(server->config.logger, session, "Processing ReadRequest");
  291. if(request->nodesToReadSize <= 0) {
  292. response->responseHeader.serviceResult = UA_STATUSCODE_BADNOTHINGTODO;
  293. return;
  294. }
  295. /* check if the timestampstoreturn is valid */
  296. if(request->timestampsToReturn > UA_TIMESTAMPSTORETURN_NEITHER) {
  297. response->responseHeader.serviceResult = UA_STATUSCODE_BADTIMESTAMPSTORETURNINVALID;
  298. return;
  299. }
  300. size_t size = request->nodesToReadSize;
  301. response->results = UA_Array_new(size, &UA_TYPES[UA_TYPES_DATAVALUE]);
  302. if(!response->results) {
  303. response->responseHeader.serviceResult = UA_STATUSCODE_BADOUTOFMEMORY;
  304. return;
  305. }
  306. response->resultsSize = size;
  307. if(request->maxAge < 0) {
  308. response->responseHeader.serviceResult = UA_STATUSCODE_BADMAXAGEINVALID;
  309. return;
  310. }
  311. #ifdef UA_ENABLE_EXTERNAL_NAMESPACES
  312. UA_Boolean isExternal[size];
  313. UA_UInt32 indices[size];
  314. memset(isExternal, false, sizeof(UA_Boolean) * size);
  315. for(size_t j = 0;j<server->externalNamespacesSize;j++) {
  316. size_t indexSize = 0;
  317. for(size_t i = 0;i < size;i++) {
  318. if(request->nodesToRead[i].nodeId.namespaceIndex != server->externalNamespaces[j].index)
  319. continue;
  320. isExternal[i] = true;
  321. indices[indexSize] = (UA_UInt32)i;
  322. indexSize++;
  323. }
  324. if(indexSize == 0)
  325. continue;
  326. UA_ExternalNodeStore *ens = &server->externalNamespaces[j].externalNodeStore;
  327. ens->readNodes(ens->ensHandle, &request->requestHeader, request->nodesToRead,
  328. indices, (UA_UInt32)indexSize, response->results, false,
  329. response->diagnosticInfos);
  330. }
  331. #endif
  332. for(size_t i = 0;i < size;i++) {
  333. #ifdef UA_ENABLE_EXTERNAL_NAMESPACES
  334. if(!isExternal[i])
  335. #endif
  336. Service_Read_single(server, session, request->timestampsToReturn,
  337. &request->nodesToRead[i], &response->results[i]);
  338. }
  339. #ifdef UA_ENABLE_NONSTANDARD_STATELESS
  340. /* Add an expiry header for caching */
  341. if(session->sessionId.namespaceIndex == 0 &&
  342. session->sessionId.identifierType == UA_NODEIDTYPE_NUMERIC &&
  343. session->sessionId.identifier.numeric == 0){
  344. UA_ExtensionObject additionalHeader;
  345. UA_ExtensionObject_init(&additionalHeader);
  346. additionalHeader.encoding = UA_EXTENSIONOBJECT_ENCODED_BYTESTRING;
  347. additionalHeader.content.encoded.typeId =UA_TYPES[UA_TYPES_VARIANT].typeId;
  348. UA_Variant variant;
  349. UA_Variant_init(&variant);
  350. UA_DateTime* expireArray = NULL;
  351. expireArray = UA_Array_new(request->nodesToReadSize,
  352. &UA_TYPES[UA_TYPES_DATETIME]);
  353. variant.data = expireArray;
  354. /* expires in 20 seconds */
  355. for(UA_UInt32 i = 0;i < response->resultsSize;i++) {
  356. expireArray[i] = UA_DateTime_now() + 20 * 100 * 1000 * 1000;
  357. }
  358. UA_Variant_setArray(&variant, expireArray, request->nodesToReadSize,
  359. &UA_TYPES[UA_TYPES_DATETIME]);
  360. size_t offset = 0;
  361. UA_ByteString str;
  362. size_t strlength = UA_calcSizeBinary(&variant, &UA_TYPES[UA_TYPES_VARIANT]);
  363. UA_ByteString_allocBuffer(&str, strlength);
  364. /* No chunking callback for the encoding */
  365. UA_StatusCode retval = UA_encodeBinary(&variant, &UA_TYPES[UA_TYPES_VARIANT],
  366. NULL, NULL, &str, &offset);
  367. UA_Array_delete(expireArray, request->nodesToReadSize, &UA_TYPES[UA_TYPES_DATETIME]);
  368. if(retval == UA_STATUSCODE_GOOD){
  369. additionalHeader.content.encoded.body.data = str.data;
  370. additionalHeader.content.encoded.body.length = offset;
  371. response->responseHeader.additionalHeader = additionalHeader;
  372. }
  373. }
  374. #endif
  375. }
  376. /* Exposes the Read service to local users */
  377. UA_DataValue
  378. UA_Server_read(UA_Server *server, const UA_ReadValueId *item,
  379. UA_TimestampsToReturn timestamps) {
  380. UA_DataValue dv;
  381. UA_DataValue_init(&dv);
  382. UA_RCU_LOCK();
  383. Service_Read_single(server, &adminSession, timestamps, item, &dv);
  384. UA_RCU_UNLOCK();
  385. return dv;
  386. }
  387. /* Used in inline functions exposing the Read service with more syntactic sugar
  388. * for individual attributes */
  389. UA_StatusCode
  390. __UA_Server_read(UA_Server *server, const UA_NodeId *nodeId,
  391. const UA_AttributeId attributeId, void *v) {
  392. /* Call the read service */
  393. UA_ReadValueId item;
  394. UA_ReadValueId_init(&item);
  395. item.nodeId = *nodeId;
  396. item.attributeId = attributeId;
  397. UA_DataValue dv = UA_Server_read(server, &item, UA_TIMESTAMPSTORETURN_NEITHER);
  398. /* Check the return value */
  399. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  400. if(dv.hasStatus)
  401. retval = dv.hasStatus;
  402. else if(!dv.hasValue)
  403. retval = UA_STATUSCODE_BADUNEXPECTEDERROR;
  404. if(retval != UA_STATUSCODE_GOOD) {
  405. UA_DataValue_deleteMembers(&dv);
  406. return retval;
  407. }
  408. /* Prepare the result */
  409. if(attributeId == UA_ATTRIBUTEID_VALUE ||
  410. attributeId == UA_ATTRIBUTEID_ARRAYDIMENSIONS) {
  411. /* Return the entire variant */
  412. if(dv.value.storageType == UA_VARIANT_DATA_NODELETE) {
  413. retval = UA_Variant_copy(dv.value.data, v);
  414. } else { /* storageType is UA_VARIANT_DATA */
  415. memcpy(v, &dv.value, sizeof(UA_Variant));
  416. }
  417. } else {
  418. /* Return the variant content only */
  419. if(dv.value.storageType == UA_VARIANT_DATA_NODELETE) {
  420. retval = UA_copy(dv.value.data, v, dv.value.type);
  421. } else { /* storageType is UA_VARIANT_DATA */
  422. /* Copy the content of the type (including pointers and all)*/
  423. memcpy(v, dv.value.data, dv.value.type->memSize);
  424. /* Delete the "carrier" in the variant */
  425. UA_free(dv.value.data);
  426. }
  427. }
  428. return retval;
  429. }
  430. /*******************/
  431. /* Write Attribute */
  432. /*******************/
  433. UA_StatusCode
  434. UA_Server_editNode(UA_Server *server, UA_Session *session,
  435. const UA_NodeId *nodeId, UA_EditNodeCallback callback,
  436. const void *data) {
  437. UA_StatusCode retval;
  438. do {
  439. #ifndef UA_ENABLE_MULTITHREADING
  440. const UA_Node *node = UA_NodeStore_get(server->nodestore, nodeId);
  441. if(!node)
  442. return UA_STATUSCODE_BADNODEIDUNKNOWN;
  443. UA_Node *editNode = (UA_Node*)(uintptr_t)node; // dirty cast
  444. retval = callback(server, session, editNode, data);
  445. return retval;
  446. #else
  447. UA_Node *copy = UA_NodeStore_getCopy(server->nodestore, nodeId);
  448. if(!copy)
  449. return UA_STATUSCODE_BADOUTOFMEMORY;
  450. retval = callback(server, session, copy, data);
  451. if(retval != UA_STATUSCODE_GOOD) {
  452. UA_NodeStore_deleteNode(copy);
  453. return retval;
  454. }
  455. retval = UA_NodeStore_replace(server->nodestore, copy);
  456. #endif
  457. } while(retval != UA_STATUSCODE_GOOD);
  458. return UA_STATUSCODE_GOOD;
  459. }
  460. static UA_StatusCode
  461. writeToDataSource(UA_Server *server, UA_Session *session,
  462. const UA_VariableNode *node, const UA_WriteValue *wvalue) {
  463. if(!node->value.dataSource.write)
  464. return UA_STATUSCODE_BADWRITENOTSUPPORTED;
  465. UA_NumericRange *rangeptr = NULL;
  466. UA_NumericRange range;
  467. UA_StatusCode retval;
  468. /* Parse the range */
  469. if(wvalue->indexRange.length > 0) {
  470. retval = parse_numericrange(&wvalue->indexRange, &range);
  471. if(retval != UA_STATUSCODE_GOOD)
  472. return retval;
  473. rangeptr = &range;
  474. }
  475. /* Write into the datasource */
  476. retval = node->value.dataSource.write(node->value.dataSource.handle,
  477. node->nodeId, &wvalue->value.value,
  478. rangeptr);
  479. if(rangeptr)
  480. UA_free(range.dimensions);
  481. return retval;
  482. }
  483. enum type_equivalence {
  484. TYPE_EQUIVALENCE_NONE,
  485. TYPE_EQUIVALENCE_ENUM,
  486. TYPE_EQUIVALENCE_OPAQUE
  487. };
  488. const UA_DataType *
  489. findDataType(const UA_NodeId *typeId) {
  490. for(size_t i = 0; i < UA_TYPES_COUNT; i++) {
  491. if (UA_TYPES[i].typeId.identifier.numeric == typeId->identifier.numeric)
  492. return &UA_TYPES[i];
  493. }
  494. return NULL;
  495. }
  496. static enum type_equivalence typeEquivalence(const UA_DataType *t) {
  497. if(t->membersSize != 1 || !t->members[0].namespaceZero)
  498. return TYPE_EQUIVALENCE_NONE;
  499. if(t->members[0].memberTypeIndex == UA_TYPES_INT32)
  500. return TYPE_EQUIVALENCE_ENUM;
  501. if(t->members[0].memberTypeIndex == UA_TYPES_BYTE && t->members[0].isArray)
  502. return TYPE_EQUIVALENCE_OPAQUE;
  503. return TYPE_EQUIVALENCE_NONE;
  504. }
  505. /* Tests whether the value can be written into a node. Sometimes it can be
  506. * necessary to transform the content of the value, e.g. byte array to
  507. * bytestring or uint32 to some enum. If successful the equivalent variant
  508. * contains the correct definition (NODELETE, pointing to the members of the
  509. * original value, so do not delete) */
  510. static UA_StatusCode
  511. matchValueWithNodeDefinition(UA_Server *server, UA_VariableNode *node,
  512. const UA_Variant *value, const UA_NumericRange *range,
  513. UA_Variant *equivalent) {
  514. /* Prepare the output variant */
  515. *equivalent = *value;
  516. equivalent->storageType = UA_VARIANT_DATA_NODELETE;
  517. /* No content is only allowed for BaseDataType */
  518. const UA_NodeId *dataType;
  519. UA_NodeId basedatatype = UA_NODEID_NUMERIC(0, UA_NS0ID_BASEDATATYPE);
  520. if(value->type)
  521. dataType = &value->type->typeId;
  522. else
  523. dataType = &basedatatype;
  524. /* See if the types match. The nodeid on the wire may be != the nodeid in
  525. * the node for opaque types, enums and bytestrings. value contains the
  526. * correct type definition after the following paragraph */
  527. if(!UA_NodeId_equal(&node->dataType, dataType)) {
  528. /* is this a subtype? */
  529. UA_NodeId subtypeId = UA_NODEID_NUMERIC(0, UA_NS0ID_HASSUBTYPE);
  530. UA_Boolean found = false;
  531. UA_StatusCode retval = isNodeInTree(server->nodestore, dataType,
  532. &node->dataType, &subtypeId,
  533. 1, 10, &found);
  534. if(retval != UA_STATUSCODE_GOOD)
  535. return retval;
  536. if(found)
  537. goto check_array;
  538. /* compare the datatypes for equivalence */
  539. const UA_DataType *nodeDataType = findDataType(&node->dataType);
  540. const UA_DataType *valueDataType = value->type;
  541. if(!nodeDataType || !valueDataType)
  542. return UA_STATUSCODE_BADTYPEMISMATCH;
  543. /* a string is written to a byte array */
  544. if(nodeDataType == &UA_TYPES[UA_TYPES_BYTE] &&
  545. valueDataType == &UA_TYPES[UA_TYPES_BYTESTRING] &&
  546. !UA_Variant_isScalar(&node->value.data.value.value) &&
  547. UA_Variant_isScalar(value)) {
  548. UA_ByteString *str = (UA_ByteString*)value->data;
  549. equivalent->type = &UA_TYPES[UA_TYPES_BYTE];
  550. equivalent->arrayLength = str->length;
  551. equivalent->data = str->data;
  552. goto check_array;
  553. }
  554. /* An enum was sent as an int32, or an opaque type as a bytestring. This
  555. * is detected with the typeIndex indicated the "true" datatype. */
  556. enum type_equivalence te1 = typeEquivalence(nodeDataType);
  557. enum type_equivalence te2 = typeEquivalence(valueDataType);
  558. if(te1 != TYPE_EQUIVALENCE_NONE && te1 == te2) {
  559. equivalent->type = nodeDataType;
  560. goto check_array;
  561. }
  562. /* No more possible equivalencies */
  563. return UA_STATUSCODE_BADTYPEMISMATCH;
  564. }
  565. check_array:
  566. /* Check if the valuerank allows for the value dimension */
  567. switch(node->valueRank) {
  568. case -3: /* the value can be a scalar or a one dimensional array */
  569. if(value->arrayDimensionsSize > 1)
  570. return UA_STATUSCODE_BADTYPEMISMATCH;
  571. break;
  572. case -2: /* the value can be a scalar or an array with any number of dimensions */
  573. break;
  574. case -1: /* the value is a scalar */
  575. if(!UA_Variant_isScalar(equivalent))
  576. return UA_STATUSCODE_BADTYPEMISMATCH;
  577. case 0: /* the value is an array with one or more dimensions */
  578. if(UA_Variant_isScalar(equivalent))
  579. return UA_STATUSCODE_BADTYPEMISMATCH;
  580. break;
  581. default: /* >= 1: the value is an array with the specified number of dimensions */
  582. if(value->arrayDimensionsSize != (size_t)node->valueRank)
  583. return UA_STATUSCODE_BADTYPEMISMATCH;
  584. }
  585. /* Ranges are checked in detail during writing into the variant */
  586. if(range)
  587. return UA_STATUSCODE_GOOD;
  588. /* See if the array dimensions match */
  589. if(node->arrayDimensions) {
  590. if(value->arrayDimensionsSize != node->arrayDimensionsSize)
  591. return UA_STATUSCODE_BADTYPEMISMATCH;
  592. /* dimension size zero in the node definition: this value dimension can be any size */
  593. for(size_t i = 0; i < node->arrayDimensionsSize; i++) {
  594. if(node->arrayDimensions[i] != value->arrayDimensions[i] &&
  595. node->arrayDimensions[i] != 0)
  596. return UA_STATUSCODE_BADTYPEMISMATCH;
  597. }
  598. }
  599. return UA_STATUSCODE_GOOD;
  600. }
  601. UA_StatusCode
  602. writeValueAttribute(UA_Server *server, UA_VariableNode *node,
  603. const UA_DataValue *value, const UA_String *indexRange) {
  604. /* Parse the range */
  605. UA_NumericRange range;
  606. UA_NumericRange *rangeptr = NULL;
  607. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  608. if(indexRange && indexRange->length > 0) {
  609. if(!value->hasValue || !node->value.data.value.hasValue)
  610. return UA_STATUSCODE_BADINDEXRANGENODATA;
  611. retval = parse_numericrange(indexRange, &range);
  612. if(retval != UA_STATUSCODE_GOOD)
  613. return retval;
  614. rangeptr = &range;
  615. }
  616. /* Check the type definition and use a possibly transformed variant that
  617. * matches the node data type */
  618. UA_DataValue equivValue;
  619. if(value->hasValue) {
  620. equivValue = *value;
  621. retval = matchValueWithNodeDefinition(server, node, &value->value,
  622. rangeptr, &equivValue.value);
  623. if(retval != UA_STATUSCODE_GOOD)
  624. goto cleanup;
  625. value = &equivValue;
  626. }
  627. /* write the value */
  628. if(!rangeptr)
  629. retval = UA_DataValue_copy(value, &node->value.data.value);
  630. else
  631. retval = UA_Variant_setRangeCopy(&node->value.data.value.value,
  632. value->value.data, value->value.arrayLength, range);
  633. /* post-write callback */
  634. if(retval == UA_STATUSCODE_GOOD && node->value.data.callback.onWrite)
  635. node->value.data.callback.onWrite(node->value.data.callback.handle, node->nodeId,
  636. &node->value.data.value.value, rangeptr);
  637. cleanup:
  638. if(rangeptr)
  639. UA_free(range.dimensions);
  640. return retval;
  641. }
  642. static UA_StatusCode
  643. writeIsAbstractAttribute(UA_Node *node, UA_Boolean value) {
  644. switch(node->nodeClass) {
  645. case UA_NODECLASS_OBJECTTYPE:
  646. ((UA_ObjectTypeNode*)node)->isAbstract = value;
  647. break;
  648. case UA_NODECLASS_REFERENCETYPE:
  649. ((UA_ReferenceTypeNode*)node)->isAbstract = value;
  650. break;
  651. case UA_NODECLASS_VARIABLETYPE:
  652. ((UA_VariableTypeNode*)node)->isAbstract = value;
  653. break;
  654. case UA_NODECLASS_DATATYPE:
  655. ((UA_DataTypeNode*)node)->isAbstract = value;
  656. break;
  657. default:
  658. return UA_STATUSCODE_BADNODECLASSINVALID;
  659. }
  660. return UA_STATUSCODE_GOOD;
  661. }
  662. #define CHECK_DATATYPE(EXP_DT) \
  663. if(!wvalue->value.hasValue || \
  664. &UA_TYPES[UA_TYPES_##EXP_DT] != wvalue->value.value.type || \
  665. !UA_Variant_isScalar(&wvalue->value.value)) { \
  666. retval = UA_STATUSCODE_BADTYPEMISMATCH; \
  667. break; \
  668. }
  669. #define CHECK_NODECLASS_WRITE(CLASS) \
  670. if((node->nodeClass & (CLASS)) == 0) { \
  671. retval = UA_STATUSCODE_BADNODECLASSINVALID; \
  672. break; \
  673. }
  674. /* this function implements the main part of the write service */
  675. static UA_StatusCode
  676. CopyAttributeIntoNode(UA_Server *server, UA_Session *session,
  677. UA_Node *node, const UA_WriteValue *wvalue) {
  678. if(!wvalue->value.hasValue)
  679. return UA_STATUSCODE_BADTYPEMISMATCH;
  680. const void *value = wvalue->value.value.data;
  681. UA_StatusCode retval = UA_STATUSCODE_GOOD;
  682. switch(wvalue->attributeId) {
  683. case UA_ATTRIBUTEID_NODEID:
  684. case UA_ATTRIBUTEID_NODECLASS:
  685. case UA_ATTRIBUTEID_DATATYPE:
  686. retval = UA_STATUSCODE_BADWRITENOTSUPPORTED;
  687. break;
  688. case UA_ATTRIBUTEID_BROWSENAME:
  689. CHECK_DATATYPE(QUALIFIEDNAME);
  690. UA_QualifiedName_deleteMembers(&node->browseName);
  691. UA_QualifiedName_copy(value, &node->browseName);
  692. break;
  693. case UA_ATTRIBUTEID_DISPLAYNAME:
  694. CHECK_DATATYPE(LOCALIZEDTEXT);
  695. UA_LocalizedText_deleteMembers(&node->displayName);
  696. UA_LocalizedText_copy(value, &node->displayName);
  697. break;
  698. case UA_ATTRIBUTEID_DESCRIPTION:
  699. CHECK_DATATYPE(LOCALIZEDTEXT);
  700. UA_LocalizedText_deleteMembers(&node->description);
  701. UA_LocalizedText_copy(value, &node->description);
  702. break;
  703. case UA_ATTRIBUTEID_WRITEMASK:
  704. CHECK_DATATYPE(UINT32);
  705. node->writeMask = *(const UA_UInt32*)value;
  706. break;
  707. case UA_ATTRIBUTEID_USERWRITEMASK:
  708. CHECK_DATATYPE(UINT32);
  709. node->userWriteMask = *(const UA_UInt32*)value;
  710. break;
  711. case UA_ATTRIBUTEID_ISABSTRACT:
  712. CHECK_DATATYPE(BOOLEAN);
  713. retval = writeIsAbstractAttribute(node, *(const UA_Boolean*)value);
  714. break;
  715. case UA_ATTRIBUTEID_SYMMETRIC:
  716. CHECK_NODECLASS_WRITE(UA_NODECLASS_REFERENCETYPE);
  717. CHECK_DATATYPE(BOOLEAN);
  718. ((UA_ReferenceTypeNode*)node)->symmetric = *(const UA_Boolean*)value;
  719. break;
  720. case UA_ATTRIBUTEID_INVERSENAME:
  721. CHECK_NODECLASS_WRITE(UA_NODECLASS_REFERENCETYPE);
  722. CHECK_DATATYPE(LOCALIZEDTEXT);
  723. UA_LocalizedText_deleteMembers(&((UA_ReferenceTypeNode*)node)->inverseName);
  724. UA_LocalizedText_copy(value, &((UA_ReferenceTypeNode*)node)->inverseName);
  725. break;
  726. case UA_ATTRIBUTEID_CONTAINSNOLOOPS:
  727. CHECK_NODECLASS_WRITE(UA_NODECLASS_VIEW);
  728. CHECK_DATATYPE(BOOLEAN);
  729. ((UA_ViewNode*)node)->containsNoLoops = *(const UA_Boolean*)value;
  730. break;
  731. case UA_ATTRIBUTEID_EVENTNOTIFIER:
  732. CHECK_NODECLASS_WRITE(UA_NODECLASS_VIEW | UA_NODECLASS_OBJECT);
  733. CHECK_DATATYPE(BYTE);
  734. ((UA_ViewNode*)node)->eventNotifier = *(const UA_Byte*)value;
  735. break;
  736. case UA_ATTRIBUTEID_VALUE:
  737. CHECK_NODECLASS_WRITE(UA_NODECLASS_VARIABLE | UA_NODECLASS_VARIABLETYPE);
  738. if(((const UA_VariableNode*)node)->valueSource == UA_VALUESOURCE_DATA)
  739. retval = writeValueAttribute(server, (UA_VariableNode*)node,
  740. &wvalue->value, &wvalue->indexRange);
  741. else
  742. /* TODO: Don't make a copy of the node in the multithreaded case */
  743. /* TODO: Check if the type matches also for data sources */
  744. retval = writeToDataSource(server, session,
  745. (const UA_VariableNode*)node, wvalue);
  746. break;
  747. case UA_ATTRIBUTEID_ACCESSLEVEL:
  748. CHECK_NODECLASS_WRITE(UA_NODECLASS_VARIABLE);
  749. CHECK_DATATYPE(BYTE);
  750. ((UA_VariableNode*)node)->accessLevel = *(const UA_Byte*)value;
  751. break;
  752. case UA_ATTRIBUTEID_USERACCESSLEVEL:
  753. CHECK_NODECLASS_WRITE(UA_NODECLASS_VARIABLE);
  754. CHECK_DATATYPE(BYTE);
  755. ((UA_VariableNode*)node)->userAccessLevel = *(const UA_Byte*)value;
  756. break;
  757. case UA_ATTRIBUTEID_MINIMUMSAMPLINGINTERVAL:
  758. CHECK_NODECLASS_WRITE(UA_NODECLASS_VARIABLE);
  759. CHECK_DATATYPE(DOUBLE);
  760. ((UA_VariableNode*)node)->minimumSamplingInterval = *(const UA_Double*)value;
  761. break;
  762. case UA_ATTRIBUTEID_HISTORIZING:
  763. CHECK_NODECLASS_WRITE(UA_NODECLASS_VARIABLE);
  764. CHECK_DATATYPE(BOOLEAN);
  765. ((UA_VariableNode*)node)->historizing = *(const UA_Boolean*)value;
  766. break;
  767. case UA_ATTRIBUTEID_EXECUTABLE:
  768. CHECK_NODECLASS_WRITE(UA_NODECLASS_METHOD);
  769. CHECK_DATATYPE(BOOLEAN);
  770. ((UA_MethodNode*)node)->executable = *(const UA_Boolean*)value;
  771. break;
  772. case UA_ATTRIBUTEID_USEREXECUTABLE:
  773. CHECK_NODECLASS_WRITE(UA_NODECLASS_METHOD);
  774. CHECK_DATATYPE(BOOLEAN);
  775. ((UA_MethodNode*)node)->userExecutable = *(const UA_Boolean*)value;
  776. break;
  777. default:
  778. retval = UA_STATUSCODE_BADATTRIBUTEIDINVALID;
  779. break;
  780. }
  781. if(retval != UA_STATUSCODE_GOOD)
  782. UA_LOG_DEBUG_SESSION(server->config.logger, session,
  783. "WriteRequest returned status code 0x%08x", retval);
  784. return retval;
  785. }
  786. UA_StatusCode Service_Write_single(UA_Server *server, UA_Session *session,
  787. const UA_WriteValue *wvalue) {
  788. return UA_Server_editNode(server, session, &wvalue->nodeId,
  789. (UA_EditNodeCallback)CopyAttributeIntoNode, wvalue);
  790. }
  791. void Service_Write(UA_Server *server, UA_Session *session,
  792. const UA_WriteRequest *request, UA_WriteResponse *response) {
  793. UA_LOG_DEBUG_SESSION(server->config.logger, session, "Processing WriteRequest");
  794. if(request->nodesToWriteSize <= 0) {
  795. response->responseHeader.serviceResult = UA_STATUSCODE_BADNOTHINGTODO;
  796. return;
  797. }
  798. response->results = UA_Array_new(request->nodesToWriteSize,
  799. &UA_TYPES[UA_TYPES_STATUSCODE]);
  800. if(!response->results) {
  801. response->responseHeader.serviceResult = UA_STATUSCODE_BADOUTOFMEMORY;
  802. return;
  803. }
  804. #ifdef UA_ENABLE_EXTERNAL_NAMESPACES
  805. UA_Boolean isExternal[request->nodesToWriteSize];
  806. UA_UInt32 indices[request->nodesToWriteSize];
  807. memset(isExternal, false, sizeof(UA_Boolean)*request->nodesToWriteSize);
  808. for(size_t j = 0; j < server->externalNamespacesSize; j++) {
  809. UA_UInt32 indexSize = 0;
  810. for(size_t i = 0; i < request->nodesToWriteSize; i++) {
  811. if(request->nodesToWrite[i].nodeId.namespaceIndex !=
  812. server->externalNamespaces[j].index)
  813. continue;
  814. isExternal[i] = true;
  815. indices[indexSize] = (UA_UInt32)i;
  816. indexSize++;
  817. }
  818. if(indexSize == 0)
  819. continue;
  820. UA_ExternalNodeStore *ens = &server->externalNamespaces[j].externalNodeStore;
  821. ens->writeNodes(ens->ensHandle, &request->requestHeader, request->nodesToWrite,
  822. indices, indexSize, response->results, response->diagnosticInfos);
  823. }
  824. #endif
  825. response->resultsSize = request->nodesToWriteSize;
  826. for(size_t i = 0;i < request->nodesToWriteSize;i++) {
  827. #ifdef UA_ENABLE_EXTERNAL_NAMESPACES
  828. if(!isExternal[i])
  829. #endif
  830. response->results[i] = Service_Write_single(server, session, &request->nodesToWrite[i]);
  831. }
  832. }
  833. UA_StatusCode UA_Server_write(UA_Server *server, const UA_WriteValue *value) {
  834. UA_RCU_LOCK();
  835. UA_StatusCode retval = Service_Write_single(server, &adminSession, value);
  836. UA_RCU_UNLOCK();
  837. return retval;
  838. }
  839. UA_StatusCode
  840. __UA_Server_write(UA_Server *server, const UA_NodeId *nodeId,
  841. const UA_AttributeId attributeId, const UA_DataType *attr_type,
  842. const void *value) {
  843. UA_WriteValue wvalue;
  844. UA_WriteValue_init(&wvalue);
  845. wvalue.nodeId = *nodeId;
  846. wvalue.attributeId = attributeId;
  847. if(attributeId != UA_ATTRIBUTEID_VALUE)
  848. /* hacked cast. the target WriteValue is used as const anyway */
  849. UA_Variant_setScalar(&wvalue.value.value, (void*)(uintptr_t)value, attr_type);
  850. else {
  851. if(attr_type != &UA_TYPES[UA_TYPES_VARIANT])
  852. return UA_STATUSCODE_BADTYPEMISMATCH;
  853. wvalue.value.value = *(const UA_Variant*)value;
  854. }
  855. wvalue.value.hasValue = true;
  856. UA_StatusCode retval = UA_Server_write(server, &wvalue);
  857. return retval;
  858. }