From 1bc74e43f83bd3b0645239098c33e44656999151 Mon Sep 17 00:00:00 2001 From: Andrew Consroe Date: Tue, 5 Nov 2024 18:04:03 -0600 Subject: [PATCH] docs: remove old --api-socket behavior default --api-socket removed in 78f9ddc6beea6344b3eea0c900665ebdf240935f Signed-off-by: Andrew Consroe --- docs/api.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/docs/api.md b/docs/api.md index 2b57d0dca..94c465c0e 100644 --- a/docs/api.md +++ b/docs/api.md @@ -50,17 +50,12 @@ for more details about the API payloads and responses. #### REST API Location and availability -The REST API is available as soon as the Cloud Hypervisor binary is started, -through a local UNIX socket. -By default, it is located at `/run/user/{user ID}/cloud-hypervisor.{Cloud Hypervisor PID}`. -For example, if you launched Cloud Hypervisor as user ID 1000 and its PID is -123456, the Cloud Hypervisor REST API will be available at `/run/user/1000/cloud-hypervisor.123456`. - -The REST API default URL can be overridden through the Cloud Hypervisor -option `--api-socket`: +The REST API, if enabled, is available as soon as the Cloud Hypervisor binary is started, +through either a local UNIX socket as given in the Cloud Hypervisor option `--api-socket path=...` +or a fd with `--api-socket fd=...`. ``` -$ ./target/debug/cloud-hypervisor --api-socket /tmp/cloud-hypervisor.sock +$ ./target/debug/cloud-hypervisor --api-socket path=/tmp/cloud-hypervisor.sock Cloud Hypervisor Guest API server: /tmp/cloud-hypervisor.sock vCPUs: 1