frameworks_system_utils/kvdb/client.c

926 lines
22 KiB
C

/*
* Copyright (C) 2023 Xiaomi Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/****************************************************************************
* Included Files
****************************************************************************/
#include <ctype.h>
#include <errno.h>
#include <poll.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <netpacket/rpmsg.h>
#include <sys/socket.h>
#include <sys/time.h>
#include <sys/un.h>
#include <kvdb.h>
#include "internal.h"
/****************************************************************************
* Private Functions
****************************************************************************/
static ssize_t recv_safe(int sockfd, char* buf, size_t offset, size_t len)
{
while (offset < len) {
ssize_t ret = recv(sockfd, buf + offset, len - offset, 0);
if (ret < 0) {
if (errno == EAGAIN) {
struct pollfd pfd;
pfd.fd = sockfd;
pfd.events = POLLIN;
ret = poll(&pfd, 1, -1);
if (ret > 0 && (pfd.revents & POLLIN)) {
continue;
} else {
KVERR("poll ret %d error %d\n", ret, errno);
break;
}
}
return -errno;
}
if (ret == 0)
return -ENODATA;
offset += ret;
}
return len;
}
/****************************************************************************
* Name: property_connect_one
*
* Description:
* Initialize client socket and connect to server
*
* Input Parameters:
* addr - server address
* addrlen - server address length
*
* Returned Value:
* On success return client socket fd.
* On error return error value (<0).
*
****************************************************************************/
#if defined(CONFIG_NET_LOCAL) || defined(CONFIG_NET_RPMSG)
static int property_connect_one(const struct sockaddr* addr,
socklen_t addrlen)
{
int fd = socket(addr->sa_family, SOCK_STREAM | SOCK_CLOEXEC, 0);
if (fd < 0)
return -errno;
int ret = connect(fd, addr, addrlen);
if (ret < 0) {
ret = -errno;
close(fd);
return ret;
}
return fd;
}
#endif
#if defined(CONFIG_NET_LOCAL) && defined(CONFIG_NET_RPMSG)
/****************************************************************************
* Name: use_local_socket
*
* Description:
* Determine whether to use local socket or rpmsg socket to
* connect to server
*
* Returned Value:
* true: use local socket
* false: use rpmsg socket
*
****************************************************************************/
static inline bool use_local_socket(void)
{
#ifdef CONFIG_KVDB_SERVER_CPUNAME
struct sockaddr_rpmsg addr;
socklen_t addrlen = sizeof(addr);
int fd = socket(AF_RPMSG, SOCK_STREAM | SOCK_CLOEXEC, 0);
if (fd >= 0) {
int ret = getsockname(fd, (struct sockaddr*)&addr, &addrlen);
close(fd);
if (ret == 0) {
return strcmp(addr.rp_cpu, CONFIG_KVDB_SERVER_CPUNAME) == 0;
}
}
#endif
return true;
}
#endif
/****************************************************************************
* Name: property_connect
*
* Description:
* Initialize client socket and connect to server
*
* Returned Value:
* On success return client socket fd.
* On error return error value (<0).
*
****************************************************************************/
static int property_connect(void)
{
#ifdef CONFIG_NET_LOCAL
const struct sockaddr_un laddr = {
.sun_family = AF_UNIX,
.sun_path = PROP_SERVER_PATH,
};
#endif
#ifdef CONFIG_NET_RPMSG
const struct sockaddr_rpmsg raddr = {
.rp_family = AF_RPMSG,
.rp_name = PROP_SERVER_PATH,
.rp_cpu = CONFIG_KVDB_SERVER_CPUNAME,
};
#endif
int ret = -ENOTSUP;
#if defined(CONFIG_NET_LOCAL) && defined(CONFIG_NET_RPMSG)
bool use_local = use_local_socket();
#endif
while (1) {
#if defined(CONFIG_NET_LOCAL) && defined(CONFIG_NET_RPMSG)
if (use_local)
ret = property_connect_one((const struct sockaddr*)&laddr, sizeof(laddr));
else
ret = property_connect_one((const struct sockaddr*)&raddr, sizeof(raddr));
#elif defined(CONFIG_NET_LOCAL)
ret = property_connect_one((const struct sockaddr*)&laddr, sizeof(laddr));
#elif defined(CONFIG_NET_RPMSG)
ret = property_connect_one((const struct sockaddr*)&raddr, sizeof(raddr));
#else
break;
#endif
if (ret >= 0)
break;
usleep(1000);
}
return ret;
}
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: property_set_binary
*
* Description:
* Store Key-Values to database.
*
* Input Parameters:
* const char* key: entry key string
* const void* value: entry value string
* size_t val_len: the length of the value
*
* Returned Value:
* 0: success
* <0: failure during execution
*
****************************************************************************/
int property_set_binary(const char* key, const void* value, size_t val_len, bool oneway)
{
int fd;
if (!key)
return -EINVAL;
size_t key_len = strlen(key) + 1;
if (key_len > PROP_NAME_MAX)
return -E2BIG;
if (val_len == 0 || val_len >= PROP_VALUE_MAX)
return -E2BIG;
again:
fd = property_connect();
if (fd < 0) {
KVERR("connect failed, fd=%d\n", fd);
return fd;
}
/*-------------------------------------*
| 1 | 1 | 1 | key_len |val_len|
|-------------------------------------|
|'S'|key_len|val_len|[key'\0']|[value]|
*-------------------------------------*/
char cmd[3] = {
'S', key_len, val_len
};
struct iovec iov[3] = {
{ .iov_base = cmd, .iov_len = 3 },
{ .iov_base = (char*)key, .iov_len = key_len },
{ .iov_base = (char*)value, .iov_len = val_len },
};
struct msghdr msg = { 0 };
msg.msg_iov = iov;
msg.msg_iovlen = 3;
int ret = sendmsg(fd, &msg, 0);
if (ret < 0) {
/* handle server refused by backlog limitation */
if (oneway && errno == ECONNRESET) {
close(fd);
goto again;
}
ret = -errno;
KVERR("sendmsg failed, ret=%d\n", ret);
goto out;
}
if (!oneway) {
/*-----*
| 4 |
|-----|
|error|
*-----*/
int32_t err;
ret = recv(fd, &err, 4, 0);
if (ret < 4) {
KVERR("recv failed, ret=%d\n", ret);
ret = ret < 0 ? -errno : -EINVAL;
goto out;
}
ret = err;
}
out:
close(fd);
return ret;
}
/****************************************************************************
* Name: property_get_binary
*
* Description:
* Retrieve Key-Values from database.
*
* Input Parameters:
* const char* key: entry key string
* void* value: not NULL : pointer to string buffer
* NULL : check whether this [key, value] exists
* size_t val_len: the length of the value
*
* Returned Value:
* On success returns the length of the value which will never be greater
* than PROP_NAME_MAX.
*
****************************************************************************/
ssize_t property_get_binary(const char* key, void* value, size_t val_len)
{
if (!key)
return -EINVAL;
size_t key_len = strlen(key) + 1;
if (key_len > PROP_NAME_MAX)
return -EINVAL;
int fd = property_connect();
if (fd < 0) {
KVERR("connect failed, fd=%d\n", fd);
return fd;
}
/*-----------------------------*
| 1 | 1 | key_len |val_len|
| --------------------|-------|
|'G'|key_len|[key'\0']|[value]|
*-----------------------------*/
char cmd[3] = {
'G', key_len, val_len
};
struct iovec iov[2] = {
{ .iov_base = cmd, .iov_len = 3 },
{ .iov_base = (char*)key, .iov_len = key_len },
};
struct msghdr msg = { 0 };
msg.msg_iov = iov;
msg.msg_iovlen = 2;
ssize_t len = -1;
int ret = sendmsg(fd, &msg, 0);
if (ret < 0) {
KVERR("sendmsg failed, errno=%d\n", errno);
goto out;
}
/*-------*
|val_len|
|-------|
|[value]|
*-------*/
if (value) {
/* value is not NULL, receive all the value */
len = recv(fd, value, val_len, 0);
if (len <= 0) {
if (len != 0) {
KVERR("recv failed, len=%d\n", len);
}
goto out;
}
} else {
/* value is NULL, receive two chars to check whether this
* [key, value] exists
*/
char tmpvalue[1];
len = recv(fd, tmpvalue, 1, 0);
if (len <= 0) {
if (len != 0) {
KVERR("recv failed, len=%d\n", len);
}
}
}
out:
close(fd);
return len < 0 ? -errno : len;
}
/****************************************************************************
* Name: property_delete
*
* Description:
* Delete a KV pair by key
*
* Input Parameters:
* const char* key: entry key string
*
* Returned Value:
* 0: success
* <0: failure during execution
*
****************************************************************************/
int property_delete(const char* key)
{
if (!key)
return -EINVAL;
size_t key_len = strlen(key) + 1;
if (key_len > PROP_NAME_MAX)
return -E2BIG;
/* in environment variable? */
if (getenv(key)) {
int ret = unsetenv(key);
if (ret < 0)
ret = -errno;
return ret;
}
int fd = property_connect();
if (fd < 0) {
KVERR("connect failed, fd=%d\n", fd);
return fd;
}
/*---------------------*
| 1 | 1 | key_len |
| --------------------|
|'D'|key_len|[key'\0']|
*---------------------*/
char cmd[2] = {
'D', key_len
};
struct iovec iov[2] = {
{ .iov_base = cmd, .iov_len = 2 },
{ .iov_base = (char*)key, .iov_len = key_len },
};
struct msghdr msg = { 0 };
msg.msg_iov = iov;
msg.msg_iovlen = 2;
int ret = sendmsg(fd, &msg, 0);
if (ret < 0) {
ret = -errno;
KVERR("sendmsg failed, ret=%d\n", ret);
goto out;
}
/*-----*
| 4 |
|-----|
|error|
*-----*/
int32_t err;
ret = recv(fd, &err, 4, 0);
if (ret < 4) {
KVERR("recv failed, ret=%d\n", ret);
ret = ret < 0 ? -errno : -EINVAL;
goto out;
}
ret = err;
out:
close(fd);
return ret;
}
/****************************************************************************
* Name: property_list_binary
*
* Description:
* List all KVs in every database and calls callback function.
*
* Input Parameters:
* property_callback propfn: callback function
* void* cookie: cookie data to pass to callback function
*
* Returned Value:
* Returns 0 on success, <0 if all databases failed to open.
*
****************************************************************************/
int property_list_binary(void (*propfn)(const char* key, const void* value, size_t val_len, void* cookie), void* cookie)
{
char* msg = NULL;
int fd = property_connect();
if (fd < 0) {
KVERR("connect failed, fd=%d\n", fd);
return fd;
}
/*---*
| 1 |
| --|
|'L'|
*---*/
int ret = send(fd, "L", 1, 0);
if (ret < 0) {
ret = -errno;
KVERR("send failed, ret=%d\n", ret);
goto out;
}
msg = malloc(PROP_MSG_MAX);
if (msg == NULL) {
KVERR("malloc failed\n");
ret = -ENOMEM;
goto out;
}
while (1) {
/*---------------------------------*
| 1 | 1 | key_len |val_len|
|---------------------------------|
|key_len|val_len|[key'\0']|[value]|
*---------------------------------*/
ret = recv_safe(fd, msg, 0, 2);
if (ret < 0) {
ret = -errno;
KVERR("recv_safe failed, ret=%d\n", ret);
goto out;
}
if (msg[0] == 0 && msg[1] == 0) {
/* end of list */
ret = 0;
break;
}
size_t key_len = (unsigned char)msg[0];
if (key_len > PROP_NAME_MAX)
continue;
size_t val_len = (unsigned char)msg[1];
if (val_len >= PROP_VALUE_MAX)
continue;
size_t total = key_len + val_len + 2;
ret = recv_safe(fd, msg, 2, total);
if (ret < 0) {
KVERR("recv_safe failed, ret=%d\n", ret);
break;
}
const char* key = msg + 2;
void* value = msg + 2 + key_len;
if (key[key_len - 1])
continue;
propfn(key, value, val_len, cookie);
}
out:
free(msg);
close(fd);
return ret;
}
/****************************************************************************
* Name: property_wait
*
* Description:
* Wait the monitored key until its value updated or key deleted.
*
* Input Parameters:
* const char* key : the monitored key string, support fnmatch pattern
* char* newkey : pointer to a string buffer to receive the key of
* the updated/deleted value
* void* newvalue: pointer to a string buffer to receive the updated
* value or deleted value
* size_t val_len : the length of the newvalue
* int timeout : the wait timeout time (in milliseconds)
*
* Returned Value:
* On success returns the length of the value.
*
****************************************************************************/
ssize_t property_wait(const char* key, char* newkey, void* newvalue, size_t val_len, int timeout)
{
if (key == NULL)
return -EINVAL;
int fd = property_monitor_open(key);
if (fd < 0)
return fd;
struct pollfd fds = {
.fd = fd,
.events = POLLIN
};
int ret = poll(&fds, 1, timeout);
if (ret < 0) {
ret = -errno;
KVERR("poll failed, ret=%d\n", ret);
goto out;
} else if (ret == 0 || (fds.revents & POLLIN) == 0) {
ret = -ETIMEDOUT;
goto out;
}
ret = property_monitor_read(fd, newkey, newvalue, val_len);
out:
property_monitor_close(fd);
return ret;
}
/****************************************************************************
* Name: property_monitor_open
*
* Description:
* Open a key monitor channel
*
* Input Parameters:
* const char* key : the monitored key string, support fnmatch pattern
*
* Returned Value:
* On success returns a file descriptor, -errno otherwise.
*
****************************************************************************/
int property_monitor_open(const char* key)
{
if (key == NULL)
return -EINVAL;
size_t key_len = strlen(key) + 1;
if (key_len > PROP_NAME_MAX)
return -E2BIG;
int fd = property_connect();
if (fd < 0) {
KVERR("connect failed, fd=%d\n", fd);
return fd;
}
/*------------------------*
| 1 | 1 | key_len |
|-------|-----------------|
| 'M' |key_len|[key'\0']|
*-------------------------*/
char cmd[2] = { 'M', key_len };
struct iovec iov[2] = {
{ .iov_base = cmd, .iov_len = 2 },
{ .iov_base = (char*)key, .iov_len = key_len },
};
struct msghdr msg = { 0 };
msg.msg_iov = iov;
msg.msg_iovlen = 2;
int ret = sendmsg(fd, &msg, 0);
if (ret < 0) {
KVERR("sendmsg failed, ret=%d\n", ret);
ret = -errno;
goto out;
}
/*-----*
| 4 |
|-----|
|error|
*-----*/
int32_t err;
ret = recv(fd, &err, 4, 0);
if (ret < 4) {
KVERR("recv failed, ret=%d\n", ret);
ret = ret < 0 ? -errno : -EINVAL;
goto out;
}
if (err < 0) {
ret = err;
goto out;
}
return fd;
out:
close(fd);
return ret;
}
/****************************************************************************
* Name: property_monitor_read
*
* Description:
* Wait the monitored key until its value updated or key deleted.
*
* Input Parameters:
* int fd : file descriptor returned by property_monitor_open()
* char* newkey : pointer to a strint buffer to receive the key of the
* updated/deleted value
* void* newvalue: pointer to a string buffer to receive the updated
* value or deleted value
* size_t val_len: newvalue length
*
* Returned Value:
* On success returns the length of the value.
*
****************************************************************************/
ssize_t property_monitor_read(int fd, char* newkey, void* newvalue, size_t val_len)
{
char* msg = malloc(PROP_MSG_MAX);
if (msg == NULL) {
KVERR("malloc failed\n");
return -ENOMEM;
}
ssize_t ret = recv(fd, msg, 2, 0);
if (ret < 2) {
KVERR("recv failed, ret=%d, errno=%d\n", ret, errno);
free(msg);
return ret < 0 ? -errno : -ENODATA;
}
size_t key_len = (unsigned char)msg[0];
if (key_len > PROP_NAME_MAX) {
free(msg);
return -E2BIG;
}
size_t len = (unsigned char)msg[1];
if (len > PROP_VALUE_MAX) {
free(msg);
return -E2BIG;
}
size_t total = key_len + len + 2;
ret = recv_safe(fd, msg, ret, total);
if (ret < 0) {
KVERR("recv_safe failed, ret=%d\n", ret);
free(msg);
return ret;
}
const char* key = &msg[2];
if (newkey != NULL)
strlcpy(newkey, key, PROP_NAME_MAX);
if (newvalue != NULL) {
/*--------------------------------*
| 1 | 1 | key_len |val_len|
|---------------------------------|
|key_len|val_len|[key'\0']|[value]|
*---------------------------------*/
const void* value = &msg[2 + key_len];
len = val_len > len ? len : val_len;
memcpy(newvalue, value, len);
}
free(msg);
return len;
}
/****************************************************************************
* Name: property_monitor_close
*
* Description:
* Close a key monitor channel
*
* Input Parameters:
* int fd : file descriptor returned by property_monitor_open()
*
* Returned Value:
* On success returns 0, -errno otherwise.
*
****************************************************************************/
int property_monitor_close(int fd)
{
int ret = close(fd);
if (ret < 0)
ret = -errno;
return ret;
}
/****************************************************************************
* Name: property_commit
*
* Description:
* Actively commit all property changes
*
* Input Parameters:
* None
*
* Returned Value:
* On success returns 0.
* On failure returns -errno.
*
****************************************************************************/
int property_commit(void)
{
int fd = property_connect();
int ret;
int value;
if (fd < 0)
return fd;
ret = send(fd, "C", 1, 0);
if (ret < 0) {
KVERR("send error %d\n", errno);
ret = -errno;
goto out;
}
ret = recv(fd, &value, sizeof(value), 0);
if (ret < sizeof(value)) {
KVERR("recv error %d, ret %d\n", errno, ret);
ret = -errno;
goto out;
}
ret = value;
if (ret < 0) {
KVERR("commit error %d\n", ret);
}
out:
close(fd);
return ret;
}
/****************************************************************************
* Name: property_load
*
* Description:
* load default property value
*
* Input Parameters:
* const char* path: file path
*
* Returned Value:
* On success returns 0.
* On failure returns -errno.
*
****************************************************************************/
int property_load(const char* path)
{
size_t file_len;
int ret;
int fd;
if (path == NULL)
path = "";
file_len = strlen(path) + 1;
fd = property_connect();
if (fd < 0)
return fd;
char cmd[2] = {
'R', file_len
};
struct iovec iov[2] = {
{ .iov_base = cmd, .iov_len = 2 },
{ .iov_base = (char*)path, .iov_len = file_len },
};
struct msghdr msg = { 0 };
msg.msg_iov = iov;
msg.msg_iovlen = 2;
ret = sendmsg(fd, &msg, 0) > 0 ? 0 : -errno;
close(fd);
return ret;
}
/****************************************************************************
* Name: property_exit
*
* Description:
* Exit Kvdb Server
*
* Input Parameters:
* None
*
* Returned Value:
* On success returns 0.
* On failure returns -errno.
*
****************************************************************************/
int property_exit(void)
{
int fd = property_connect();
int ret;
int value;
if (fd < 0)
return fd;
ret = send(fd, "E", 1, 0);
if (ret < 0) {
KVERR("send error %d\n", errno);
ret = -errno;
goto out;
}
ret = recv(fd, &value, sizeof(value), 0);
if (ret < sizeof(value)) {
KVERR("recv error %d, ret %d\n", errno, ret);
ret = -errno;
}
out:
close(fd);
return ret;
}