Node Command - GLOBAL_DB READ

Reads information about specified GDB group using key.  

CLI Example

Command syntax:

global_db read 
-group <group_name> 
-key <key_name>

Options:

-group - name of the group (list of names can be acquired using GROUP_LIST command)
-key - key for access the group (list of keys can be acquired using GET_KEYS command)

Command:

cellframe-node-cli global_db read 
-group foobar.nodes.list 
-key 17CD::9A15::709D::FEDD

Response:

        group: foobar.nodes.list
 
        key: 17CD::9A15::709D::FEDD
        time: Thu, 26 Sep 2024 04:11:03 +0000
        value len: 95
 
        value hex:   +0000:  dd fe 9d 70 15 9a cd 17 00 00 00 00 00 00 00 00   ...p............  
 
  +0010:  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  
 
  +0020:  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  
 
  +0030:  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  
 
  +0040:  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  
 
  +0050:  50 00 0b 31 37 32 2e 32 38 2e 30 2e 33 30 00      P..172.28.0.30.

JSON-RPC Example

JSON-RPC Request - GLOBAL_DB READ

Reads information about specified GDB group using key.

Request Structure

JSON object:

{
  "method": "global_db",
  "subcommand": ["read"],
  "arguments": {
    "group": "group_name",
    "key": "key_name"
  },
  "id": "1"
}

Parameters:

group - name of the group (list of names can be acquired using JSON-RPC Request - GLOBAL_DB GROUP_LIST) key - key for access the group (list of keys can be acquired using JSON-RPC Request - GLOBAL_DB GET_KEYS)

Curl Example

Request:

curl --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{
  "method": "global_db",
  "subcommand": ["read"],
  "arguments": {
    "group": "local.general",
    "key": "gdb_version"
  },
  "id": "1"
}'

Response:

{
  "type": 2,
  "result": [
    {
      "group": "local.general",
      "key": "gdb_version",
      "time": "Mon, 21 Apr 2025 16:41:22 +0700",
      "value len": 17,
      "value hex": "\n  +0000:  73 74 72 69 6E 67 20 69 6E 20 71 75 6F 74 65 73   string in quotes   \n  +0010:  00                                                .                  \n"
    }
  ],
  "id": 1
}

Link to original