From 155c9ce7c441a57046a497c213538efb8d2c5ce0 Mon Sep 17 00:00:00 2001
From: Liu Jiang <gerry@linux.alibaba.com>
Date: Wed, 8 Dec 2021 23:09:13 +0800
Subject: [PATCH] libs/sys-util: add kata-sys-util crate under src/libs

The kata-sys-util crate is a collection of modules that provides helpers
and utilities used by multiple Kata Containers components.

Fixes: #3305

Signed-off-by: Liu Jiang <gerry@linux.alibaba.com>
---
 src/libs/Cargo.lock               |  4 ++++
 src/libs/Cargo.toml               |  1 +
 src/libs/README.md                |  1 +
 src/libs/kata-sys-util/Cargo.toml | 13 +++++++++++++
 src/libs/kata-sys-util/README.md  | 19 +++++++++++++++++++
 src/libs/kata-sys-util/src/lib.rs |  4 ++++
 6 files changed, 42 insertions(+)
 create mode 100644 src/libs/kata-sys-util/Cargo.toml
 create mode 100644 src/libs/kata-sys-util/README.md
 create mode 100644 src/libs/kata-sys-util/src/lib.rs

diff --git a/src/libs/Cargo.lock b/src/libs/Cargo.lock
index d2e0ee0db3a7..7047267ac002 100644
--- a/src/libs/Cargo.lock
+++ b/src/libs/Cargo.lock
@@ -76,6 +76,10 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1aab8fc367588b89dcee83ab0fd66b72b50b72fa1904d7095045ace2b0c81c35"
 
+[[package]]
+name = "kata-sys-util"
+version = "0.1.0"
+
 [[package]]
 name = "kata-types"
 version = "0.1.0"
diff --git a/src/libs/Cargo.toml b/src/libs/Cargo.toml
index 4a4f0ea0ecae..f5370fecf452 100644
--- a/src/libs/Cargo.toml
+++ b/src/libs/Cargo.toml
@@ -2,5 +2,6 @@
 members = [
     "logging",
     "kata-types",
+    "kata-sys-util",
 ]
 resolver = "2"
diff --git a/src/libs/README.md b/src/libs/README.md
index 325e4d011877..1188ed84d6f0 100644
--- a/src/libs/README.md
+++ b/src/libs/README.md
@@ -7,4 +7,5 @@ Currently it provides following library crates:
 | Library | Description |
 |-|-|-|
 | [logging](logging/) | Facilities to setup logging subsystem based slog. |
+| [system utilities](kata-sys-util/) | A collection of facilities and helpers to access system services. |
 | [types](kata-types/) | A collection of constants and data types shared by multiple Kata components. |
diff --git a/src/libs/kata-sys-util/Cargo.toml b/src/libs/kata-sys-util/Cargo.toml
new file mode 100644
index 000000000000..52baa85f5f71
--- /dev/null
+++ b/src/libs/kata-sys-util/Cargo.toml
@@ -0,0 +1,13 @@
+[package]
+name = "kata-sys-util"
+version = "0.1.0"
+description = "System Utilities for Kata Containers"
+keywords = ["kata", "container", "runtime"]
+authors = ["The Kata Containers community <kata-dev@lists.katacontainers.io>"]
+repository = "https://github.com/kata-containers/kata-containers.git"
+homepage = "https://katacontainers.io/"
+readme = "README.md"
+license = "Apache-2.0"
+edition = "2018"
+
+[dependencies]
diff --git a/src/libs/kata-sys-util/README.md b/src/libs/kata-sys-util/README.md
new file mode 100644
index 000000000000..0c3f887bcbea
--- /dev/null
+++ b/src/libs/kata-sys-util/README.md
@@ -0,0 +1,19 @@
+# kata-sys-util
+
+This crate is a collection of utilities and helpers for 
+[Kata Containers](https://github.com/kata-containers/kata-containers/) components to access system services.
+
+It provides safe wrappers over system services, such as:
+- cgroups
+- file systems
+- mount
+- NUMA
+
+## Support
+
+**Operating Systems**:
+- Linux
+
+## License
+
+This code is licensed under [Apache-2.0](../../../LICENSE).
diff --git a/src/libs/kata-sys-util/src/lib.rs b/src/libs/kata-sys-util/src/lib.rs
new file mode 100644
index 000000000000..09d8d185811a
--- /dev/null
+++ b/src/libs/kata-sys-util/src/lib.rs
@@ -0,0 +1,4 @@
+// Copyright (c) 2021 Alibaba Cloud
+//
+// SPDX-License-Identifier: Apache-2.0
+//