aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
-rw-r--r--utils/libservice/README.md63
1 files changed, 63 insertions, 0 deletions
diff --git a/utils/libservice/README.md b/utils/libservice/README.md
new file mode 100644
index 0000000..a652f7b
--- /dev/null
+++ b/utils/libservice/README.md
@@ -0,0 +1,63 @@
+# libservice
+
+Simple service management library and utilities.
+
+## Usage
+
+### libservice.lib
+
+Clients may include the headers by `#include`ing `include/libservice/all.hpp`, which includes all of the other header files.
+
+For service management usage examples, see the utilities descriptions below.
+
+For virtual device usage examples, refer e.g. to [libnt_path_converter](https://github.com/egor-tensin/windows_drivers/tree/master/utils/libnt_path_converter).
+
+### install_service.exe
+
+ Usage: install_service.exe NAME SYS_PATH
+
+Installs a driver as a service.
+The service is started manually.
+The same as
+
+ sc create NAME type= kernel binPath= SYS_PATH
+
+### start_service.exe
+
+ Usage: start_service.exe NAME
+
+Starts a service (loading the corresponding driver).
+The same as
+
+ sc start NAME
+
+except that `start_service.exe` waits until the service is actually loaded.
+
+### stop_service.exe
+
+ Usage: stop_service.exe NAME
+
+Stops the service `NAME` (unloading the corresponding driver).
+The same as
+
+ sc stop NAME
+
+except that `stop_service.exe` waits until the service is actually stopped.
+
+### uninstall_service.exe
+
+ Usage: uninstall_service.exe NAME
+
+Uninstalls the service `NAME`, wiping the corresponding record from the registry.
+The same as
+
+ sc delete NAME
+
+## Building
+
+See [Building](https://github.com/egor-tensin/windows_drivers/tree/master/utils#building).
+
+## Licensing
+
+This project is licensed under the terms of the MIT License.
+See [Licensing](https://github.com/egor-tensin/windows_drivers#licensing) for details.