commit a13daf6fc5421bf781549a9201dab6030bcad281 Author: Nils Freydank Date: Thu Sep 30 11:49:37 2021 +0200 Initial commit diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6792c37 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +*~ +.* +*swp diff --git a/LICENSE-MIT b/LICENSE-MIT new file mode 100644 index 0000000..876249c --- /dev/null +++ b/LICENSE-MIT @@ -0,0 +1,19 @@ +Copyright 2021 Nils Freydank + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/README.txt b/README.txt new file mode 100644 index 0000000..9ccb062 --- /dev/null +++ b/README.txt @@ -0,0 +1,43 @@ +# control-vm.sh +This repository contains a simple bash script to start and stop virtual +machines run by QEMU and KVM and to connect to them via SSH or VNC or SPICE. + +The newest version can be probably found on +https://git.holgersson.xyz/nfr/control-vm. + +Note: While the author already runs this software in "production" on his +private setup he would still conside some parts as beta quality. As usual it's +strongly recommended to create backups first and read through the bash script +to understand roughly what it does. + +# Installation +Please install the following tools which are used by the script: + +- bash +- >=qemu-6.0.0 +- socat +- spice-gtk + +# Usage + +```shell +./control-vm.sh start | shutdown | stop | connect | save | restore | pause | resume" +``` + +Note that you do not see any 'setup' command there a one-shot boot from ISO is +not implemented. + +# Contact +If you have questions, suggestions or want to brag about your other qemu +managing tools feel free to write an email or conact me via IRC: +mail: nils@holgersson.xyz +IRC: holgersson on libera.chat and oftc, mostly in Gentoo related channels + +# Copyright +The bash script and it's documentation (this README) are licensed as MIT, +Copyright 2021 by Nils Freydank. + +The used software has each is own license, but is all FLOSS software. +